python-code-quality 0.1.11__tar.gz → 0.1.14__tar.gz

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-code-quality
-Version: 0.1.11
+Version: 0.1.14
 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>
@@ -31,43 +31,19 @@ Description-Content-Type: text/markdown
 
 [![CI](https://img.shields.io/github/actions/workflow/status/rhiza-fr/py-cq/ci.yml?label=CI)](https://github.com/rhiza-fr/py-cq/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/rhiza-fr/py-cq/graph/badge.svg)](https://codecov.io/gh/rhiza-fr/py-cq)
-[![PyPI version](https://img.shields.io/pypi/v/python-code-quality)](https://pypi.org/project/python-code-quality/)
-[![Python versions](https://img.shields.io/pypi/pyversions/python-code-quality)](https://pypi.org/project/python-code-quality/)
+[![PyPI version](https://img.shields.io/pypi/v/python-code-quality?)](https://pypi.org/project/python-code-quality/)
+[![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)
 
-Feed the results from 11+ code quality tools to an LLM. Minimal tokens.
-
-Why? It removes the mental burden of understanding all these tools and parsing their results.
-
-The primary workflow is:
+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.
 
 ```bash
-# get the single most critical defect as markdown
-cq check . -o llm
-```
-
-```python
-`data/problems/travelling_salesman/ts_bad.py:21` — **F841**: Local variable `unused_variable` is assigned to but never used
-
-18:     min_dist = float("inf")
-19:     nearest_city = None
-20:     for city in cities:
-21:         unused_variable = 67
-22:         dist = calc_dist(current_city, city)
-23:         if dist < min_dist:
-24:             min_dist = dist
-25:             nearest_city = city
-
-Please fix only this issue. After fixing, run `cq check . -o llm` to verify.
-```
-Feed to an LLM with edit tools and repeat until there are no issues, e.g.
-
-```python
-cq check . -o llm | claude -p "fix this"
-# or
-cq check . -o llm | ollama run gpt-oss:20b "Explain how to fix this"
+cq check . -o llm     # top defect as markdown, pipe to an LLM
+cq check .            # table overview of all scores
+cq check . -o score   # numeric score only, exits 1 on errors (CI gate)
 ```
 
+![cq demo](demo/output/demo.gif)
 
 ## Install
 
@@ -112,6 +88,9 @@ cq check . -o score        # Numeric score only for CI
 cq check . -o json         # Detailed parsed JSON output for jq
 cq check . -o raw          # Raw tool output for debug
 cq check path/to/file.py   # Just one file (skips pytest and coverage)
+cq check . --only ruff,ty  # Run only specific tools
+cq check . --skip bandit   # Skip specific tools
+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 config path/to/project/ # Show effective tool configuration
@@ -131,10 +110,17 @@ Add a stop hook to your project's `.claude/settings.json` so Claude automaticall
 ```json
 {
   "hooks": {
-    "Stop": [{
-      "matcher": "",
-      "hooks": [{"type": "command", "command": "cq check . -o score && echo 'CQ: all clear' || cq check . -o llm"}]
-    }]
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cq check . -o score && echo 'CQ: all clear' || cq check . -o llm; true"
+          }
+        ]
+      }
+    ]
   }
 }
 ```
@@ -231,6 +217,16 @@ Then invoke it with `/cq-fix` in Claude Code. The `$(...)` embeds the live `cq`
 ]
 ```
 
+Both `json` and `raw` output pipe cleanly to `jq`:
+
+```bash
+# Get the coverage section
+cq check . -o raw | jq '.[] | select(.tool_name == "coverage")'
+
+# Get parsed coverage metrics only
+cq check . -o json | jq '.[] | select(.tool_name == "coverage") | .metrics'
+```
+
 ## Configuration
 
 Add a `[tool.cq]` section to your project's `pyproject.toml`:
@@ -240,6 +236,9 @@ Add a `[tool.cq]` section to your project's `pyproject.toml`:
 # Skip tools that are slow or not relevant to your project
 disable = ["coverage", "interrogate"]
 
+# Exclude paths from all tools (merged with --exclude CLI flag)
+exclude = ["demo", "docs"]
+
 # Lines of source context shown around each defect in LLM output (default: 15)
 context_lines = 15
 
@@ -258,21 +257,23 @@ Tool IDs match the keys in `config/config.yaml`: `compile`, `ruff`, `ty`, `bandi
 python:
 
   compile:
-    command: "{python} -m compileall -r 10 -j 8 {context_path} -x .*venv"
+    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}"
+    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}"
+    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
@@ -282,22 +283,26 @@ python:
       - 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"
+    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}"
+    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"
+    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
@@ -308,40 +313,41 @@ python:
       - pytest
 
   radon-cc:
-    command: "{python} -m radon cc --json {context_path}"
+    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}"
+    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}"
+    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"
+    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} -v --fail-under 0"
+    command: "{python} -m interrogate \"{context_path}\" -e tests{exclude} -v --fail-under 0"
+    exclude_format: " -e {path}"
     parser: "InterrogateParser"
     order: 11
     warning_threshold: 0.8
     error_threshold: 0.3
-
 ```
 
 ## Respect

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/README.md

@@ -2,43 +2,19 @@
 
 [![CI](https://img.shields.io/github/actions/workflow/status/rhiza-fr/py-cq/ci.yml?label=CI)](https://github.com/rhiza-fr/py-cq/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/rhiza-fr/py-cq/graph/badge.svg)](https://codecov.io/gh/rhiza-fr/py-cq)
-[![PyPI version](https://img.shields.io/pypi/v/python-code-quality)](https://pypi.org/project/python-code-quality/)
-[![Python versions](https://img.shields.io/pypi/pyversions/python-code-quality)](https://pypi.org/project/python-code-quality/)
+[![PyPI version](https://img.shields.io/pypi/v/python-code-quality?)](https://pypi.org/project/python-code-quality/)
+[![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)
 
-Feed the results from 11+ code quality tools to an LLM. Minimal tokens.
-
-Why? It removes the mental burden of understanding all these tools and parsing their results.
-
-The primary workflow is:
+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.
 
 ```bash
-# get the single most critical defect as markdown
-cq check . -o llm
-```
-
-```python
-`data/problems/travelling_salesman/ts_bad.py:21` — **F841**: Local variable `unused_variable` is assigned to but never used
-
-18:     min_dist = float("inf")
-19:     nearest_city = None
-20:     for city in cities:
-21:         unused_variable = 67
-22:         dist = calc_dist(current_city, city)
-23:         if dist < min_dist:
-24:             min_dist = dist
-25:             nearest_city = city
-
-Please fix only this issue. After fixing, run `cq check . -o llm` to verify.
-```
-Feed to an LLM with edit tools and repeat until there are no issues, e.g.
-
-```python
-cq check . -o llm | claude -p "fix this"
-# or
-cq check . -o llm | ollama run gpt-oss:20b "Explain how to fix this"
+cq check . -o llm     # top defect as markdown, pipe to an LLM
+cq check .            # table overview of all scores
+cq check . -o score   # numeric score only, exits 1 on errors (CI gate)
 ```
 
+![cq demo](demo/output/demo.gif)
 
 ## Install
 
@@ -83,6 +59,9 @@ cq check . -o score        # Numeric score only for CI
 cq check . -o json         # Detailed parsed JSON output for jq
 cq check . -o raw          # Raw tool output for debug
 cq check path/to/file.py   # Just one file (skips pytest and coverage)
+cq check . --only ruff,ty  # Run only specific tools
+cq check . --skip bandit   # Skip specific tools
+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 config path/to/project/ # Show effective tool configuration
@@ -102,10 +81,17 @@ Add a stop hook to your project's `.claude/settings.json` so Claude automaticall
 ```json
 {
   "hooks": {
-    "Stop": [{
-      "matcher": "",
-      "hooks": [{"type": "command", "command": "cq check . -o score && echo 'CQ: all clear' || cq check . -o llm"}]
-    }]
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cq check . -o score && echo 'CQ: all clear' || cq check . -o llm; true"
+          }
+        ]
+      }
+    ]
   }
 }
 ```
@@ -202,6 +188,16 @@ Then invoke it with `/cq-fix` in Claude Code. The `$(...)` embeds the live `cq`
 ]
 ```
 
