1.9 KiB
Contributing to EasyCV
All kinds of contributions are welcome, including but not limited to the following:
- Fix typo or bugs
- Add documentation or translate the documentation into other languages
- Add new features and components
Workflow
- fork and pull the latest EasyCV repository
- checkout a new branch (do not use master branch for PRs)
- commit your changes
- create a PR
If you plan to add some new features that involve large changes, it is encouraged to open an issue for discussion first.
Develop
Code Style
We adopt PEP8 as the preferred code style.
We use the following toolsseed isortseed isortseed isort for linting and formatting:
Style configurations of yapf and isort can be found in setup.cfg.
We use pre-commit hook that checks and formats for flake8, yapf, seed-isort-config, isort, trailing whitespaces,
fixes end-of-files, sorts requirments.txt automatically on every commit.
The config for a pre-commit hook is stored in .pre-commit-config.
After you clone the repository, you will need to install initialize pre-commit hook.
pip install -r requirements/tests.txt
From the repository folder
pre-commit install
After this on every commit check code linters and formatter will be enforced.
If you want to use pre-commit to check all the files, you can run
pre-commit run --all-files
If you only want to format and lint your code, you can run
make linter
Test
run unittest with following code
make test
Build pip package
make whl