python-code-quality 0.2.3__py3-none-any.whl → 0.3.1__py3-none-any.whl

{python_code_quality-0.2.3.dist-info → python_code_quality-0.3.1.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: python-code-quality
-Version: 0.2.3
-Summary: Python Code Quality Analysis Tool - feed the results from 11 CQ tools straight into an LLM. Minimal tokens.
+Version: 0.3.1
+Summary: Python Code Quality Analysis Tool - feed the results from 12 CQ tools straight into an LLM. Minimal tokens.
 Author: Chris Kilner
 Author-email: Chris Kilner <chris@rhiza.fr>
 License-Expression: MIT
@@ -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
@@ -35,7 +35,7 @@ Description-Content-Type: text/markdown
 [![Python versions](https://img.shields.io/pypi/pyversions/python-code-quality?)](https://pypi.org/project/python-code-quality/)
 [![License](https://img.shields.io/github/license/rhiza-fr/py-cq)](LICENSE)
 
-Run 11+ code quality tools, aggregate results into one score, and surface the single most critical defect as a focused markdown prompt — ready to pipe to any LLM.
+Run 12 code quality tools, aggregate results into one score, and surface the single most critical defect as a focused markdown prompt — ready to pipe to any LLM.
 
 This can dramatically reduce the amount of noise for LLMs (and humans) and remove the need for them to know about these tools.
 
@@ -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,12 @@ 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 |
+| 12 | ruff format | Formatting (fraction of files already formatted) |
 
 Diskcache is used to cache tool output for lightning fast re-runs. Sane defaults: <100 Mb, <5 days, No pickle risk.
 
@@ -99,7 +102,7 @@ cq check . --exclude demo  # Exclude paths from all tools
 cq check . --workers 1     # Run sequentially if you like things slow
 cq check . --clear-cache   # Clear cached results before running (rarely needed)
 cq check . -o llm --hint   # Append "run cq again to verify" (for human workflows)
-cq config path/to/project/ # Show effective tool configuration
+cq config --path path/to/project/ # Show effective tool configuration
 cq is-fixed <fingerprint>  # Check whether a specific issue has been resolved
 ```
 
@@ -248,14 +251,15 @@ Then invoke it with `/cq-fix` in Claude Code. The `$(...)` embeds the live `cq`
 │ bandit           │    0.56s │                  security │ 1.000   │ OK       │
 │ pytest           │    0.91s │                     tests │ 1.000   │ OK       │
 │ coverage         │    1.26s │                  coverage │ 0.910   │ OK       │
-│ radon cc         │    0.32s │                simplicity │ 0.982   │ OK       │
-│ radon mi         │    0.38s │           maintainability │ 0.869   │ OK       │
-│ radon hal        │    0.30s │             file_bug_free │ 0.928   │ OK       │
-│ radon hal        │          │            file_smallness │ 0.851   │ OK       │
-│ radon hal        │          │        functions_bug_free │ 0.913   │ OK       │
-│ radon hal        │          │       functions_smallness │ 0.724   │ OK       │
 │ vulture          │    0.32s │                 dead_code │ 1.000   │ OK       │
 │ interrogate      │    0.36s │              doc_coverage │ 1.000   │ OK       │
+│ radon-cc         │    0.32s │                simplicity │ 0.982   │ OK       │
+│ radon-mi         │    0.38s │           maintainability │ 0.869   │ OK       │
+│ radon-hal        │    0.30s │             file_bug_free │ 0.928   │ OK       │
+│ radon-hal        │          │            file_smallness │ 0.851   │ OK       │
+│ radon-hal        │          │        functions_bug_free │ 0.913   │ OK       │
+│ radon-hal        │          │       functions_smallness │ 0.724   │ OK       │
+│ ruff-format      │    0.12s │                 formatted │ 1.000   │ OK       │
 │                  │          │                     Score │ 0.965   │          │
 └──────────────────┴──────────┴───────────────────────────┴─────────┴──────────┘
 ```
@@ -337,106 +341,126 @@ 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`, `ruff-format`.
 
 
 ### 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
+
+[python.ruff-format]
+command = "{python} -m ruff format --check --output-format concise --no-cache \"{context_path}\" --exclude .claude --config \"include=['*.py','*.pyi','*.ipynb']\"{exclude}"
+exclude_format = " --exclude {path}"
+parser = "RuffFormatParser"
+order = 12
+gate_strict = false
+warning_threshold = 0.9999
+error_threshold = 0.5
 ```
 
 ## Respect

{python_code_quality-0.2.3.dist-info → python_code_quality-0.3.1.dist-info}/RECORD

@@ -1,35 +1,37 @@
 py_cq/__init__.py,sha256=-C6_QzQeydxft3ndlExTgWnvlqH8fJNPJxfySXULQmU,56
-py_cq/api.py,sha256=AxhTQVX4ACZmgCpdfJgB2_1VXtClxc531NkRoLK1vA0,10118
-py_cq/cli.py,sha256=pP7lKoGE_cW9AGXEfDQMcfpb7inAtn6LJ0-cv0t5ONo,13784
+py_cq/api.py,sha256=u0ajk6ZYWFGjSsLYkRfUBBtL_Vw0HHZbWpa1AM79y8Y,10172
+py_cq/cli.py,sha256=zciffdqyz_TXO8xfTlItWBS8s8eFGhG7Iv0I2M9eBK4,13827
 py_cq/config/__init__.py,sha256=f0wc51O_3kGDTZUnCbGv8_zWnC5yYGl4NWcf2buSImQ,670
-py_cq/config/config.toml,sha256=1-S9e5WK6K19FC1_SaGI5dfePuSwCufH0CssZPfIZgE,2921
-py_cq/context_hash.py,sha256=qYPMacgSEwy0nYLCBW8JllNWsGfaSjVq31EFI811ZcU,3449
-py_cq/execution_engine.py,sha256=ap3tDMxVD9x4bq_leq7IGYZgLM-ryJRnrVFSxSy5jK0,16893
+py_cq/config/config.toml,sha256=TnUzP2cKKsyfN9GbnGeveBnqKTQl_PEYggOrpqBPg3s,3357
+py_cq/context_hash.py,sha256=uKMkN394v6QYMukZj9usbxnq8px3i1khyIRPKwe09DE,5614
+py_cq/execution_engine.py,sha256=nuW-N8X1ZmtxzkohFxxYvVPBrBIR2TPExMsPQCTAZ6A,20865
 py_cq/language_detector.py,sha256=rh5bAA3LyCQR3RODmx_EalqRNYvSYK2SJzh2hIkxOUo,1139
 py_cq/llm_formatter.py,sha256=nCV3nFdxJAi2CnH9FKb5tB-0w-yjLWmjywQI5GJ2cSU,8412
-py_cq/localtypes.py,sha256=kHldvTJlwyoWg0xKbOL-jplLqwKnGmv6aRh95iq8r8Q,7783
+py_cq/localtypes.py,sha256=_g6RpV-JS6T0lD_Uqq4iA5e2Fw6RM56Lqrv_GiP4gm8,7907
 py_cq/main.py,sha256=5dgr8Zk1LNK5M-0wncYVksBp0qE-jWZYqmOXfb1eOhk,400
 py_cq/metric_aggregator.py,sha256=M2ymo62S7p7qPUqjjoiPg4IVyXQhLMuTr9-jxLiFjCY,853
 py_cq/parsers/__init__.py,sha256=uCy7R0cnvDPNvB5aWMLgM3FB9nDcu1jwUmznFMRROSY,28
 py_cq/parsers/banditparser.py,sha256=YqpWljU5D4IhLdtzat7XVGBm9NXrbOQbr9LI9NKybK8,3298
-py_cq/parsers/common.py,sha256=csIv0M7Xq68HjXn37OAD2RfMmoQWaChQ9Jf9lamMkvg,13890
+py_cq/parsers/common.py,sha256=ViYneYOG4RTlbHbSU4GN9kB_M1gikukiwQ81CTajAqA,13796
 py_cq/parsers/compileparser.py,sha256=jl0DloyXTKqVHRIUft-t5lvJOndY-PdLPrXB38v9zuA,6927
 py_cq/parsers/complexityparser.py,sha256=mX1WHPRgBBc6kOqHfubowRbYXY0E1k4JVwr908Cj10U,5582
-py_cq/parsers/coverageparser.py,sha256=9HtXyAMcQbhsUTb1VNClIHQajBwqCt26H-25t2ZQnY4,8092
+py_cq/parsers/coverageparser.py,sha256=QGjZ8JJF0G-0uiZ07BzxSnblGiysHtOwq0SYvWrtOhA,7441
 py_cq/parsers/exitcodeparser.py,sha256=b4LWIwwklPwCX3MnqNsGQC1slQU56DKE05vJ0OdWVoA,957
 py_cq/parsers/halsteadparser.py,sha256=789c_WWfomskM4i7SUEbKvB67-F2y5nfqt48aFXOusY,10192
-py_cq/parsers/interrogateparser.py,sha256=cc5Q4mOQlLUIPl3XUyH29QJ_JMBzAA7SiPAAiNGDJdM,11546
+py_cq/parsers/interrogateparser.py,sha256=KDqXTdnJ5JzWhN4ziRda90nZCQOJaKn3CCiq4Rh0IRw,11314
 py_cq/parsers/linecountparser.py,sha256=-hqebwG4j7_QugzGLUUQRcPukGHicV2nbIp1pR8ZcAw,1310
 py_cq/parsers/maintainabilityparser.py,sha256=3a4m93XNtUurw3IxEI1Iae9idgJY6qiEt7HMYl1wTu0,4793
-py_cq/parsers/pytestparser.py,sha256=rhzFzsBEXv1xloOuEjQyBn8Vp0AyGoq2t5siyAwWWaA,11549
+py_cq/parsers/pytestparser.py,sha256=cIaTs2XxgeJlVragLEVTZcrbB-bzfNYYMdUrakRa-rQ,11545
 py_cq/parsers/regexcountparser.py,sha256=zGzHEYDIori6aiWnVkRFixdE7fWt66npAAWjzvpoBF4,1592
+py_cq/parsers/ruffformatparser.py,sha256=UXff5Qwh9i0goiSTJ_AaaIsmMSssUjNY2O_dERXjsFw,2636
 py_cq/parsers/ruffparser.py,sha256=uE0QEaZ4Ch7IsWY_2ZkfHXPU0TYPGsGPfv66hGe5G34,7634
 py_cq/parsers/typarser.py,sha256=x835OrapG1aUteW2NhC5U0bhj1w1pMtbfmbvb74-1AI,8077
 py_cq/parsers/vultureparser.py,sha256=-yGAXzRY4_fzLRTk7dfwDrrRZ-n97j1Ph5_xo3c6TfU,2229
 py_cq/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-py_cq/table_formatter.py,sha256=2_WZ2RHCwsdna0bzP6ZFxB2YtHtW95wxJB1yBXgCIDo,1610
-py_cq/tool_registry.py,sha256=8B6EG7mGCKR6JeHtesFHa79svNfj1PUbboysXfwV7vY,1828
-python_code_quality-0.2.3.dist-info/WHEEL,sha256=wXwAVsgVaOZ_pwDFqQm5Rd6PID-Fc74nkLc8X8gHiDo,81
-python_code_quality-0.2.3.dist-info/entry_points.txt,sha256=cfWbTw7eYO6Trv1-Z_odL6Zta9CqYU6Vk9lAHdfB60Q,40
-python_code_quality-0.2.3.dist-info/METADATA,sha256=dBNJKPiG5BRMtuPT8jUcYMoasGRsP4uQQG9RvFy_xig,15650
-python_code_quality-0.2.3.dist-info/RECORD,,
+py_cq/source_file.py,sha256=Uyv-CSVeliFnE6TpRB4Y15ykFQs4n0r9-amzxXXlqN0,7562
+py_cq/table_formatter.py,sha256=-22nzVIOaDe3QOBmZ2iBPH7ewIEIPEn5WYSjCoB4Hj4,1608
+py_cq/tool_registry.py,sha256=0s0sD9_iQW-HU0SIKSS8CFDlrzW0c-vlYrAFODEHiSc,1894
+python_code_quality-0.3.1.dist-info/WHEEL,sha256=xTCBFIZIIyRSxyowOv5Wqg_jFU6KsdIffuulBB09Ph8,80
+python_code_quality-0.3.1.dist-info/entry_points.txt,sha256=cfWbTw7eYO6Trv1-Z_odL6Zta9CqYU6Vk9lAHdfB60Q,40
+python_code_quality-0.3.1.dist-info/METADATA,sha256=E3HJ8qZESv7gyGqBQrSiQeeyDTyFYe9v7cm6Kt8x8_8,16739
+python_code_quality-0.3.1.dist-info/RECORD,,

{python_code_quality-0.2.3.dist-info → python_code_quality-0.3.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.11.19
+Generator: uv 0.13.0
 Root-Is-Purelib: true
 Tag: py3-none-any