mcpField
T
tooling

tooling

github.com/ludo-technologiesOther3439 installsUpdated 1w ago
Repository

About tooling

Python development tooling configuration and best practices for ruff, mypy, pytest, pyscn, and uv. Use when setting up a Python project, configuring linters, formatters, type checkers, or test frameworks, or when editing pyproject.toml or tool config files.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ludo-technologies/python-best-practices --skill tooling

After installing, type/toolingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

metadata.json
README.md
rules/
_sections.md
_template.md
analysis-pyscn.md
fmt-ruff.md
lint-ruff.md
pkg-pyproject.md
pkg-uv.md
test-pytest.md
type-mypy.md

Details

From the project README

Python Tooling

A comprehensive guide to Python development tools. Configuration best practices for analysis, linters, type checkers, formatters, test frameworks, and package managers.

Why These Tools Matter

To write high-quality Python code, we recommend adopting these tools:

  • pyscn - Detect dead code, duplicates, and circular dependencies to prevent technical debt
  • ruff - Catch bugs and style violations early with fast static analysis
  • mypy - Find errors before runtime with type checking, also improves IDE completion
  • pytest - Build confidence in changes with reliable tests
  • uv - Improve developer experience with fast dependency management

Integrating these into CI/CD reduces code review burden and maintains consistent quality.

Categories

Analysis [HIGH]

Structural code analysis for quality assessment.

RuleDescription
analysis-pyscnDead code, clones, dependencies, complexity with pyscn
Linting [CRITICAL]

Static code analysis with ruff for consistent, high-quality code.

RuleDescription
lint-ruffFast, comprehensive linting with ruff
Type Checking [HIGH]

Static type checking with mypy for type safety and better IDE support.

RuleDescription
type-mypyStatic type checking with mypy
Formatting [HIGH]

Consistent code formatting with ruff format and import sorting.

RuleDescription
fmt-ruffCode formatting and import sorting with ruff
Testing [HIGH]

Test framework configuration with pytest for reliable testing.

RuleDescription
test-pytestTesting with pytest, fixtures, and coverage
Package Management [MEDIUM]

Modern Python packaging with uv and pyproject.toml.

RuleDescription
pkg-uvFast package management with uv
pkg-pyprojectProject configuration with pyproject.toml

Quick Reference

Minimal pyproject.toml
[project]
name = "myproject"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = []

[project.optional-dependencies]
dev = ["ruff", "mypy", "pytest", "pytest-cov", "pyscn"]

[tool.ruff]
target-version = "py311"
line-length = 88

[tool.ruff.lint]
select = ["E", "F", "W", "I", "UP", "B", "BLE", "SIM", "PTH", "S110", "S112"]

[tool.ruff.lint.flake8-bandit]
check-typed-exception = true

[tool.mypy]
python_version = "3.11"
strict = true

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = ["-v", "--tb=short"]

[tool.pyscn]
max_complexity = 15
Common Commands
# Analysis
pyscn analyze .                 # Full quality analysis
pyscn check .                   # CI quality gate

# Linting
ruff check .                    # Check for issues
ruff check . --fix              # Auto-fix issues

# Formatting
ruff format .                   # Format code

# Type checking
mypy .                          # Type check

# Testing
pytest                          # Run tests
pytest --cov=src                # With coverage

# Package management (uv)
uv pip install -e ".[dev]"      # Install with dev deps
uv pip compile pyproject.toml -o requirements.lock

Comments

Markdown supported