py-smart-verify 1.1.0

Professional Python verification CLI tool combining linting, type checking, and smart testing

py-smart-verify

Professional Python verification CLI tool combining linting, type checking, and smart testing into a single command.

Features

• Unified pipeline - Run formatters, linters, type checkers, and tests in one command
• Smart testing - Only run tests affected by your changes (via py-smart-test)
• Caching - Skip steps that haven't changed since the last run
• Dependency graph - Detect circular dependencies and visualize module relationships
• Code analysis - Check architecture guidelines, import patterns, and coding standards

Installation

pip install py-smart-verify

Or with uv:

uv add py-smart-verify

Optional tools

Install all supported verification tools:

pip install py-smart-verify[all-tools]

Quick start

# Run all quality checks (format, lint, type check, analyze)
py-smart-verify verify quality

# Run tests (smart mode - only affected tests)
py-smart-verify verify tests

# Run everything
py-smart-verify verify

# Use the short alias
pyv verify quality

Commands

verify

Run verification checks on Python code.

# Run specific tasks
py-smart-verify verify ruff mypy

# Run with options
py-smart-verify verify --no-cache --continue quality
py-smart-verify verify --paths src,lib --full-tests
py-smart-verify verify --staged tests  # pre-commit mode

Options:

Flag	Description
--no-cache	Disable caching
--continue	Continue after errors (default: fast-fail)
--paths	Paths to verify (comma-separated)
--full-tests	Run all tests with smart prioritization
--staged	Test only staged changes (pre-commit mode)
--since REF	Git ref for smart test diff (default: main)
--skip-tests	Skip test execution
-v	Verbose output

graph

Build and display the dependency graph.

py-smart-verify graph
py-smart-verify graph --output deps.json

affected

List tests affected by code changes.

py-smart-verify affected
py-smart-verify affected --since main --json

regen-graph

Regenerate the py-smart-test dependency graph.

py-smart-verify regen-graph

Available tasks

Category	Tasks
Formatters	format (black), isort, ruff-fix
Linters	flake8, pyflakes
Type checkers	mypy, pyright, basedpyright
Analyzers	architecture, standards, imports, circular-deps, deprecations
Testing	tests, full-tests, e2e-tests, full-e2e-tests
Composite	quality (all formatters + linters + type checkers + analyzers)

Requirements

• Python 3.11+
• Individual tools (ruff, mypy, etc.) installed separately or via py-smart-verify[all-tools]

License

MIT