Virtual environments
Set up projects with UV, a Python package manager that provides reproducible dependency resolution and Python version management.
Repository setup guides
Collection of guides covering CI/CD, version control, virtual environment management, and documentation for Python development workflows
What you’ll find here
Section titled “What you’ll find here”This collection provides guides for setting up and maintaining Python development repositories. The guides cover automation, best practices, and integrated tooling.
Version control
Use semantic commits with the Conventional Commits specification for readable history and automated versioning.
CI/CD automation
Learn to automate testing, releases, and deployment with GitHub Actions. Includes matrix testing, semantic releases, and PyPI publishing.
Licensing
Track license and copyright information across every file in a repository with the REUSE 3.3 specification.
Documentation
Set up Starlight documentation sites with automated GitHub Pages deployment for technical documentation.
Quick navigation
Section titled “Quick navigation”- Python package template - Create a new package with pre-configured CI/CD
- UV setup - Complete UV guide from installation to publishing
- Semantic commits - Conventional Commits specification
- GitHub Actions basics - Core concepts and workflow syntax
- Automated testing - Set up pytest with UV in CI/CD
- Automated releases - Version bumping and publishing with semantic-release
- REUSE 3.3 compliance - Machine-readable license information for every file
- Starlight setup - Set up documentation sites with GitHub Pages deployment
Why these tools?
Section titled “Why these tools?”The guides focus on tooling that supports reproducibility and automation:
- UV: Provides reproducible dependency resolution through lock files and manages Python versions alongside project dependencies
- Semantic commits: Enables automated versioning and changelog generation through structured commit messages
- GitHub Actions: Native CI/CD platform integrated with GitHub repositories
- REUSE: Machine-readable license compliance for every file in a repository, verified through CI
- Starlight: Documentation framework built on Astro with GitHub Pages integration
Example repositories
Section titled “Example repositories”These repositories apply principles discussed in the guides: