Copier Test

A simple modern Python project template powered by Copier.

Article 日本語記事

• 🚀 Modern Python: Support for Python 3.10-3.13
• 📦 uv Package Manager: Fast and reliable package management with uv
• 🐳 Docker Support: Complete Docker development environment
• 📦 Devcontainer Support: VS Code devcontainer for consistent development
• ✨ AI Editor Support: AGENTS.md and CLAUDE.md included for AI-powered development
• 📝 Type Hints: Full type annotation support with modern Python features
• 🔍 Code Quality: Pre-configured Ruff for linting and formatting
• 🧪 Testing: pytest setup with example tests
• 🔧 Pre-commit Hooks: Automated code quality checks
• 🏗️ CI Ready: GitHub Actions workflows included

• uv: Fast Python package installer

uvx copier copy gh:mjun0812/python-copier-template your-project-name

Follow the interactive prompts to configure your project:

• Project name: Your project's name
• Python version: Choose from 3.10, 3.11, 3.12, or 3.13
• Package name: The name used for importing your package (e.g., import package_name)
• Description: A short description of your project
• Author name: Your name
• Author email: Your email address

After generating your project:

cd your-project-name
# Install dependencies
uv sync
# Install pre-commit hooks
uv run pre-commit install
# Run tests
uv run pytest
# Run formatting and linting (automatically runs on commit)
uv run ruff format .
uv run ruff check .
# Auto Fix
uv run ruff check . --fix

The template includes a complete Docker setup:

# create uv.lock file
uv sync
# use the provided scripts
./docker/build.sh
./docker/run.sh # or./docker/run.sh (Command)
# Build and run with Docker Compose
docker compose build
docker compose up

Open the project in VS Code and use the "Reopen in Container" command for a fully configured development environment. Devcontainer will automatically install uv, Claude Code, and pre-commit hooks.

cd your-project-name
uvx copier update -A

your-project/
├── src/
│ └── your_project/ # Main package
├── tests/ # Test files
├── docker/ # Docker configuration
├── compose.yml # Docker Compose setup
├── pyproject.toml # Project configuration
└── README.md # Project documentation

• AGENTS.md(./template/AGENTS.md)
• CLAUDE.md(./template/CLAUDE.md)

I'm waiting for stable release of ty. You can install and use your preferred type checker.

• 📖 Copier Documentation
• 🐍 uv Documentation
• 🔍 Ruff Documentation