Contribution

If you like to contribute to this project please read the following guides.

Django Code

You have to install some dependencies for development and testing.

$ pip install -e .[tests]

Testing the code

django-anylink uses py.test for testing. Please ensure that all tests pass before you submit a pull request. py.test also runs PEP8 and PyFlakes checks on every run.

We created a Makefile to make some commands more easy to run.

This is how you execute the tests and checks from the repository root directory.

$ py.test

Or with the shortcut in the Makefile.

$ make tests

If you want to generate a coverage report, you can use the following command.

$ make coverage

If you want a coverage report with html output.

$ make coverage-html

Documentation

django-anylink uses Sphinx for documentation. You find all the sources files in the docs/source folder.

To update/generate the html output of the documentation, use the following command inside the docs folder.

$ make html

Please make sure that you don’t commit the build files inside docs/build.

JavaScript Code

TBD