https://github.com/zigai/python-project-template
My personal Copier template for Python projects
https://github.com/zigai/python-project-template
copier copier-python copier-template hatch pyproject-toml python-project-template uv uv-python
Last synced: 3 months ago
JSON representation
My personal Copier template for Python projects
- Host: GitHub
- URL: https://github.com/zigai/python-project-template
- Owner: zigai
- License: mit
- Created: 2025-07-13T13:43:55.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-07-13T22:13:08.000Z (3 months ago)
- Last Synced: 2025-07-14T00:21:47.061Z (3 months ago)
- Topics: copier, copier-python, copier-template, hatch, pyproject-toml, python-project-template, uv, uv-python
- Language: Jinja
- Homepage:
- Size: 90.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Copier Python Template
My personal Copier template for Python projects.
## Features
* **Modern Python tooling** with [uv](https://docs.astral.sh/uv/) for dependency management and environment setup
* **Pre-configured ```pyproject.toml```**
* **Automated workflows** - [just](https://github.com/casey/just) commands for testing, linting, and building
* **Code quality tools**: [ruff](https://docs.astral.sh/ruff/) for linting and formatting, pre-commit hooks
* **Testing setup** with [pytest](https://docs.pytest.org/en/stable/) and [Hatch](https://hatch.pypa.io/latest/) for cross-version testing
* **GitHub Actions integration**: optional workflows for linting, testing and PyPI publishing
* **Licenses from** [choosealicense.com](https://choosealicense.com/)
* **Basic ```README.md```** with badges and installation instructions
## Requirements
* Python 3.8+
* [Copier](https://copier.readthedocs.io/) (`pip install copier copier_templates_extensions`)
* Git
## Quick Setup
Create a new Python project:
```bash
copier copy --trust "https://github.com/zigai/python-project-template.git" /path/to/your/project
```
or
```bash
copier copy --trust "gh:zigai/python-project-template" /path/to/your/project
```
## Generated Project Structure
```
your-project/
├── your_package/
│ └── __init__.py
├── tests/
│ └── test_your_package.py
├── .github/workflows/
│ └── publish.yml
├── pyproject.toml
├── README.md
├── CONTRIBUTING.md
├── Justfile
├── LICENSE
└── .gitignore
```
## Similar Templates
* [copier-uv](https://github.com/pawamoy/copier-uv)
* [python-copier-template](https://github.com/DiamondLightSource/python-copier-template)
## License
This template is released under the [MIT License](https://github.com/zigai/python-project-template/blob/master/LICENSE).