Would you like to contribute to Spokestack Python? We would love to have your contributions!

We gladly welcome pull requests.

Before making any changes, we recommend opening an issue (if it doesn’t already exist) and discussing your proposed changes. This will let us give you advice on the proposed changes. If the changes are minor, then feel free to make them without discussion.

Contributing is as simple as making a fork of the repo and adding commits. We distribute the repo with a .pre-commit-config.yml file that contains the necessary pre-commit hooks for formatting and tests. This file configures the pre-commit framework which is installed with the other Python dependencies in requirements.txt. Success on these pre-commit checks will ensure that your branch will build with CircleCI and meets our formatting requirements.

We use flake8 and black for formatting. Your code will be automatically formatted to our specification by the pre-commit hook. This ensures deterministic uniformity across every addition.

For testing we use pytest.

The following command will show test coverage via pytest:

pytest --cov=spokestack