Acts as a SonarQube equivalent. Installs, configures, and enforces ultra-strict code quality using Ruff, Mypy, and Vulture. Use to setup linters, fix cyclomatic complexity, or hunt dead code, unused methods, and orphan classes.
pyproject.toml, ruff.toml).Check pyproject.toml or requirements.txt. If ruff, mypy, or vulture are missing from the dev dependencies, install them immediately (e.g., uv add --dev ruff mypy vulture).
Check pyproject.toml (under [tool.ruff]). If it exists, REFINE it; if not, CREATE it. Enforce an ULTRA-STRICT configuration:
select:
["E", "F", "W", "I", "N", "B", "C90", "SIM", "ARG", "PL", "ERA", "RUF"]F: Unused imports/variables.C90: McCabe Complexity. Enforce [tool.ruff.lint.mccabe] max-complexity = 8 to prevent spaghetti code.PL: Pylint (duplicated code, bad design).ARG: Unused function arguments.ERA: Eradicate (Commented-out zombie code).C901), apply the Composed Method pattern (extract logic into smaller private methods). If it finds commented code (ERA001), DELETE IT. We use Git for history.Vulture specifically finds unused methods, classes, and properties globally across the project.
pyproject.toml:
[tool.vulture]
min_confidence = 80
paths = ["src/"]
Check pyproject.toml or mypy.ini. Refine to ensure strict enforcement: strict = true disallow_untyped_defs = true warn_unused_ignores = true3a:["$","$L42",null,{"content":"$43","frontMatter":{"name":"python-quality-gate","description":"Acts as a SonarQube equivalent. Installs, configures, and enforces ultra-strict code quality using Ruff, Mypy, and Vulture. Use to setup linters, fix cyclomatic complexity, or hunt dead code, unused methods, and orphan classes."}}]