OpenDisplay Python Module Template

A cookiecutter template for creating Python packages.

Features

• Modern Python packaging (PEP 517/621) with hatchling
• uv for fast dependency management
• GitHub Actions CI/CD (test, lint, release)
• Automated releases with release-please
• PyPI publishing with trusted publishing
• Pre-configured ruff (linting) and mypy (type checking)
• Python 3.11, 3.12, 3.13 test matrix

Quick Start

# Generate new project
uvx cookiecutter gh:OpenDisplay-org/python-module-template

# Follow interactive prompts, then:
cd your-project-name
git init && git add . && git commit -m "chore: initial commit"
uv sync --all-extras

After Generation

1. Create GitHub repository: At OpenDisplay-org/your-project-slug
2. Configure PyPI trusted publishing: In PyPI project settings
3. Push initial commit: git remote add origin ... && git push -u origin main
4. Start developing: Add code to src/package_name/
5. Write tests: Add tests to tests/
6. Update README: Customize the generated README.md
7. First release: Commit using conventional commits (feat:, fix:, etc.)

Development Commands

# Install with all dependencies
uv sync --all-extras

# Run tests
uv run pytest tests/ -v

# Run tests with coverage
uv run pytest tests/ --cov=src/package_name

# Lint code
uv run ruff check .

# Type check
uv run mypy src/package_name

Conventional Commits

Use conventional commit messages for automatic versioning:

• feat: - New feature (minor version bump)
• fix: - Bug fix (patch version bump)
• feat!: or fix!: - Breaking change (major version bump)
• docs:, refactor:, test:, chore: - No version bump