Skip to content

Latest commit

 

History

History
100 lines (60 loc) · 2.46 KB

CONTRIBUTING.md

File metadata and controls

100 lines (60 loc) · 2.46 KB

Contributing

Issues

You can find our open issues in the project's issue tracker. Please let us know if you find any issues or have any feature requests there.

CI-CD

Development environment

You can initialize the development environment of write-pypistat with python virtual env.

Run the dev make target to set up your environment.

make dev

Note: The dev make target is going to set up pre-commit and pre-push hooks into your local git repository. Pre-commit hook is going to format the code with black and pre-push hook is going to run the CI steps.

Run the clean make target to clear your environment.

make clean

CI

The CI steps check code formatting, run code analyses and check typing.

The check make target collects the above tasks. Run the check make target to run the CI steps.

make check

Formatting

The write-pypistat project is formatted with black.

Run the format make target to format your code.

make format

Run the check-format target to check code formatting.

make check-format

Code analyses

The write-pypistat project is analysed with pylint.

Run the lint make target to run code analyses.

make lint

Typing

The write-pypistat project is using type hints.

Run the check-typing make target to run check code typing.

make check-typing

Documentation

Run the doc make target to build the documentation.

make doc

The documentation will be published to the gh-pages branch with the doc workflow. Online version can be read at veghdev.github.io/write-pypistat.

Release

write-pypistat is distributed on pypi. Note: You need to be an administrator to release the project.

If you want to release write-pypistat follow the steps below.

  • You should increase the version number in setup.py. The version bump should be in a separated commit.

  • Generate the release notes and publish the new release on Releases.

Note: Publishing a new release will automatically trigger the release workflow which builds, checks and uploads the write-pypistat package to pypi.

You can build and check the package before a release with the release make target.

make release