https://github.com/smkent/copier-python

📋🐍 Copier template for Python projects with modern tooling
https://github.com/smkent/copier-python

codecov container copier copier-template coverage docker github-actions prek python ruff template uv

Last synced: 2 months ago
JSON representation

📋🐍 Copier template for Python projects with modern tooling

• Host: GitHub
• URL: https://github.com/smkent/copier-python
• Owner: smkent
• License: mit
• Created: 2026-04-01T05:55:42.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-06T04:35:37.000Z (2 months ago)
• Last Synced: 2026-04-06T08:29:47.514Z (2 months ago)
• Topics: codecov, container, copier, copier-template, coverage, docker, github-actions, prek, python, ruff, template, uv
• Language: Python
• Homepage: https://smkent.github.io/copier-python/
• Size: 162 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# copier-python

[Copier][copier] template for Python projects with modern tooling

[![Copier][copier-badge]][copier]

[![License](https://img.shields.io/github/license/smkent/copier-python)](https://github.com/smkent/copier-python/blob/main/LICENSE)

[![PyPI](https://img.shields.io/pypi/v/copier-python)](https://pypi.org/project/copier-python/)

[![Python](https://img.shields.io/pypi/pyversions/copier-python)](https://pypi.org/project/copier-python/)

[![GitHub stars](https://img.shields.io/github/stars/smkent/copier-python?style=social)](https://github.com/smkent/copier-python)

## Quick start

With [Astral's **uv**][uv] and [**Copier**][copier] (`uv tool install copier`)

installed:

```sh

copier copy "gh:smkent/copier-python" /new/project/path

```

**[For more details, see the documentation!][docs-usage]**

## Features

* [Astral][astral] toolset: [**uv**][uv], [**ruff**][ruff], and [**ty**][ty]

    [![uv][uv-badge]][uv]

    [![ruff][ruff-badge]][ruff]

    [![ty][ty-badge]][ty]

* [**prek**][prek] for [pre-commit][pre-commit] compatible git hooks

    [![prek][prek-badge]][prek]

* Update automation with [**Renovate**][renovate] and

  [**`copier update`**][copier-update]

    [![Copier][copier-badge]][copier-update]

    [![renovate][renovate-badge]][renovate]

* [**PyPI package**][pypi] and [**container image**][ghcr-docs] release

  automation via [**GitHub Actions**][github-actions]

* [**pytest**][pytest] test framework with [**codecov.io**][codecovio] support

* [**Zensical**][zensical] project documentation with automatic deployment to

  [**GitHub Pages**][github-pages]

* [**Poe the Poet**][poethepoet] for task shortcuts such as

   `poe lint`, `poe test`

## Credits

This template was inspired by [pawamoy/copier-uv][copier-uv] and

[ritwiktiwari/copier-astral][copier-astral] -- Thanks!

[astral]: https://astral.sh

[codecovio]: https://codecov.io

[copier-astral]: https://ritwiktiwari.github.io/copier-astral/

[copier-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-purple.json

[copier-update]: https://copier.readthedocs.io/en/stable/updating/

[copier-uv]: https://pawamoy.github.io/copier-uv/

[copier]: https://copier.readthedocs.io

[docs-usage]: https://smkent.github.io/copier-python/prerequisites/

[ghcr-docs]: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry

[github-actions]: https://github.com/features/actions

[github-pages]: https://pages.github.com

[poethepoet]: https://poethepoet.natn.io/

[pre-commit]: https://pre-commit.com/

[prek-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json

[prek]: https://prek.j178.dev/

[pypi]: https://pypi.org

[pytest]: https://docs.pytest.org

[renovate-badge]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?logo=renovatebot

[renovate]: https://docs.renovatebot.com/

[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json

[ruff]: https://docs.astral.sh/ruff/

[ty-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json

[ty]: https://docs.astral.sh/ty/

[uv-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json

[uv]: https://docs.astral.sh/uv/

[zensical]: https://zensical.org/