Hacking on steve¶
It’s likely steve will never “be done”. Thus, it’s likely it will be in a perpetual need for people to tweak steve to do the things they need it to do. These people are you!
This chapter covers contributing to steve.
We use Github to host the code. After you’ve forked the project, make changes like this:
- create a branch based on master to hold your changes
- make your changes in that branch and commit them
- create a pull request between pyvideo/master and your branch with all the details you think I’ll need to know to understand what you did, why, and what problem you were trying to solve
This is somewhat high level and sort of assumes you know git, Github, and contributing to projects like this one. If you need more help because these assumptions don’t match you, please ask me on IRC.
PEP-8 and pyflakes is your friend.
steve documentation is in two places:
- in the code in docstrings
- in the
docs/directory in reStructuredText files as a Sphinx docs project
Everything is in reStructuredText.
- Good docs are good.
- Bad docs are lousy.
- Lack of docs are suboptimal.
Running and writing tests¶
steve comes with unit tests. Unit tests are executed using nose. If you don’t already have nose installed, then install it with:
pip install nose
I like to use nose-progressive, too, because it’s awesome. To install that:
pip install nose-progressive
To run the unit tests from a git clone or the source tarball, do this from the project directory:
With nose-progressive and fail-fast:
nosetests -x --with-progressive