This is a collection of re-usable tasks for Fabric.
These tasks have all been built to be used with the 1.0a version of the Fabric fork maintained by Travis Swicegood. It might be usable with other versions of Fabric, but your mileage may vary.
Each of these packages are installable by themselves, or they can be built as one über-package. See individual packages for instructions on installing them individually.
To install d51.fabric, you must have Fabric installed. You can do this via
pip:
prompt> pip install -e git://github.com/tswicegood/fabric.git#egg=fabric
You can also install it by creating a clone of the repository and installing
via the provided setup.py:
prompt> git clone git://github.com/tswicegood/fabric.git ... git clone output ... prompt> python setup.py install
Depending on the configuration of your system, you may have to prefix the pip
or python commands above with sudo.
Important Note: This installs Travis Swicegood's fork of Fabric. This is
necessary if you wish to utilize the tasks in d51.fabric, as they utilize
features that have yet to be merged back into the main line of development.
d51.fabric is a package that contains the code necessary to assemble all of
its separate pieces into one, installable package. Once Fabric is installed,
create a clone of the d51.fabric repository, then run the install
command:
prompt> git clone git://github.com/domain51/d51.fabric.git prompt> cd d51.fabric prompt> fab install
You can also work directly with the setup.py file, however, you must run
fab src to assemble all of the various repositories and place their files
in the correct location.
You can build this documentation from within the repository by using the docs
task from Fabric:
prompt> fab docs
This places the HTML documentation into the docs/_build/html.
If you prefer, you can run the command individually to build the documentation:
prompt> fab src prompt> cd docs prompt> make html