Copier PDM

Copier template for PDM projects.

This copier template is mainly for my own usage, but feel free to try it out, or fork it!

You need to install Copier first.

Features

Package manager

The template project uses PDM setup, with pre-defined pyproject.toml

Documentation and changelog

• Documentation is built with MkDocs (Material theme)

Pre-commit and linter

pre-commit is used for both commit hook and linting, including the following hooks:

• ruff

VSCode default settings

The .vscode/settings.json will also be generated with the project, to enable Pylance auto-completions and test discovery in VSCode.

Tests

• Tests run with pytest
• Multi-environment testing powered by nox

Typer

The generated project has a template for a CLI which uses Typer.

Requirements

Make below requirements are met to use the copier template:

• Python 3
• Git
• Copier
• PDM

Optional

• direnv
• pyenv

Quick Start

copier copy "https://github.com/monora/copier-pdm.git" <project_name>

Or even shorter:

copier copy "gh:monora/copier-pdm" <project_name>

See the documentation for more details.