Contribution Guidelines

January 4, 2019 ยท View on GitHub

Thank you for considering to contribute to this project. These guidelines will help you get going with development and outline the most important rules to follow when submitting pull requests for this project.


Development

Setup

Prerequisites
Steps
  1. Clone the (forked) repository
  2. Create a virtualenv with virtualenv env
  3. Activate virtualenv source env/bin/activate or env/Scripts/activate on Windows
  4. Run pip install -r requirements.txt in the project directory

Running Tests

pytest

Submitting Changes

To get changes merged, create a pull request. Here are a few things to pay attention to when doing so:

Commit Messages

The summary of a commit should be concise and worded in an imperative mood.
...a what mood? This should clear things up: How to Write a Git Commit Message

Code Style

Make sure your code follows PEP-8 and keeps things consistent with the rest of the code.

Tests

If it makes sense, writing tests for your PRs is always appreciated and will help get them merged.