pyrig Documentation

pyrig is a python toolkit that rigs up your project by standardizing and automating project setup, configuration and maintenance

Philosophy

pyrig provides minimal best practices fully working defaults for everything a project needs. Every configuration, workflow, and tool is pre-configured and working from day one. No templates, no boilerplate - just a complete, tested, production-ready setup that lets you start coding immediately.

Quick Start

# Create repository on GitHub, then clone it
git clone https://github.com/username/my-project.git
cd my-project

# Initialize with uv and pyrig
uv init
uv add pyrig
uv run pyrig init

# Push to GitHub
git push -u origin main

New to pyrig? See the Getting Started Guide for complete setup instructions including prerequisites, required tokens, and detailed explanations.

Documentation

CLI Documentation

Learn how pyrig's CLI system works, including command discovery, multi-package support, and how to create your own commands.

Testing Documentation

Understand pyrig's testing framework, including mirrored test structure, automatic fixture sharing, and autouse validation fixtures.

Builder Documentation

Create distributable artifacts with pyrig's builder system, including PyInstaller executables and custom build processes.

Resources Documentation

Manage static files (images, configs, templates) that work seamlessly in both development and PyInstaller executables.

Configuration Files Documentation

Understand pyrig's configuration file system, including automatic discovery, validation, and creating custom config files. This is the main feature of pyrig that generates a complete project structure for you, ready to use and start developing your project.