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 pip2 (recommended way):
pip2 install fabsetup
# install addon, eg. fabsetup-theno-termdown
pip2 install fabsetup-theno-termdown
Raspberry Pi
On a fresh raspbian (Debian) you will need at least the following packages before installing fabsetup with pip:
sudo apt install -y git python python-pip libffi-dev libssl-dev tree curl && sudo pip install fabsetup
The whole installation will take about 15 minutes on a Raspi 3 with raspbian stretch, so you can make yourself a tea. Note: You do not need to type pip2 as pip defaults to the python2-variant of pip. If you run $ pip install fabsetup as normal usr (without sudo) pip will install with --user setting by default so fabsetup is located under ~/.local/bin. In this case you need to add ~/.local/bin to $PATH which is located in /etc/profile.
Update:
pip2 install --upgrade fabsetup
# update addon (also updates fabsetup)
pip2 install --upgrade fabsetup-theno-termdown
Install without superuser privileges:
pip2 install --user fabsetup
When running with --user pip installs the command fabsetup at ~/.local/bin. Assure that ~/.local/bin is set in your $PATH environment variable.
Uninstall:
pip2 uninstall --yes fabsetup
pip2 uninstall --yes fabsetup-addon-theno
You also can clone the github repository instead of using pip2 install:
# install requirements
sudo apt-get install git fabric
pip2 install --user utlz
git clone https://github.com/theno/fabsetup.git ~/.fabsetup
# from ~/.fabsetup dir use `fab` instead of `fabsetup`
cd ~/.fabsetup
fab -l
Development
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 clean
Project details
Release 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.