Contributing

How to Contribute

There are a lot of different ways to contribute to a project

Filing issues:

If you would like to file an issue this project uses Github issues for both feature requests and bugs.

Making code changes:

If you want to make changes to the code start with:

git clone dataclass_structor
pipenv install --dev

After you make some changes create a Github pull request. After opening up the pull request CI (continuous integration) will run some tests. In order for your PR to be accepted it will need pass the tests, have the correct types, as well as be formatted “correctly”.

To run the tests:

make test

To check that the types are correct:

make typecheck  # This will run mypy

To format the code run:

make format  # This will run black

To format the code run:

Running performance tests:

This package has some performance tests that measure the performance of the structure and unstructure functions. The intention is that these tests can be used to see how proposed changes affect the speed execution.

To run the performance tests::

make perf-tests

To see the results of the performance tests::

pipenv run python -m perf show bench.json

For more perf functions see this doc: https://perf.readthedocs.io/en/latest/cli.html

Updating documentation:

If you would like to update documentation:

git clone dataclass_structor
pipenv install --dev
make build-docs

Code of Conduct

This project follows and will enforce, the Contributor Covenant: https://github.com/hockeybuggy/dataclass_structor/CODE_OF_CONDUCT.md