Skip to content

xerox-python

A copier template for Python packages

ยท 3 1

Created: 2025-04-04

xerox-python is a project template that spins up a new python project in about a minute.

[!WARNING] This template is extremely opinionated. It creates a Python project just the way I like. It might not be immediately useful for anyone else unless they adapt it to their needs.

Usage

There branches available that each build a different project type:

  • main: [Default] Builds a basic python project
  • fastapi: Builds a basic FastAPI python project
  • flask: Builds a basic Flask python project
  • typer: Builds a basic Typer CLI project
  • typerdrive: Builds a basic typerdrive CLI project

Local

Clone this repo:

git clone git@github.com:dusktreader/xerox-python

If you want to use a template besides main, checkout the branch you wish to use.

Then just run make:

make

One line

You can use the following one-line commands to build a project from the selected branch

main branch

uvx copier copy --trust gh:dusktreader/xerox-python .

fastapi branch:

uvx copier copy --trust gh:dusktreader/xerox-python --vcs-ref=fastapi .

flask branch:

uvx copier copy --trust gh:dusktreader/xerox-python --vcs-ref=flask .

typer branch:

uvx copier copy --trust gh:dusktreader/xerox-python --vcs-ref=typer .

typerdrive branch:

uvx copier copy --trust gh:dusktreader/xerox-python --vcs-ref=typerdrive .