yggtools 1.1.0

uv overlay for opinionated Python package scaffolding.

yggtools

yggtools is a CLI dev tool that scaffolds opinionated Python packages on top of uv. It sets up a complete project in one command and provides a built-in quality pipeline you run with make check.

Install

uv tool install yggtools

Quick start

# Scaffold a new library
yggtools init-repo my-lib

# Run the quality pipeline
cd my-lib
make check

Commands

Command	Description
yggtools init-repo NAME	Scaffold a new Python package
yggtools run [CHECK]	Run quality checks on the current project
yggtools run --all	Run all registered quality checks

Quality checks

Check	Tool
Format	ruff format --check
Lint (ruff)	ruff check
Lint (flake8)	flake8
Docstrings	built-in AST scan
Type check	mypy --strict
Metrics	built-in CC + line-count
Security (code)	bandit
Security (deps)	pip-audit
Tests	pytest --cov-fail-under=100

Documentation

• User guide
• Architecture Decision Record — rebaseline
• Software Requirements Specification
• Software Design Document

License

MIT