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 the tox tests, but make sure your tests pass in the CI server when you push your 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 with run over the code on the CI server).

Thank you!