How to Contribute¶
Setting up your development environment¶
You should install the virtualenv tool for python. (I use a wrapper for it called virtualenvwrapper which is awesome but not required.) Virtualenv will help isolate your dependencies from the rest of your system.
$ sudo yum install python-virtualenv git
$ mkdir -p ~/virtualenvs/
$ virtualenv ~/virtualenvs/bugwarrior
You should now have a virtualenv in a ~/virtualenvs/
directory.
To use it, you need to “activate” it like this:
$ source ~/virtualenv/bugwarrior/bin/activate
(bugwarrior)$ which python
At any time, you can deactivate it by typing deactivate
at the command
prompt.
Next step – get the code!
(bugwarrior)$ git clone git@github.com:ralphbean/bugwarrior.git
(bugwarrior)$ cd bugwarrior
(bugwarrior)$ python setup.py develop
(bugwarrior)$ which bugwarrior-pull
This will actually run it.. be careful and back up your task directory!
(bugwarrior)$ bugwarrior-pull
If you’re developing, it can be helpful to run the test suite:
(bugwarrior)$ pip install nose
(bugwarrior)$ nosetests