Making Contributions

Contribution Process

Ready to contribute? Here's how to setup Sibyl-API for local development, and make contributions

• Clone the sibyl-api repo onto your local machine and cd into the new directory:

git clone https://github.com/sibyl-dev/sibyl-api.git
cd sibyl-api
git checkout dev

• Install the project dependencies using Poetry.

poetry install

• Create a branch for local development. You should always be branching off of the dev branch when contributing. Give your branch a descriptive name that describes what change you will be making. Each branch should aim to resolve at most one issue.

git checkout -b name-of-your-bugfix-or-feature

• Now you can make your changes locally. While making your changes, make sure to cover all your additions with the required unit tests, and that none of the old tests fail as a consequence of your changes. For this, make sure to run the tests suite and check the code coverage:

poetry run invoke lint       # Check code styling
poetry run invoke test       # Run the tests

# Other helpful commands:
poetry run invoke fix-lint   # Run the auto-fomatter (fixes most linting errors)

• Before making your PR, update the API docs by running Sibyl with the -G flag, ie.:

poetry run sibyl run -G

• Make also sure to include the necessary documentation in the code as docstrings following the Google docstrings style guide.

• After running all test and docs commands listed above and confirming they work correctly, commit your changes and push your branch to GitHub:

git add .
git commit -m "Your detailed description of your changes."
git push origin name-of-your-bugfix-or-feature

• Submit a pull request through the GitHub website, merging back into dev.

• Once you have a minimum of two approvals, you can merge your branch in. Branches should be deleted on merge.