python-project-foundry 0.2.0

Python project template that follows proven patterns. Scaffolds libraries, CLIs, and web services.

Python Project Foundry

Create a project

With uv installed, scaffold a project directly from the published package:

uvx python-project-foundry /path/to/new/project

If uv is not installed, macOS and Linux users can bootstrap it and scaffold the project with one command:

curl -LsSf https://raw.githubusercontent.com/ryancswallace/python-project-foundry/main/ppf | sh -s -- /path/to/new/project

The launcher installs a compatible uv version when necessary, then runs Python Project Foundry in an isolated environment. No repository clone or separate setup command is required.

Both commands prompt for the template's answers and execute the generated project's setup tasks. Run uvx python-project-foundry template --help to see options for unattended generation, overwriting files, previewing changes, and skipping setup tasks.

Contributor setup

For work on Python Project Foundry itself, make setup installs uv when needed and syncs the complete development environment:

make setup
make check