CONTRIBUTING.md

How to contribute to pylambdarest

Thank you for considering contributing to pylambdarest!

First time setup

• Make sure you have a GitHub account.

• Fork pylambdarest to your GitHub account by clicking the Fork button.

• Install poetry.

• Install dependecies using poetry:

poetry install

• Install the pre-commit hooks:

poetry run pre-commit install --install-hooks

• Run the tests to make sure you are all set:

poetry run coverage run -m --source=pylambdarest pytest tests && poetry run coverage report -m

Building the docs

Build the docs in the docs directory using Sphinx:

cd docs
poetry run make html

Open build/html/index.html in your browser to view the docs.

Read more about Sphinx.

Submitting patches

Include the following in your patch:

• Use Black to format your code. This and other tools will run automatically if you install pre-commit using the instructions above.
• Include tests if your patch adds or changes code. Make sure the test fails without your patch.
• Update the documentation accordingly if needed.