python-code-quality 0.2.2__tar.gz → 0.3.0__tar.gz

{python_code_quality-0.2.2 → python_code_quality-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-code-quality
-Version: 0.2.2
+Version: 0.3.0
 Summary: Python Code Quality Analysis Tool - feed the results from 11 CQ tools straight into an LLM. Minimal tokens.
 Author: Chris Kilner
 Author-email: Chris Kilner <chris@rhiza.fr>
@@ -17,7 +17,7 @@ Requires-Dist: pytest-cov>=6.1.1
 Requires-Dist: pytest-json-report>=1.5.0
 Requires-Dist: radon>=6.0.1
 Requires-Dist: rich>=14.0.0
-Requires-Dist: ruff>=0.14.1
+Requires-Dist: ruff>=0.14.1,<0.17
 Requires-Dist: tomlkit>=0.13.0
 Requires-Dist: ty>=0.0.17
 Requires-Dist: typer>=0.16.0
@@ -65,6 +65,8 @@ uv tool install .
 
 These tools are run in **parallel** except:
 When running '-o llm', we run sequentially and exit early at the first error.
+`coverage` is a special case: it starts alongside `pytest` and is cancelled if
+`pytest` fails, scoring `0%` without a second test run.
 
 | Order | Tool | Measures |
 |----------|------|----------|
@@ -74,11 +76,11 @@ When running '-o llm', we run sequentially and exit early at the first error.
 | 4 | bandit | Security vulnerabilities |
 | 5 | pytest | Test pass rate |
 | 6 | coverage | Test coverage |
-| 7 | radon cc | Cyclomatic complexity |
-| 8 | radon mi | Maintainability index |
-| 9 | radon hal | Halstead volume / bug estimate |
-| 10 | vulture | Dead code |
-| 11 | interrogate | Docstring coverage |
+| 7 | vulture | Dead code |
+| 8 | interrogate | Docstring coverage |
+| 9 | radon cc | Cyclomatic complexity |
+| 10 | radon mi | Maintainability index |
+| 11 | radon hal | Halstead volume / bug estimate |
 
 Diskcache is used to cache tool output for lightning fast re-runs. Sane defaults: <100 Mb, <5 days, No pickle risk.
 
@@ -337,106 +339,117 @@ warning = 0.9
 error = 0.7
 ```
 
-Tool IDs match the keys in `config/config.yaml`: `compile`, `ruff`, `ty`, `bandit`, `pytest`, `coverage`, `radon-cc`, `radon-mi`, `radon-hal`, `vulture`, `interrogate`.
+Tool IDs match the keys in `src/py_cq/config/config.toml`: `compile`, `ruff`, `ty`, `bandit`, `pytest`, `coverage`, `radon-cc`, `radon-mi`, `radon-hal`, `vulture`, `interrogate`.
 
 
 ### Default config
 
-```yaml
-python:
-
-  compile:
-    command: "{python} -m compileall -r 10 -j 8 \"{context_path}\" -x .*venv"
-    parser: "CompileParser"
-    order: 1
-    warning_threshold: 0.9999
-    error_threshold: 0.9999
-
-  ruff:
-    command: "{python} -m ruff check --output-format concise --no-cache \"{context_path}\"{exclude}"
-    exclude_format: " --exclude {path}"
-    parser: "RuffParser"
-    order: 2
-    warning_threshold: 0.9999
-    error_threshold: 0.9
-
-  ty:
-    command: "{python} -m ty check --output-format concise --color never \"{context_path}\"{exclude}"
-    exclude_format: " --exclude {path}"
-    parser: "TyParser"
-    order: 3
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-    run_in_target_env: true
-    extra_deps:
-      - ty
-
-  bandit:
-    command: "{python} -m bandit -r \"{context_path}\" -f json -q -s B101 --severity-level medium --exclude \"{input_path_posix}/.venv,{input_path_posix}/tests{exclude}\""
-    exclude_format: ",{input_path_posix}/{path}"
-    parser: "BanditParser"
-    order: 4
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-
-  pytest:
-    command: "{python} -m pytest -v \"{context_path}\"{exclude}"
-    exclude_format: " --ignore {path}"
-    parser: "PytestParser"
-    order: 5
-    warning_threshold: 1.0
-    error_threshold: 1.0
-    run_in_target_env: true
-    extra_deps:
-      - pytest
-
-  coverage:
-    command: "{python} -m coverage run --omit=*/tests/*,*/test_*.py -m pytest \"{context_path}\" && {python} -m coverage report --omit=*/tests/*,*/test_*.py"
-    parser: "CoverageParser"
-    order: 6
-    warning_threshold: 0.9
-    error_threshold: 0.5
-    run_in_target_env: true
-    extra_deps:
-      - coverage
-      - pytest
-
-  radon-cc:
-    command: "{python} -m radon cc --json \"{context_path}\""
-    parser: "ComplexityParser"
-    order: 7
-    warning_threshold: 0.6
-    error_threshold: 0.4
-
-  radon-mi:
-    command: "{python} -m radon mi -s --json \"{context_path}\""
-    parser: "MaintainabilityParser"
-    order: 8
-    warning_threshold: 0.6
-    error_threshold: 0.4
-
-  radon-hal:
-    command: "{python} -m radon hal -f --json \"{context_path}\""
-    parser: "HalsteadParser"
-    order: 9
-    warning_threshold: 0.5
-    error_threshold: 0.3
-
-  vulture:
-    command: "{python} -m vulture \"{context_path}\" --min-confidence 80 --exclude .venv,dist,.*_cache,docs,.git{exclude}"
-    exclude_format: ",{path}"
-    parser: "VultureParser"
-    order: 10
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-
-  interrogate:
-    command: "{python} -m interrogate \"{context_path}\"{exclude} -v --fail-under 0"
-    exclude_format: " -e {path}"
-    parser: "InterrogateParser"
-    order: 11
-    warning_threshold: 0.8
-    error_threshold: 0.3
+Defined in `src/py_cq/config/config.toml` (sections are namespaced by language):
+
+```toml
+[python.compile]
+command = "{python} -m compileall -r 10 -j 8 \"{context_path}\" -x .*venv|\\.claude"
+parser = "CompileParser"
+order = 1
+warning_threshold = 0.9999
+error_threshold = 0.9999
+cache_invariant = "ast"
+
+[python.ruff]
+command = "{python} -m ruff check --output-format concise --no-cache \"{context_path}\" --exclude .claude{exclude}"
+exclude_format = " --exclude {path}"
+parser = "RuffParser"
+order = 2
+warning_threshold = 0.9999
+error_threshold = 0.9
+
+[python.ty]
+command = "{python} -m ty check --output-format concise --color never \"{context_path}\" --exclude .claude{exclude}"
+exclude_format = " --exclude {path}"
+parser = "TyParser"
+order = 3
+warning_threshold = 0.9999
+error_threshold = 0.8
+run_in_target_env = true
+extra_deps = ["ty"]
+
+[python.bandit]
+command = "{python} -m bandit -r {scan_targets} -f json -q -s B101 --severity-level medium{exclude}"
+scan_exclude_names = [".venv", ".claude", "tests"]
+exclude_format = " --exclude {abs_native_path}"
+parser = "BanditParser"
+order = 4
+warning_threshold = 0.9999
+error_threshold = 0.8
+
+[python.pytest]
+command = "{python} -m pytest -vv \"{context_path}\" --ignore .claude{exclude}"
+exclude_format = " --ignore {path}"
+parser = "PytestParser"
+order = 5
+warning_threshold = 1.0
+error_threshold = 1.0
+run_in_target_env = true
+extra_deps = ["pytest"]
+skip_for_file = true
+cache_invariant = "ast"
+
+[python.coverage]
+command = "{python} -m coverage run --omit=*/tests/*,*/test_*.py -m pytest \"{context_path}\" --ignore .claude{exclude} && {python} -m coverage report --show-missing --omit=*/tests/*,*/test_*.py"
+exclude_format = " --ignore {path}"
+parser = "CoverageParser"
+order = 6
+warning_threshold = 0.9
+error_threshold = 0.5
+run_in_target_env = true
+extra_deps = ["coverage", "pytest"]
+skip_for_file = true
+skip_if = "pytest"
+cache_invariant = "ast"
+
+[python.vulture]
+command = "{python} -m vulture \"{context_path}\" --min-confidence 80 --exclude .venv,dist,.*_cache,docs,.git,.claude{exclude}"
+exclude_format = ",{path}"
+parser = "VultureParser"
+order = 7
+warning_threshold = 0.9999
+error_threshold = 0.8
+cache_invariant = "ast"
+
+[python.interrogate]
+command = "{python} -m interrogate \"{context_path}\" -e .claude{exclude} -v --fail-under 0"
+exclude_format = " -e {path}"
+parser = "InterrogateParser"
+order = 8
+warning_threshold = 0.8
+error_threshold = 0.5
+
+[python.interrogate.parser_config]
+skip_empty_init = true
+
+[python.radon-cc]
+command = "{python} -m radon cc --json --exclude '.claude/**' \"{context_path}\""
+parser = "ComplexityParser"
+order = 9
+gate_strict = false
+warning_threshold = 0.6
+error_threshold = 0.4
+
+[python.radon-mi]
+command = "{python} -m radon mi -s --json --exclude '.claude/**' \"{context_path}\""
+parser = "MaintainabilityParser"
+order = 10
+gate_strict = false
+warning_threshold = 0.6
+error_threshold = 0.4
+
+[python.radon-hal]
+command = "{python} -m radon hal -f --json --exclude '.claude/**' \"{context_path}\""
+parser = "HalsteadParser"
+order = 11
+gate_strict = false
+warning_threshold = 0.35
+error_threshold = 0.3
 ```
 
 ## Respect

{python_code_quality-0.2.2 → python_code_quality-0.3.0}/README.md

@@ -36,6 +36,8 @@ uv tool install .
 
 These tools are run in **parallel** except:
 When running '-o llm', we run sequentially and exit early at the first error.
+`coverage` is a special case: it starts alongside `pytest` and is cancelled if
+`pytest` fails, scoring `0%` without a second test run.
 
 | Order | Tool | Measures |
 |----------|------|----------|
@@ -45,11 +47,11 @@ When running '-o llm', we run sequentially and exit early at the first error.
 | 4 | bandit | Security vulnerabilities |
 | 5 | pytest | Test pass rate |
 | 6 | coverage | Test coverage |
-| 7 | radon cc | Cyclomatic complexity |
-| 8 | radon mi | Maintainability index |
-| 9 | radon hal | Halstead volume / bug estimate |
-| 10 | vulture | Dead code |
-| 11 | interrogate | Docstring coverage |
+| 7 | vulture | Dead code |
+| 8 | interrogate | Docstring coverage |
+| 9 | radon cc | Cyclomatic complexity |
+| 10 | radon mi | Maintainability index |
+| 11 | radon hal | Halstead volume / bug estimate |
 
 Diskcache is used to cache tool output for lightning fast re-runs. Sane defaults: <100 Mb, <5 days, No pickle risk.
 
@@ -308,106 +310,117 @@ warning = 0.9
 error = 0.7
 ```
 
-Tool IDs match the keys in `config/config.yaml`: `compile`, `ruff`, `ty`, `bandit`, `pytest`, `coverage`, `radon-cc`, `radon-mi`, `radon-hal`, `vulture`, `interrogate`.
+Tool IDs match the keys in `src/py_cq/config/config.toml`: `compile`, `ruff`, `ty`, `bandit`, `pytest`, `coverage`, `radon-cc`, `radon-mi`, `radon-hal`, `vulture`, `interrogate`.
 
 
 ### Default config
 
-```yaml
-python:
-
-  compile:
-    command: "{python} -m compileall -r 10 -j 8 \"{context_path}\" -x .*venv"
-    parser: "CompileParser"
-    order: 1
-    warning_threshold: 0.9999
-    error_threshold: 0.9999
-
-  ruff:
-    command: "{python} -m ruff check --output-format concise --no-cache \"{context_path}\"{exclude}"
-    exclude_format: " --exclude {path}"
-    parser: "RuffParser"
-    order: 2
-    warning_threshold: 0.9999
-    error_threshold: 0.9
-
-  ty:
-    command: "{python} -m ty check --output-format concise --color never \"{context_path}\"{exclude}"
-    exclude_format: " --exclude {path}"
-    parser: "TyParser"
-    order: 3
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-    run_in_target_env: true
-    extra_deps:
-      - ty
-
-  bandit:
-    command: "{python} -m bandit -r \"{context_path}\" -f json -q -s B101 --severity-level medium --exclude \"{input_path_posix}/.venv,{input_path_posix}/tests{exclude}\""
-    exclude_format: ",{input_path_posix}/{path}"
-    parser: "BanditParser"
-    order: 4
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-
-  pytest:
-    command: "{python} -m pytest -v \"{context_path}\"{exclude}"
-    exclude_format: " --ignore {path}"
-    parser: "PytestParser"
-    order: 5
-    warning_threshold: 1.0
-    error_threshold: 1.0
-    run_in_target_env: true
-    extra_deps:
-      - pytest
-
-  coverage:
-    command: "{python} -m coverage run --omit=*/tests/*,*/test_*.py -m pytest \"{context_path}\" && {python} -m coverage report --omit=*/tests/*,*/test_*.py"
-    parser: "CoverageParser"
-    order: 6
-    warning_threshold: 0.9
-    error_threshold: 0.5
-    run_in_target_env: true
-    extra_deps:
-      - coverage
-      - pytest
-
-  radon-cc:
-    command: "{python} -m radon cc --json \"{context_path}\""
-    parser: "ComplexityParser"
-    order: 7
-    warning_threshold: 0.6
-    error_threshold: 0.4
-
-  radon-mi:
-    command: "{python} -m radon mi -s --json \"{context_path}\""
-    parser: "MaintainabilityParser"
-    order: 8
-    warning_threshold: 0.6
-    error_threshold: 0.4
-
-  radon-hal:
-    command: "{python} -m radon hal -f --json \"{context_path}\""
-    parser: "HalsteadParser"
-    order: 9
-    warning_threshold: 0.5
-    error_threshold: 0.3
-
-  vulture:
-    command: "{python} -m vulture \"{context_path}\" --min-confidence 80 --exclude .venv,dist,.*_cache,docs,.git{exclude}"
-    exclude_format: ",{path}"
-    parser: "VultureParser"
-    order: 10
-    warning_threshold: 0.9999
-    error_threshold: 0.8
-
-  interrogate:
-    command: "{python} -m interrogate \"{context_path}\"{exclude} -v --fail-under 0"
-    exclude_format: " -e {path}"
-    parser: "InterrogateParser"
-    order: 11
-    warning_threshold: 0.8
-    error_threshold: 0.3
+Defined in `src/py_cq/config/config.toml` (sections are namespaced by language):
+
+```toml
+[python.compile]
+command = "{python} -m compileall -r 10 -j 8 \"{context_path}\" -x .*venv|\\.claude"
+parser = "CompileParser"
+order = 1
+warning_threshold = 0.9999
+error_threshold = 0.9999
+cache_invariant = "ast"
+
+[python.ruff]
+command = "{python} -m ruff check --output-format concise --no-cache \"{context_path}\" --exclude .claude{exclude}"
+exclude_format = " --exclude {path}"
+parser = "RuffParser"
+order = 2
+warning_threshold = 0.9999
+error_threshold = 0.9
+
+[python.ty]
+command = "{python} -m ty check --output-format concise --color never \"{context_path}\" --exclude .claude{exclude}"
+exclude_format = " --exclude {path}"
+parser = "TyParser"
+order = 3
+warning_threshold = 0.9999
+error_threshold = 0.8
+run_in_target_env = true
+extra_deps = ["ty"]
+
+[python.bandit]
+command = "{python} -m bandit -r {scan_targets} -f json -q -s B101 --severity-level medium{exclude}"
+scan_exclude_names = [".venv", ".claude", "tests"]
+exclude_format = " --exclude {abs_native_path}"
+parser = "BanditParser"
+order = 4
+warning_threshold = 0.9999
+error_threshold = 0.8
+
+[python.pytest]
+command = "{python} -m pytest -vv \"{context_path}\" --ignore .claude{exclude}"
+exclude_format = " --ignore {path}"
+parser = "PytestParser"
+order = 5
+warning_threshold = 1.0
+error_threshold = 1.0
+run_in_target_env = true
+extra_deps = ["pytest"]
+skip_for_file = true
+cache_invariant = "ast"
+
+[python.coverage]
+command = "{python} -m coverage run --omit=*/tests/*,*/test_*.py -m pytest \"{context_path}\" --ignore .claude{exclude} && {python} -m coverage report --show-missing --omit=*/tests/*,*/test_*.py"
+exclude_format = " --ignore {path}"
+parser = "CoverageParser"
+order = 6
+warning_threshold = 0.9
+error_threshold = 0.5
+run_in_target_env = true
+extra_deps = ["coverage", "pytest"]
+skip_for_file = true
+skip_if = "pytest"
+cache_invariant = "ast"
+
+[python.vulture]
+command = "{python} -m vulture \"{context_path}\" --min-confidence 80 --exclude .venv,dist,.*_cache,docs,.git,.claude{exclude}"
+exclude_format = ",{path}"
+parser = "VultureParser"
+order = 7
+warning_threshold = 0.9999
+error_threshold = 0.8
+cache_invariant = "ast"
+
+[python.interrogate]
+command = "{python} -m interrogate \"{context_path}\" -e .claude{exclude} -v --fail-under 0"
+exclude_format = " -e {path}"
+parser = "InterrogateParser"
+order = 8
+warning_threshold = 0.8
+error_threshold = 0.5
+
+[python.interrogate.parser_config]
+skip_empty_init = true
+
+[python.radon-cc]
+command = "{python} -m radon cc --json --exclude '.claude/**' \"{context_path}\""
+parser = "ComplexityParser"
+order = 9
+gate_strict = false
+warning_threshold = 0.6
+error_threshold = 0.4
+
+[python.radon-mi]
+command = "{python} -m radon mi -s --json --exclude '.claude/**' \"{context_path}\""
+parser = "MaintainabilityParser"
+order = 10
+gate_strict = false
+warning_threshold = 0.6
+error_threshold = 0.4
+
+[python.radon-hal]
+command = "{python} -m radon hal -f --json --exclude '.claude/**' \"{context_path}\""
+parser = "HalsteadParser"
+order = 11
+gate_strict = false
+warning_threshold = 0.35
+error_threshold = 0.3
 ```
 
 ## Respect

{python_code_quality-0.2.2 → python_code_quality-0.3.0}/pyproject.toml

@@ -1,17 +1,15 @@
 [project]
 name = "python-code-quality"
-version = "0.2.2"
+version = "0.3.0"
 description = "Python Code Quality Analysis Tool - feed the results from 11 CQ tools straight into an LLM. Minimal tokens."
 readme = "README.md"
 requires-python = ">=3.12"
 license = "MIT"
-authors = [{name = "Chris Kilner", email = "chris@rhiza.fr"}]
 classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
 ]
