A low dependency and really simple to start project template for Python Projects.
See also Flask-Project-Template for a full feature Flask project including database, API, admin interface, etc.
- If you want codecov Reports and
Automatic Release to PyPI
On the new repositorysettings->secrets
add yourPIPY_API_TOKEN
andCODECOV_TOKEN
(get the tokens on respective websites)
-
๐ฆ A basic setup.py file to provide installation, packaging and distribution for your project.
Template uses setuptools because it's the de-facto standard for Python packages, you can runmake switch-to-poetry
later if you want. -
๐ค A Makefile with the most useful commands to install, test, lint, format and release your project.
-
๐ Documentation structure using mkdocs
-
๐ฌ Auto generation of change log using gitchangelog to keep a HISTORY.md file automatically based on your commit history on every release.
-
๐ A simple Containerfile to build a container image for your project.
Containerfile
is a more open standard for building container images than Dockerfile, you can use buildah or docker with this file. -
๐งช Testing structure using pytest
-
โ Code linting using flake8
-
๐ Code coverage reports using codecov
-
๐ณ๏ธ Automatic release to PyPI using twine and github actions.
-
๐ฏ Entry points to execute your program using
python -m <bookish_enigma>
or$ bookish_enigma
with basic CLI argument parsing. -
๐ Continuous integration using Github Actions with jobs to lint, test and release your project on Linux, Mac and Windows environments.
Awesome bookish_enigma created by conradstorz
pip install bookish_enigma
from bookish_enigma import BaseClass
from bookish_enigma import base_function
BaseClass().base_method()
base_function()
$ python -m bookish_enigma
#or
$ bookish_enigma
Read the CONTRIBUTING.md file.