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.
Documentation
Set up Starlight documentation sites with automated GitHub Pages deployment for technical documentation.
Quick navigation
Section titled “Quick navigation”- 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
- 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
- Starlight: Documentation framework built on Astro with GitHub Pages integration
Example repositories
Section titled “Example repositories”These repositories apply principles discussed in the guides: