Development¶
Pull Request¶
PR’s are Welcome!
Please read more about Contributing.
Metric Dashboard¶

Note on Shields¶
flake8-commas, one of the development plugins of the wemake-python-styleguide is marked as No Maintenance Intended. See this Issue. Most probable wemake will replace this dependency with a fork.
python 3.7 is deprecated. However some dev tools are still dependant.
mistune@0.8.4 Introduced through: project@0.0.0 › m2r2@0.3.2 › mistune@0.8.4 Fix: Pin mistune to version 2.0.1
Issues Too many dependencies. We try to update as good as possible.
Features¶
Fully typed with annotations
Checked with mypy
Packaging PEP561 compatible
Tools¶
Python Packages¶
pypi.org Python Package Index
pythonrepo.com Popular Python Libraries
Style and type annotations¶
Testing¶
pytest test framework
The Magic Tricks of Testing by Sandi Metz (Talk) on what to test, and what not
Continuous Testing & Integration (CT & CI)¶
Integration as in: Deployment and Integration testing.
-
pytest & coverage (yml) pytest @ python-version: [‘3.7’, ‘3.8’, ‘3.9’, ‘3.10’]
Alternatives to github actions
tox test and deploy, w/yaml (py version centric)
nox test and deploy, w/ python (more general)
travis test and deploy
coveralls.io coverage
Possible alternatives to make / Makefile?
Build and publish to pypi¶
make Makefile automate above
poetry version bump bump version
poetry build wheel
poetry publish to pypi
Following Semantic Versioning¶
-
semver Python Package
Development Environment¶
poetry python packaging and dependency management
cookiecutter creates projects from project templates
venv creates projects from project templates
Version and Issue Management¶
IDE¶
vi advanced text editor
VS Code source-code editor
VS Code sttings for python [video]
If needed¶
jupyter for rapid prototyping only
Shell¶
Hardware¶
Server¶
Documentation¶
Markdown lightweight markup language
sphinx Python documentation Generator
doc8 opinionated style checker for rst
readthedocs document style and service
Metric¶
shields for Shields and Badges
issuehub.pro Label Guide
cloc for SLOC
Jason Query for Makefile and Shields¶
Teaching Python Development¶
cli-calc Examples¶
make¶
make Makefile (cli-calc) automate above