+Both `json` and `raw` output pipe cleanly to `jq`:
+
+```bash
+# Get the coverage section
+cq check . -o raw | jq '.[] | select(.tool_name == "coverage")'
+
+# Get parsed coverage metrics only
+cq check . -o json | jq '.[] | select(.tool_name == "coverage") | .metrics'
+```
+
 ## Configuration
 
 Add a `[tool.cq]` section to your project's `pyproject.toml`:
@@ -211,6 +207,9 @@ Add a `[tool.cq]` section to your project's `pyproject.toml`:
 # Skip tools that are slow or not relevant to your project
 disable = ["coverage", "interrogate"]
 
+# Exclude paths from all tools (merged with --exclude CLI flag)
+exclude = ["demo", "docs"]
+
 # Lines of source context shown around each defect in LLM output (default: 15)
 context_lines = 15
 
@@ -229,21 +228,23 @@ Tool IDs match the keys in `config/config.yaml`: `compile`, `ruff`, `ty`, `bandi
 python:
 
   compile:
-    command: "{python} -m compileall -r 10 -j 8 {context_path} -x .*venv"
+    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}"
+    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}"
+    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
@@ -253,22 +254,26 @@ python:
       - 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"
+    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}"
+    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"
+    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
@@ -279,40 +284,41 @@ python:
       - pytest
 
   radon-cc:
-    command: "{python} -m radon cc --json {context_path}"
+    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}"
+    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}"
+    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"
+    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} -v --fail-under 0"
+    command: "{python} -m interrogate \"{context_path}\" -e tests{exclude} -v --fail-under 0"
+    exclude_format: " -e {path}"
     parser: "InterrogateParser"
     order: 11
     warning_threshold: 0.8
     error_threshold: 0.3
-
 ```
 
 ## Respect

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-code-quality"
-version = "0.1.11"
+version = "0.1.14"
 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"
