template project for quickly creating python apps
- 📦 poetry for package management
- 🔬 unittest for testing
- 🦋 pylint for linting
- 📐 mypy for type checking
- 📚 taskipy for task running
- 💻 vscode configuration
- Clone this repository using the following command:
git clone https://github.com/illBeRoy/python-starter-kit.git <your_project_name>
- Run the following command (make sure you have Python ^3.6 installed):
./own_project.py
- Install all the requirements for your project via poetry:
poetry install
The project contains out of the box tasks for your comfort. You can see them in the pyproject.toml
file under the tasks section.
In order to run all test files, simply run the test task:
poetry run task test
This will run all python files under tests
which begin with test_
. If the tests finished successfully, will run linting as well.
If you want to check your code style and run static analysis, use the following command:
poetry run task lint
This will run pylint
for code style check, following by mypy
for static type analysis.
If you want to not publish broken code by mistake, you can run the following task:
poetry run task publish
This command runs tests and linters, and only if everything passes, publishes to pypi using poetry publish
.