https://github.com/pawamoy/copier-uv

Copier template for Python projects managed by uv.
https://github.com/pawamoy/copier-uv

copier copier-python copier-template project-template python uv

Last synced: 19 days ago
JSON representation

Copier template for Python projects managed by uv.

• Host: GitHub
• URL: https://github.com/pawamoy/copier-uv
• Owner: pawamoy
• License: isc
• Created: 2024-02-15T21:55:29.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-10-23T16:14:22.000Z (28 days ago)
• Last Synced: 2024-10-23T21:41:56.200Z (28 days ago)
• Topics: copier, copier-python, copier-template, project-template, python, uv
• Language: Jinja
• Homepage: https://pawamoy.github.io/copier-uv/
• Size: 2.25 MB
• Stars: 25
• Watchers: 3
• Forks: 4
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• jimsghstars - pawamoy/copier-uv - Copier template for Python projects managed by uv. (Jinja)

README

        
# Copier UV

[![ci](https://github.com/pawamoy/copier-uv/workflows/ci/badge.svg)](https://github.com/pawamoy/copier-uv/actions?query=workflow%3Aci)

[![documentation](https://img.shields.io/badge/docs-mkdocs%20material-blue.svg?style=flat)](https://pawamoy.github.io/copier-uv/)

[![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#copier-uv/community:gitter.im)

[Copier](https://github.com/copier-org/copier) template

for Python projects managed by [uv](https://github.com/astral-sh/uv).

This copier template is mainly for my own usage,

but feel free to try it out, or fork it!

Similar templates:

- [copier-pdm](https://github.com/pawamoy/copier-pdm), with [PDM](https://github.com/pdm-project/pdm)

- [copier-poetry](https:///github.com/pawamoy/copier-poetry), with [Poetry](https://github.com/python-poetry/poetry)

## Features

- [uv](https://github.com/astral-sh/uv) setup, with pre-defined `pyproject.toml`

- Pre-configured tools for code formatting, quality analysis and testing:

  [ruff](https://github.com/charliermarsh/ruff),

  [mypy](https://github.com/python/mypy),

- Tests run with [pytest](https://github.com/pytest-dev/pytest) and plugins, with [coverage](https://github.com/nedbat/coveragepy) support

- Documentation built with [MkDocs](https://github.com/mkdocs/mkdocs)

  ([Material theme](https://github.com/squidfunk/mkdocs-material)

  and "autodoc" [mkdocstrings plugin](https://github.com/mkdocstrings/mkdocstrings))

- Cross-platform tasks with [duty](https://github.com/pawamoy/duty)

- Support for GitHub workflows

- Auto-generated `CHANGELOG.md` from Git (conventional) commits

- All licenses from [choosealicense.com](https://choosealicense.com/appendix/)

- Support for Insiders versions of projects (e.g. see [@pawamoy's insiders](https://pawamoy.github.io/insiders/))

## Quick setup and usage

Make sure all the

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

are met, then:

```bash

copier copy --trust "https://github.com/pawamoy/copier-uv.git" /path/to/your/new/project

```

Or even shorter:

```bash

copier copy --trust "gh:pawamoy/copier-uv" /path/to/your/new/project

```

See the [documentation](https://pawamoy.github.io/copier-uv)

for more details.