Python Project Template
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.
HOW TO USE THIS TEMPLATE
DO NOT FORK this is meant to be used from Use this template feature.
- Click on Use this template
- Give a name to your project
(e.g.my_awesome_projectrecommendation is to use all lowercase and underscores separation for repo names.) - Wait until the first run of CI finishes
(Github Actions will process the template and commit to your new repo) - If you want codecov Reports and Automatic Release to PyPI
On the new repositorysettings->secretsadd yourPIPY_API_TOKENandCODECOV_TOKEN(get the tokens on respective websites) - Read the file CONTRIBUTING.md
- Then clone your new project and happy coding!
NOTE: WAIT until first CI run on github actions before cloning your new project.
What is included on this template?
-
🖼️ Templates for starting multiple application types:- Basic low dependency Python program (default) use this template
- Flask with database, admin interface, restapi and authentication use this template. or Run
make initafter cloning to generate a new project based on a template.
-
📦 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-poetrylater 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.
Containerfileis 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 usingpython -mor$ project_namewith basic CLI argument parsing. -
🔄 Continuous integration using Github Actions with jobs to lint, test and release your project on Linux, Mac and Windows environments.
Curious about architectural decisions on this template? read ABOUT_THIS_TEMPLATE.md
If you want to contribute to this template please open an issue or fork and send a PULL REQUEST.
project_name
project_description
Install it from PyPI
pip install project_name
Usage
from project_name import BaseClass
from project_name import base_function
BaseClass().base_method()
base_function()
$ python -m project_name
#or
$ project_name
Development
Read the CONTRIBUTING.md file.
230 Jan 07, 2023
6.9k Dec 27, 2022
2 Mar 01, 2022
[email protected]">
4 Dec 16, 2022
12 Sep 25, 2022
8 Oct 10, 2022
18 Sep 19, 2022
7 Mar 09, 2022
2 Feb 10, 2022
4 Oct 18, 2021
2 Jun 04, 2022
96 Dec 15, 2022
1 Oct 27, 2021
4 Oct 13, 2022
2 Nov 05, 2021
4 Feb 17, 2022
6 Nov 10, 2021
2 Aug 17, 2022
166 Jan 01, 2023
3 Jan 04, 2022