#cli #python #template

app python-project-generator

Generates a Python project structure

20 releases (5 breaking)

new 0.6.10 Nov 28, 2023
0.6.9 Nov 21, 2023
0.6.8 Oct 28, 2023
0.5.0 Oct 3, 2023
0.1.2 Sep 7, 2023

#73 in Command line utilities

Download history 40/week @ 2023-08-31 111/week @ 2023-09-07 41/week @ 2023-09-14 10/week @ 2023-09-21 47/week @ 2023-09-28 50/week @ 2023-10-05 155/week @ 2023-10-12 115/week @ 2023-10-19 105/week @ 2023-10-26 7/week @ 2023-11-02 2/week @ 2023-11-09 71/week @ 2023-11-16 74/week @ 2023-11-23

172 downloads per month

MIT license


Python Project Generator

Tests Status

Generates a Python project structure with github actions for continuous integration and continuous deployment. Both pure Python projects and Python projects with Rust modules using PyO3 can be created.

Pure Python project included packages

For package managment choose between:

Dev packages:

Python project with Rust modules included packages

  • maturin for package management
  • mypy for static type checking
  • pre-commit for pre-commit hooks
  • pytest for testing
  • pytest-cov for test coverage reports
  • ruff for linting and code formatting
  • PyO3 for managing the Rust/Python FFI
  • justfile for running commands (to use this you will need to install just)


Python Project Generator can be installed with binaries provided with each release here, or with cargo.

cargo install python-project-generator

How to use

Create a new project

From your terminal run:

python-project create

You will be asked a series of questions that will be used to generate your project. The project generator will check pypi for the lastest version of the included packages and use those while generating the project. This feature can be disabled by using with either -s or --skip-download-latest-packages when running the generator. If either there is an issue with retrieving the latest versions or if you have decided to skip looking up the latest version, the packages will be be created with default versions.

python-project create -s

After running the generator a new directory will be created with the name you used for the Project Slug. Change to this directory then install the python packages and pre-commit hooks.

Pure Python Projects

Install the Python dependencies when using Poetry.

poetry install

Install the Python dependencies when using setuptools.

First create a virtual environment and activate it.

python -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements-dev.txt

Install the pre-commit hooks.

pre-commit install

PyO3 projects

First create a virtual environment and activate it.

python -m venv .venv
. .venv/bin/activate

Install the dependencies and build the rust module.

just install

Install the pre-commit hooks.

pre-commit install

Now your project is ready to use.

Save custom default values

You can specify default values for many of the project options. For example to save a default creator:

python-project config creator "Wade Watts"

To see a full list of values that be set as defaults run:

python-project config --help

To view the current saved defaults:

python-project config show

To remove custom defaults:

python-project config reset


If you are interested in contributing please see our contributing guide


~360K SLoC