@@ -42,3 +42,10 @@ module-name = "py_cq"
 
 [project.scripts]
 cq = "py_cq.main:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+norecursedirs = [".venv", "dist"]
+
+[tool.cq]
+exclude = ["demo"]

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/__init__.py

@@ -4,7 +4,3 @@ The module defines a single function, `hello`, which returns the string
 `'Hello from py_cq!'`. It can serve as a minimal example, placeholder, or
 testing stub in larger applications."""
 
-
-def hello() -> str:
-    """Returns the greeting string `'Hello from py_cq!'`."""
-    return "Hello from py_cq!"

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/cli.py

@@ -84,6 +84,7 @@ def _apply_user_config(base: dict[str, ToolConfig], user_cfg: dict) -> dict[str,
                 run_in_target_env=tool_data.get("run_in_target_env", False),
                 extra_deps=tool_data.get("extra_deps", []),
                 parser_config=tool_data.get("parser_config", {}),
+                exclude_format=tool_data.get("exclude_format", ""),
             )
         except KeyError as e:
             raise typer.BadParameter(f"[tool.cq.tools.{tool_id}] missing required field {e}")
@@ -125,6 +126,15 @@ def check(
     language: str | None = typer.Option(
         None, "--language", "-l", help="Override language detection (e.g. python, typescript, rust)"
     ),
+    only: str | None = typer.Option(
+        None, "--only", help="Comma-separated tool IDs to run (e.g. ruff,ty,pytest)"
+    ),
+    skip: str | None = typer.Option(
+        None, "--skip", help="Comma-separated tool IDs to skip (e.g. bandit,vulture)"
+    ),
+    exclude: str | None = typer.Option(
+        None, "--exclude", help="Comma-separated paths to exclude (e.g. demo,docs)"
+    ),
 ):
     """Feed the results from 11+ code quality tools to an LLM. Try: cq check . -o llm""" # --help
     path_obj = Path(path)
@@ -153,18 +163,27 @@ def check(
     user_cfg = load_user_config(path_obj)
     context_lines: int = int(user_cfg.get("context_lines", 15))
     effective_registry = _apply_user_config(tool_registry, user_cfg)
+    if only:
+        keep = set(only.split(","))
+        effective_registry = {k: v for k, v in effective_registry.items() if k in keep}
+    if skip:
+        drop = set(skip.split(","))
+        effective_registry = {k: v for k, v in effective_registry.items() if k not in drop}
+    config_excludes: list[str] = user_cfg.get("exclude", [])
+    cli_excludes: list[str] = [e.strip() for e in exclude.split(",")] if exclude else []
+    excludes = list(dict.fromkeys(config_excludes + cli_excludes))
     if clear_cache:
         tool_cache.clear()
-    tool_results = run_tools(effective_registry.values(), path, workers, early_exit=(output == OutputMode.LLM))
+    tool_results = run_tools(effective_registry.values(), path, workers, early_exit=(output == OutputMode.LLM), excludes=excludes)
     # for tr in tool_results:
     #     log.debug(json.dumps(tr.to_dict(), indent=2))
     combined_metrics = aggregate_metrics(path=path, metrics=tool_results)
     if output == OutputMode.SCORE:
         console.print(combined_metrics.score)
     elif output == OutputMode.JSON:
-        console.print(json.dumps([tr.to_dict() for tr in tool_results], indent=2))
+        print(json.dumps([tr.to_dict() for tr in tool_results], indent=2))
     elif output == OutputMode.RAW:
-        console.print(json.dumps([tr.raw.to_dict() for tr in tool_results], indent=2))
+        print(json.dumps([tr.raw.to_dict() for tr in tool_results], indent=2))
     elif output == OutputMode.LLM:
         # log.setLevel("CRITICAL")
         from py_cq.llm_formatter import format_for_llm

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/config/config.yaml

@@ -8,14 +8,16 @@ python:
     error_threshold: 0.9999
 
   ruff:
-    command: "{python} -m ruff check --output-format concise --no-cache \"{context_path}\""
+    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}\""
+    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
@@ -25,14 +27,16 @@ python:
       - 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\""
+    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}\""
+    command: "{python} -m pytest -v \"{context_path}\"{exclude}"
+    exclude_format: " --ignore {path}"
     parser: "PytestParser"
     order: 5
     warning_threshold: 1.0
@@ -74,14 +78,16 @@ python:
     error_threshold: 0.3
 
   vulture:
-    command: "{python} -m vulture \"{context_path}\" --min-confidence 80 --exclude .venv,dist,.*_cache,docs,.git"
+    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}\" -v --fail-under 0"
+    command: "{python} -m interrogate \"{context_path}\" -e tests{exclude} -v --fail-under 0"
+    exclude_format: " -e {path}"
     parser: "InterrogateParser"
     order: 11
     warning_threshold: 0.8

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/execution_engine.py

@@ -41,7 +41,29 @@ def _find_project_root(path: Path) -> Path | None:
     return None
 
 
-def run_tool(tool_config: ToolConfig, context_path: str) -> RawResult:
+def _dep_in_venv(dep: str, project_root: Path) -> bool:
+    """Return True if `dep` is installed in the project's .venv."""
+    venv = project_root / ".venv"
+    if not venv.exists():
+        return False
+    for subdir in ("Scripts", "bin"):
+        for suffix in ("", ".exe", ".cmd"):
+            if (venv / subdir / f"{dep}{suffix}").exists():
+                return True
+    return False
+
+
+def _build_exclude_str(exclude_format: str, excludes: list[str], **extra_vars: str) -> str:
+    if not exclude_format or not excludes:
+        return ""
+    parts = []
+    for exc in excludes:
+        abs_posix_path = Path(exc).resolve().as_posix()
+        parts.append(exclude_format.format(path=exc, abs_posix_path=abs_posix_path, **extra_vars))
+    return "".join(parts)
+
+
+def run_tool(tool_config: ToolConfig, context_path: str, excludes: list[str] | None = None) -> RawResult:
     """Runs a tool defined by its configuration and returns the execution result.
 
     Args:
@@ -60,7 +82,7 @@ def run_tool(tool_config: ToolConfig, context_path: str) -> RawResult:
         >>> result.return_code
         0"""
     python = sys.executable
