We use poetry to manage the dependencies.
To install them you would need to run install
command:
poetry install
To activate your virtualenv
run poetry shell
.
Run make test
to run everything we have!
We use pytest
and flake8
for quality control.
We also use wemake_python_styleguide to enforce the code quality.
To run all tests:
make unit
To run linting:
make lint
Keep in mind: default virtual environment folder excluded by flake8 style checking is .venv
.
If you want to customize this parameter, you should do this in setup.cfg
.
These steps are mandatory during the CI.
We use mypy
to run type checks on our code.
To use it:
make mypy
This step is mandatory during the CI.
What the point of this method?
- We use protected
main
branch, so the only way to push your code is via pull request - We use issue branches: to implement a new feature or to fix a bug
create a new branch named
issue-$TASKNUMBER
- Then create a pull request to
main
branch - We use
git tag
s to make releases, so we can track what has changed since the latest release
So, this way we achieve an easy and scalable development process which frees us from merging hell and long-living branches.
In this method, the latest version of the app is always in the main
branch.
Before submitting your code please do the following steps:
- Run
make test
to make sure everything was working before - Add any changes you want
- Add tests for the new changes
- Edit documentation if you have changed something significant
- Run
make test
again to make sure it is still working
You can contribute by spreading a word about this library. It would also be a huge contribution to write a short article on how you are using this project. You can also share your best practices with us.