Workflow
Setup
To set up a developer environment
Fork the repository and clone the fork.
Create a virtual environment using your tool of choice (e.g. virtualenv, conda, etc).
conda create -n compas-dev python=3.8 cython --yes conda activate compas-dev
Install development dependencies:
cd path/to/compas pip install -r requirements-dev.txt
Make sure all tests pass and the code is free of lint:
invoke lint invoke test
Create a branch for your contributions.
git branch title-proposed-changes git checkout title-proposed-changes
Start making changes!
Submitting a PR
Once you are done making changes, you have to submit your contribution through a pull request (PR). The procedure for submitting a PR is the following.
Make sure all tests still pass, the code is free of lint, and the docstrings compile correctly:
invoke lint invoke test invoke docs
Add yourself to
AUTHORS.md
.Summarize the changes you made in
CHANGELOG.md
.Commit your changes and push your branch to GitHub.
Create a pull request.