-    path = context_path
+    path = str(Path(context_path))
     if tool_config.run_in_target_env:
         uv = shutil.which("uv")
         if uv:
@@ -72,11 +94,15 @@ def run_tool(tool_config: ToolConfig, context_path: str) -> RawResult:
                 project_root = _find_project_root(resolved)
                 abs_dir = str(project_root) if project_root else str(resolved.parent)
                 path = str(resolved)
-            with_flags = " ".join(f"--with {dep}" for dep in tool_config.extra_deps)
-            python = f'"{uv}" run --directory "{abs_dir}" {with_flags}'.rstrip()
+            project_root_path = Path(abs_dir)
+            missing_deps = [d for d in tool_config.extra_deps if not _dep_in_venv(d, project_root_path)]
+            with_flags = " ".join(f"--with {dep}" for dep in missing_deps)
+            no_sync = "--no-sync" if sys.executable.startswith(abs_dir) else ""
+            python = f'"{uv}" run {no_sync} --directory "{abs_dir}" {with_flags}'.strip()
     abs_context_path = str(Path(context_path).resolve())
     input_path_posix = Path(context_path).as_posix().rstrip("/")
-    command = tool_config.command.format(context_path=path, abs_context_path=abs_context_path, input_path_posix=input_path_posix, python=python)
+    exclude = _build_exclude_str(tool_config.exclude_format, excludes or [], input_path_posix=input_path_posix)
+    command = tool_config.command.format(context_path=path, abs_context_path=abs_context_path, input_path_posix=input_path_posix, python=python, exclude=exclude)
     cache_key = f"{command}:{get_context_hash(context_path)}"
     if cache_key in _cache:
         log.info(f"Cache hit: {command}")