-
 dependencies = [
     "bandit>=1.8.0",
     "coverage>=7.8.2",
@@ -22,43 +20,48 @@ dependencies = [
     "pytest-json-report>=1.5.0",
     "radon>=6.0.1",
     "rich>=14.0.0",
-    "ruff>=0.14.1",
+    "ruff>=0.14.1,<0.17",
     "tomlkit>=0.13.0",
     "ty>=0.0.17",
     "typer>=0.16.0",
     "vulture>=2.14",
 ]
 
+[[project.authors]]
+name = "Chris Kilner"
+email = "chris@rhiza.fr"
+
 [project.urls]
 Homepage = "https://github.com/rhiza-fr/py-cq"
 Repository = "https://github.com/rhiza-fr/py-cq"
 
+[project.scripts]
+cq = "py_cq.main:main"
+
 [build-system]
-requires = ["uv_build"]
+requires = ["uv_build>=0.12.0,<0.13.0"]
 build-backend = "uv_build"
 
 [tool.uv.build-backend]
 module-name = "py_cq"
 
-[project.scripts]
-cq = "py_cq.main:main"
-
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-norecursedirs = [".venv", "dist"]
-markers = [
-    "slow: tests that have real side effects (e.g. clearing disk cache)",
+norecursedirs = [
+    ".venv",
+    "dist",
 ]
+markers = ["slow: tests that have real side effects (e.g. clearing disk cache)"]
 addopts = "-m 'not slow'"
 
 [[tool.ty.overrides]]
 include = ["demo/**"]
-rules = {unresolved-import = "ignore"}
+
+[tool.ty.overrides.rules]
+unresolved-import = "ignore"
 
 [tool.cq]
 exclude = ["demo"]
 
 [dependency-groups]
-dev = [
-    "hypothesis>=6.151.10",
-]
+dev = ["hypothesis>=6.151.10"]

python_code_quality-0.3.0/pyproject.toml.orig

@@ -0,0 +1,71 @@
+[project]
+name = "python-code-quality"
+version = "0.3.0"
+description = "Python Code Quality Analysis Tool - feed the results from 11 CQ tools straight into an LLM. Minimal tokens."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [{name = "Chris Kilner", email = "chris@rhiza.fr"}]
+classifiers = [
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+    "bandit>=1.8.0",
+    "coverage>=7.8.2",
+    "diskcache>=5.6.3",
+    "interrogate>=1.7.0",
+    "pytest>=8.4.0",
+    "pytest-cov>=6.1.1",
+    "pytest-json-report>=1.5.0",
+    "radon>=6.0.1",
+    "rich>=14.0.0",
+    # Upper-capped: ruff's default rule set is not stable across minor versions
+    # (0.15 enabled ~60 rules, 0.16 enables 413). cq runs ruff from its own
+    # environment, so an unbounded bump silently changes every user's lint score.
+    # Raise this deliberately, with a changelog note.
+    "ruff>=0.14.1,<0.17",
+    "tomlkit>=0.13.0",
+    "ty>=0.0.17",
+    "typer>=0.16.0",
+    "vulture>=2.14",
+]
+
+[project.urls]
+Homepage = "https://github.com/rhiza-fr/py-cq"
+Repository = "https://github.com/rhiza-fr/py-cq"
+
+[build-system]
+# Upper-capped for the same reason as ruff: an unbounded backend requirement
+# lets a future breaking uv_build release break the sdist build with no change
+# here. Raise deliberately alongside the uv version this is built with.
+requires = ["uv_build>=0.12.0,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "py_cq"
+
+[project.scripts]
+cq = "py_cq.main:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+norecursedirs = [".venv", "dist"]
+markers = [
+    "slow: tests that have real side effects (e.g. clearing disk cache)",
+]
+addopts = "-m 'not slow'"
+
+[[tool.ty.overrides]]
+include = ["demo/**"]
+rules = {unresolved-import = "ignore"}
+
+[tool.cq]
+exclude = ["demo"]
+
+[dependency-groups]
+dev = [
+    "hypothesis>=6.151.10",
+]