python-copier

Template for Python packages based on copier.

Features

• 📦 Package management:
  • Develop with your preferred tools (extras, uv or Hatch).
  • Automatic changelog generation from emoji-typed commit messages.
  • Build your package with Hatch.
• 🧹 Pre-commit: Format and lint your code with Ruff.
• 🧪 Tests: Write tests with pytest, with optional coverage reporting (basic summary or Codecov integration).
• 📚 Documentation: Write docs in MyST or MkDocs.
• ⚙️ GitHub Actions:
  • Deploy documentation to GitHub Pages or Read the Docs.
  • Run pre-commit checks, commit-message linting, and tests on every pull request.
  • Publish to PyPI on vX.Y.Z tags via Trusted Publishing — no API tokens.
  • Optional automatic template updates via a bot.

Usage

Follow the copier installation instructions. Then simply run

copier copy https://github.com/mbercx/python-copier <package_name>

And answer the questions to generate a new Python package.