@@ -96,7 +122,7 @@ def run_tool(tool_config: ToolConfig, context_path: str) -> RawResult:
     return raw_result
 
 
-def run_tools(tool_configs: Collection[ToolConfig], path: str, max_workers: int = 0, early_exit: bool = False) -> list[ToolResult]:
+def run_tools(tool_configs: Collection[ToolConfig], path: str, max_workers: int = 0, early_exit: bool = False, excludes: list[str] | None = None) -> list[ToolResult]:
     """Run multiple tools and return their parsed results.
 
     Runs each tool specified in *tool_configs* on the file or directory at
@@ -138,7 +164,7 @@ def run_tools(tool_configs: Collection[ToolConfig], path: str, max_workers: int
         >>> results = run_tools(configs, '/path/to/project', parallel=True)"""
     def _run_and_parse(tool_config: ToolConfig) -> tuple[int, ToolResult]:
         t0 = time.perf_counter()
-        raw_result = run_tool(tool_config, path)
+        raw_result = run_tool(tool_config, path, excludes)
         tr = tool_config.parser_class(tool_config.parser_config).parse(raw_result)
         tr.duration_s = time.perf_counter() - t0
         return tool_config.order, tr

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/localtypes.py

@@ -22,6 +22,7 @@ class ToolConfig:
     run_in_target_env: bool = False  # If True, run in target project's env via uv
     extra_deps: list[str] = field(default_factory=list)  # Extra deps to inject via uv --with
     parser_config: dict[str, Any] = field(default_factory=dict)
+    exclude_format: str = ""  # Per-path template for --exclude injection, e.g. " --exclude {path}"
 
 
 @dataclass

python_code_quality-0.1.14/src/py_cq/parsers/__init__.py

@@ -0,0 +1 @@
+"""Tool Response parsers"""

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/parsers/interrogateparser.py

@@ -3,8 +3,8 @@
 Interrogate is invoked with ``-v --fail-under 0``, producing a table of
 per-file docstring coverage on stdout::
 
-    | src/foo.py  |  5 |  2 |  60% |
-    | TOTAL       |  5 |  2 |  60% |
+    | src/foo.py  |  5 |  2 |  3 |  60% |
+    | TOTAL       |  5 |  2 |  3 |  60.0% |
 
 The parser extracts per-file coverage and the TOTAL row, storing the TOTAL
 as the ``doc_coverage`` metric (0.0–1.0).
@@ -14,7 +14,7 @@ import re
 
 from py_cq.localtypes import AbstractParser, RawResult, ToolResult
 
-_ROW_RE = re.compile(r"^\|\s+(.+?)\s+\|\s+(\d+)\s+\|\s+(\d+)\s+\|\s+(\d+)%\s+\|")
+_ROW_RE = re.compile(r"^\|\s+(.+?)\s+\|\s+(\d+)\s+\|\s+(\d+)\s+\|\s+\d+\s+\|\s+(\d+(?:\.\d+)?)%\s*\|")
 
 
 class InterrogateParser(AbstractParser):
@@ -30,7 +30,7 @@ class InterrogateParser(AbstractParser):
             name = m.group(1).strip()
             total = int(m.group(2))
             miss = int(m.group(3))
-            cover = int(m.group(4))
+            cover = float(m.group(4))
             if name == "TOTAL":
                 total_coverage = cover / 100.0
             elif total > 0:

{python_code_quality-0.1.11 → python_code_quality-0.1.14}/src/py_cq/tool_registry.py

@@ -30,6 +30,7 @@ def load_tool_configs() -> dict[str, ToolConfig]:
             run_in_target_env=tool_data.get("run_in_target_env", False),
             extra_deps=tool_data.get("extra_deps", []),
             parser_config=tool_data.get("parser_config", {}),
+            exclude_format=tool_data.get("exclude_format", ""),
         )
     return registry