Copier UV Template

This is a very simple copier template for Python projects with src layout and dependency management by uv.

Features

• Automated copier questions
• Setup for uv
• Included dev tools for formatting, quality checks and testing:
  • ruff
  • pre-commit
  • black
  • pytest
• The project is structured in the src layout

Usage

Requirements

You need to have uv and copier installed. Install uv and an accompanying Python version (or use your own Python environment like pyenv or conda):

curl -LsSf https://astral.sh/uv/install.sh | sh
# optional:
uv python install 3.12

Install copier with uv or pipx (this will install uv globally):

pipx install copier

or

uv tool install copier

Generate a Project

To generate a new project, execute the following command:

copier copy --trust "gh:jkoessle/uv-copier-template" /path/to/your/new/project

It's also possible to use uv directly, without the need to install copier:

uvx copier copy --trust "gh:jkoessle/uv-copier-template" /path/to/your/new/project