Want to help out with behave-django? Cool! Here’s a quick guide to do just that.

Fork, then clone the repo:

$ git clone

Install the dev dependencies

$ pip install -r requirements-dev.txt

Make sure the tests pass. The @failing tag is used for tests that are supposed to fail. The @requires-live-http tag is used for tests that can’t run with --simple flag.

$ python behave --tags=~@failing  # skip failing tests
$ python behave --simple --tags=~@failing --tags=~@requires-live-http
$ py.test

Start your topic branch

$ git checkout -b your-topic-branch

Make your changes. Add tests for your change. Make the tests pass:

$ python behave --tags=~@failing
$ py.test

Finally, make sure your tests pass on all the configurations behave-django supports. We use tox for this. The Python versions you test against need to be available in your PATH.

$ tox

You can choose not to run all tox tests and let the CI server take care about that. In this case make sure your tests pass when you push your changes and open the PR.

Your tests don’t have to be behave tests. :-)

Push to your fork and submit a pull request.

Other things to note:

  • Write tests.
  • We’re using PEP8 as our code style guide (flake8 will run over the code on the CI server).

Thank you!