fabric setup scripts and fabric utils library
Project description
Fabric tasks in order to set up and maintain configurations, software installations and other things on a local or remote linux system (most functionality for Debian/Ubuntu).
“dotfiles on steroids”
Usage
fabsetup is a `fabric <http://www.fabfile.org/>`__ script.
# task infos
## list all tasks: '-l'
fabsetup -l
## show details: '-d'
fabsetup -d new_addon
# run tasks
fabsetup setup.regex_repl
## on your local host:
fabsetup setup.pencil3 -H localhost
## remote host:
fabsetup up -H example.com`Setup-Howtos <./howtos>`__:
Customize fabsetup: Initialize git repository ``fabsetup_custom` <./howtos/fabsetup-custom.md>`__
Host an own F-Droid Repository (Android App Repository)
Host a Selfoss Service (RSS Reader Web Application)
`How to create and write a fabsetup-addon <./howtos/fabsetup-addon.md>`__
Known fabsetup-addons
Please contribute: Create your own fabsetup-addon and make a pull request which adds your fabsetup-addon to the known_pip_addons in fabsetup/addons.py and to this README.md.
Installation
As a pypi package with command pip (recommended way):
pip install fabsetup
# install addon, eg. fabsetup-theno-termdown
pip install fabsetup-theno-termdownUpdate:
pip install --upgrade fabsetup
# update addon (also updates fabsetup)
pip install --upgrade fabsetup-theno-termdownInstall without superuser privileges:
pip install --user fabsetupWhen running with --user, pip installs the command fabsetup at ~/.local/bin. Assure that ~/.local/bin is set in your $PATH environment variable.
Uninstall:
pip uninstall --yes fabsetup
pip uninstall --yes fabsetup-addon-thenoYou also can clone the github repository instead of using pip install:
# install requirements
sudo apt-get install git fabric
pip install --user utlz
git clone https://github.com/theno/fabsetup.git ~/.fabsetup
# from ~/.fabsetup dir use `fab` instead of `fabsetup`
cd ~/.fabsetup
fab -lDevelopment
Devel commands:
# save changes
git commit -am 'I describe my changes'
# upload to github
git push origin master
# update version number in fabsetup/_version.py
# create and publish package at pypi
fab -f fabfile-dev.py pypi
# clean up
fab -f fabfile-dev.py cleanRelease history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
