mentistest-coverage 0.2.2__py3-none-any.whl

mentistest_coverage-0.2.2.dist-info/METADATA

@@ -0,0 +1,310 @@
+Metadata-Version: 2.4
+Name: mentistest-coverage
+Version: 0.2.2
+Summary: Analyze test strategy across SaaS products with coverage metrics
+Author-email: Harry Trott <harrydtrott@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Harry Trott
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/HarryDouglas/test_coverage_tool
+Project-URL: Repository, https://github.com/HarryDouglas/test_coverage_tool.git
+Project-URL: Bug Tracker, https://github.com/HarryDouglas/test_coverage_tool/issues
+Keywords: test-coverage,coverage-metrics,saas
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic<3,>=2.0
+Requires-Dist: fastapi<1,>=0.104
+Requires-Dist: uvicorn<1,>=0.24
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: jsonschema<5,>=4.0
+Requires-Dist: jinja2<4,>=3.1
+Requires-Dist: typer<1,>=0.9
+Requires-Dist: anthropic<1,>=0.40
+Requires-Dist: httpx<1,>=0.25
+Requires-Dist: slowapi<1,>=0.1.9
+Requires-Dist: tomli<3,>=2.0; python_version < "3.11"
+Provides-Extra: test
+Requires-Dist: pytest~=9.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21; extra == "test"
+Requires-Dist: allure-pytest~=2.15; extra == "test"
+Requires-Dist: packaging>=21.0; extra == "test"
+Requires-Dist: hypothesis<7,>=6.0; extra == "test"
+Provides-Extra: coverage
+Requires-Dist: coverage>=5.0; extra == "coverage"
+Provides-Extra: types
+Requires-Dist: types-PyYAML>=6.0; extra == "types"
+Provides-Extra: code-checks
+Requires-Dist: black==25.1.0; extra == "code-checks"
+Requires-Dist: mypy==1.16.1; extra == "code-checks"
+Requires-Dist: pydocstyle==6.3.0; extra == "code-checks"
+Requires-Dist: pylint==3.3.7; extra == "code-checks"
+Requires-Dist: ruff>=0.1.0; extra == "code-checks"
+Provides-Extra: docs
+Requires-Dist: sphinx~=8.1; extra == "docs"
+Requires-Dist: sphinx-breeze-theme; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
+Requires-Dist: sphinx-book-theme; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: invoke~=2.2; extra == "dev"
+Requires-Dist: changelog-cli; extra == "dev"
+Requires-Dist: cruft; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: pre-commit~=4.0; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Provides-Extra: logging-json
+Requires-Dist: python-json-logger<4,>=2.0; extra == "logging-json"
+Provides-Extra: metrics
+Requires-Dist: prometheus-client<1,>=0.20; extra == "metrics"
+Provides-Extra: all
+Requires-Dist: invoke~=2.2; extra == "all"
+Requires-Dist: setuptools; extra == "all"
+Requires-Dist: build; extra == "all"
+Dynamic: license-file
+
+# mentistest-coverage
+
+Strategic test-suite analyser. Looks at a Python project's source tree, test
+tree, JUnit XML and (optionally) an OpenAPI spec, and produces a *test-strategy*
+report — not just a coverage percentage.
+
+What it does that `coverage.py` doesn't:
+
+- Classifies every test as **unit / integration / contract / e2e** using markers,
+  imports, fixtures and directory layout.
+- Weights coverage gaps by **cyclomatic complexity and call-graph depth** so the
+  20 functions that matter rank above the 200 that don't.
+- Correlates tests against the **OpenAPI spec** to flag uncovered endpoints.
+- Tracks results over time in a local SQLite **history store** with full git/CI
+  provenance, and renders a **trend dashboard** per project.
+- Detects **regressions** between snapshots and can fail CI when a previously-
+  covered symbol loses coverage.
+- Ships an opt-in **AI second opinion** (Claude Haiku → Sonnet escalation, gated
+  to skip healthy projects — typical cost <£0.01/run).
+- Exports HTML (interactive), JSON (machine-readable) and PDF (board-ready) reports.
+- Ships a first-class **GitHub Action** that posts a coverage-delta PR comment
+  and uploads artifacts.
+
+Local-first. The analyser runs against filesystem paths; source code is never
+uploaded anywhere. The optional AI call sends a structured summary (file paths,
+coverage numbers, test names) — never the source itself.
+
+## Install
+
+```bash
+pip install mentistest-coverage
+```
+
+…or from a clone:
+
+```bash
+pip install -e .
+```
+
+Verify:
+
+```bash
+mentistest --help
+```
+
+Every PyPI release is built via OIDC trusted publishing and signed
+with Sigstore — see [RELEASING.md](RELEASING.md) for the full chain
+and verification recipe.
+
+## Quick start
+
+A complete analysis with all the features wired in:
+
+```bash
+mentistest analyze my-service \
+    --source ./src --tests ./tests \
+    --junit ./reports/junit.xml \
+    --api-spec ./openapi.yaml \
+    --output-json ./report.json \
+    --output-html ./report.html \
+    --output-pdf  ./report.pdf \
+    --track --compare-baseline --fail-on-regression \
+    --detect-git \
+    --ai
+```
+
+What that does:
+
+| Flag                        | Effect |
+| --------------------------- | ------ |
+| `--source / -s`             | Source directory (repeatable) |
+| `--tests / -t`              | Test directory (repeatable) |
+| `--junit`                   | JUnit XML report path (repeatable) |
+| `--api-spec`                | OpenAPI / Swagger spec — drives endpoint-coverage analysis |
+| `--coverage-xml`            | Real coverage.xml from coverage.py (preferred over the fallback) |
+| `--output-json / -j`        | JSON report path |
+| `--output-html / -H`        | Interactive HTML dashboard path |
+| `--output-pdf  / -P`        | Board-ready PDF report path |
+| `--track / --no-track`      | Save the run as a snapshot in the history DB |
+| `--db-path`                 | Override `~/.test-coverage/history.db` |
+| `--compare-baseline`        | Diff this run against the most recent snapshot |
+| `--regression-threshold N`  | Allowable coverage drop in pp (default 0) |
+| `--fail-on-regression`      | `exit 1` if a regression is detected |
+| `--detect-git / --no-detect-git` | Capture commit, branch, CI run ID, provider |
+| `--ai`                      | Run the optional AI commentary (requires `ANTHROPIC_API_KEY`) |
+| `--test-type`               | Default type label when no signal fires (`unit`/`integration`/`contract`/`e2e`) |
+| `--verbose / -v`            | Debug logging |
+
+## Server mode
+
+```bash
+mentistest serve --host 0.0.0.0 --port 8000
+```
+
+Because the `/analyze` endpoint reads arbitrary filesystem paths, `serve`
+**refuses to bind a non-loopback host** (anything other than `127.0.0.1`/
+`::1`/`localhost`) unless `TEST_COVERAGE_API_KEY` or
+`TEST_COVERAGE_ALLOWED_PATHS` is configured. Pass `--insecure` to override
+on a trusted private network. The published Docker image binds `0.0.0.0` and
+sets `TEST_COVERAGE_REQUIRE_SECURITY=1`, so the container likewise won't
+start unprotected.
+
+Then:
+
+- `http://localhost:8000/docs` — interactive OpenAPI docs for the REST API
+- `http://localhost:8000/benchmarks` — multi-project benchmark dashboard
+- `http://localhost:8000/trends/<project>` — single-project trend dashboard
+- `http://localhost:8000/report/html?project_name=<name>` — last-rendered report
+- `http://localhost:8000/report/pdf?project_name=<name>` — last-rendered PDF
+- `http://localhost:8000/history/<project>` — JSON list of snapshots
+- `http://localhost:8000/regression/<project>` — JSON regression diff
+
+## GitHub Action
+
+```yaml
+- uses: HarryDouglas/test_coverage_tool@v1
+  with:
+    source_dirs: src
+    test_dirs: tests
+    junit_xml_paths: reports/junit.xml
+    track_history: 'true'
+    fail_on_regression: 'true'
+```
+
+Posts a PR comment with the coverage delta, uploads JSON + HTML reports as
+workflow artifacts, and fails the check if a symbol loses coverage. See
+`action.yml` for all inputs.
+
+**Action vs PyPI wheel:** the action is its own distribution channel —
+referenced by git tag, not installed from PyPI. Under the hood it
+installs the wheel from PyPI and runs the CLI, so the two move
+together but version independently. The action's `@v1` tag pins a
+major; minor / patch wheel updates roll through without a workflow
+change.
+
+## Security
+
+If you're deploying the HTTP API beyond `localhost`, read
+[SECURITY.md](SECURITY.md). Two env vars (`TEST_COVERAGE_API_KEY` and
+`TEST_COVERAGE_ALLOWED_PATHS`) enable bearer-token auth and
+filesystem path-traversal protection. Both are off by default so local,
+loopback-only use is unaffected — but the tool **fails closed** the moment
+it would be network-reachable: `serve` rejects a non-loopback `--host`
+(unless `--insecure`), and `create_app` refuses to start when
+`TEST_COVERAGE_REQUIRE_SECURITY=1` (set in the Docker image) is configured
+without a protection layer.
+
+To report a vulnerability, email **harrydtrott@gmail.com** — don't
+open a public issue.
+
+## Public benchmark suite
+
+The tool ships with a 16+ repo OSS benchmark suite (flask, fastapi, pydantic,
+httpx, celery, mlflow, attrs, rich, schemathesis, dbt-core, alembic, …) used
+both as a smoke test and as a demo gallery for the consulting site.
+
+```bash
+make benchmark        # clone, test, analyse, render all projects
+make benchmark-serve  # serve the rendered dashboard at localhost:8003/benchmarks
+```
+
+Outputs land in `reports/benchmarks/<project>/` (HTML + JSON) and are
+git-ignored. Re-run after any classifier change to verify the public pyramid
+still looks sensible.
+
+## Library use
+
+```python
+from pathlib import Path
+from test_coverage_tool.core.analyzer import AnalysisEngine
+from test_coverage_tool.core.git import detect_git_metadata
+from test_coverage_tool.reports.html_generator import HTMLReportGenerator
+from test_coverage_tool.reports.json_generator import JSONReportGenerator
+from test_coverage_tool.history.store import HistoryStore
+
+engine   = AnalysisEngine()
+analysis = engine.analyze(
+    project_name     = "my-service",
+    source_dirs      = [Path("src")],
+    test_dirs        = [Path("tests")],
+    junit_xml_paths  = [Path("reports/junit.xml")],
+    api_spec_path    = Path("openapi.yaml"),
+    git_metadata     = detect_git_metadata(),
+)
+JSONReportGenerator().write(analysis, Path("report.json"))
+HTMLReportGenerator().write(analysis, Path("report.html"))
+
+# Persist a snapshot
+HistoryStore(Path("history.db")).save("my-service", analysis_to_dict(analysis))
+```
+
+## Configuration
+
+Environment variables:
+
+| Variable                   | Purpose |
+| -------------------------- | ------- |
+| `ANTHROPIC_API_KEY`        | Enables `--ai` (otherwise the flag is a no-op) |
+| `TEST_COVERAGE_DB_PATH`    | Override the default `~/.test-coverage/history.db` location |
+| `MENTIS_BENCH_AI`          | Set to `1` to opt-in to AI commentary on `make benchmark` |
+
+## Development
+
+```bash
+make install     # install dev deps via uv
+make test        # pytest --cov on unittests/
+make lint        # ruff + mypy --strict + pylint
+make benchmark   # rebuild the public benchmark dashboard
+```
+
+The repo uses ruff, mypy (`--strict`), pylint and pytest. The quality bar:
+zero ruff/mypy/pylint issues, pytest -x -q must pass before merge.
+
+## License
+
+MIT — see `LICENSE`.

mentistest_coverage-0.2.2.dist-info/RECORD

@@ -0,0 +1,88 @@
+mentistest_coverage-0.2.2.dist-info/licenses/LICENSE,sha256=ue2igMlCJVgRuvDVcCeAeFtyfFN6FH8u8qFRxPAyP_k,1068
+test_coverage_tool/__init__.py,sha256=-m4RMW_s4COWKRM7VkdGITkyPUnh7QEJfcF1Bicq32I,404
+test_coverage_tool/_logging.py,sha256=zuhZk2j41IJxme7x40IklKojvIa8qL-ld_FIFHDWQLQ,960
+test_coverage_tool/_version.py,sha256=ywc2091SFrYn1uCe8vq8F2ODfUKv17MyplDPnGr97SI,65
+test_coverage_tool/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+test_coverage_tool/ai/__init__.py,sha256=dFKFg3AewYtbW49shxSrKAhTAzYtMgV1YJuhWyz0zqg,227
+test_coverage_tool/ai/_scrub.py,sha256=fHFOAxMt5RYXGcEd3UVnbyUfYaXeiQH77DMXOEQQhjk,3119
+test_coverage_tool/ai/analyzer.py,sha256=sNzkxJlJglGxec1X4mwprNmJUA1Hx2NRyf1rVreMFY0,16916
+test_coverage_tool/ai/budget.py,sha256=ecUNL93LB0rg5nF_4mrw6Un5e_47BClwKqOzel7TzIs,6035
+test_coverage_tool/ai/config.py,sha256=wP1ZNk-6krGZni-2thg-f1_HCq8zjZllgkYkpXfTRkM,3651
+test_coverage_tool/api/__init__.py,sha256=Eu4mDp_Z1rLmCEfuoNFXXqDT0oCDFq_cZNH34A30GbQ,171
+test_coverage_tool/api/_logging_middleware.py,sha256=Hlgs1lGV5uQrmL18Pf13MiB2OThSX1Xdsfj-BDFULqM,8102
+test_coverage_tool/api/_metrics.py,sha256=I26ZyIeghzyqi6OilHZTFJoRFI-GrGhF8DecbgMhGPE,4268
+test_coverage_tool/api/_security.py,sha256=E8ILaZ22Fr3Z13cU5-m7UJLLYSlkaiMj9TtW5b17cOM,10704
+test_coverage_tool/api/models.py,sha256=4oY0z5fUqFHVgfwDMnnyfCF856mtOXvPKf5N4eElfHw,4085
+test_coverage_tool/api/routes.py,sha256=5Vg5pYakkGRTvq2nn_6NbiivCIAEMB2_FKYaFthaZEs,25438
+test_coverage_tool/benchmarks/__init__.py,sha256=yWL1hQpDSK-b3o6CLW61Tb34npMuB2k7Yqzg1wpZpOY,214
+test_coverage_tool/benchmarks/dashboard.py,sha256=wakP7fdzmWi1Aoh4uimzY4gE_XoGcgvbrK8p30XIQfA,25113
+test_coverage_tool/benchmarks/store.py,sha256=a8wp_Wv6mo44BEgFw9Lzq-NmoYO7jLDMkWWxvI6kL14,22992
+test_coverage_tool/benchmarks/_templates/compare.html.jinja,sha256=MW_kiKczVdO7D-kan1qwQtHW9tYbZQBz9Ir6ZzKo6HA,8689
+test_coverage_tool/benchmarks/_templates/dashboard.html.jinja,sha256=ybZ7Mm-HRBtS67ahiPbVu-AsDvFkPFHXcYsKcStMGNU,43424
+test_coverage_tool/cli/__init__.py,sha256=trSKqZZ_WggkWo0g60hP5PGd1W5e1DYp4Ivy_jeaAtk,157
+test_coverage_tool/cli/main.py,sha256=yH2NjI8N2hy9GOeFJCiEDxRl9-ReHr4KXDD_8Kl4wgE,25250
+test_coverage_tool/core/__init__.py,sha256=rC0xs9hmW-s5bFFFrsUUgCuvsl6vB1WP2_xUOIcWUSM,460
+test_coverage_tool/core/analyzer.py,sha256=p7uVXyMTyTLiOh5nTM6_53IQuo8x6zXDh2qmPdjAGLg,47053
+test_coverage_tool/core/call_graph.py,sha256=6XHqvaVCehqXDQnYmdhZyX3TyHlF7v2IzcEAc28brF0,7641
+test_coverage_tool/core/classifier.py,sha256=13rrpHQjeodkH83CIFLvYgVuJyTuKK_6FU_qt555aPA,39267
+test_coverage_tool/core/classifier_facts.py,sha256=ZRE7MuOHjehHeCgZ0ZP6epKMF9EV6CO03HXy8__97P4,25572
+test_coverage_tool/core/classifier_validation.py,sha256=q1MNGp7JYyXGCFc8rJFh4r9T8EydDJ2KiuCd62IXmgw,13661
+test_coverage_tool/core/contract_coverage.py,sha256=nc2evASI_TpAsqp6GiBKZbnF042cXiEFiBsXf5zaPyI,3473
+test_coverage_tool/core/diff_coverage.py,sha256=JuVNG6hqvAUMg9TQadjQ7FznXNEos-g6re9Q47c8FkA,8032
+test_coverage_tool/core/endpoint_attribution.py,sha256=n_nxHpC-7nXib5x_qco_ykzGVgVfez0xsTPzb1Gqv20,10516
+test_coverage_tool/core/endpoint_correlation.py,sha256=XBtAt60ltzoxryP1b2CWHCwaZgtCce_x6vJx3eqTWJM,12530
+test_coverage_tool/core/fixture_resolver.py,sha256=XE6wfSJTbBrAB-bOQiehmJe6EEUS57qzgnUJo-dvbdQ,10185
+test_coverage_tool/core/git.py,sha256=vFi2P889Cy90Q25KLzjDHvLYunE2G-uhIT92ta_kjj8,6314
+test_coverage_tool/core/imports.py,sha256=8y0gvxGCdy7wwO02VfbxxLj-mHgKLXa5nCLe5BEkaes,3144
+test_coverage_tool/core/javascript_classifier.py,sha256=ShAlAFKvzcaHs9qmMDp9iMI3ngtvpVgAU6U9NvN1mpo,9236
+test_coverage_tool/core/marker_config.py,sha256=pBxvsIPqbFS2Fs3xR1ShHXmcc84GIA14gQZxIy9J3ck,8349
+test_coverage_tool/core/metrics.py,sha256=3j7Od-PGXQD_2MWc63I36Phld6gMP-mV2HjmbvDSDQo,12587
+test_coverage_tool/core/reclassify.py,sha256=2iYPusMYQNLOMApI5K5qQtjD9cmsqfHBewp8_sqmRnU,19703
+test_coverage_tool/core/regression.py,sha256=bZ6wrUJvwEOHMEnurOVNe31tu9nXUg8dmk6EkHNSawg,6680
+test_coverage_tool/core/symbol_table.py,sha256=jOBguPK_2G_IGN2TZJj0rSuhABlPYzZYK5cmM8ixWtc,12645
+test_coverage_tool/core/test_type.py,sha256=3mgyUiTy3MpDO5X6M5khf_AGLpXMQBOdDuZw4gHGOzc,1769
+test_coverage_tool/core/timing.py,sha256=SylM6fEALJRJgZ5B0AlXMXuZZgsfcBxJeLbGynLQ7vY,7761
+test_coverage_tool/core/types.py,sha256=zKhdFDRPPWDOk_yWjjs_4Dwdo-Abfrdgdv_gGTS7HGg,43185
+test_coverage_tool/core/endpoint_extractors/__init__.py,sha256=DzMFWEF3r5egLNvkjqXyqkHFl670OLtn83kilMA74Vw,1698
+test_coverage_tool/core/endpoint_extractors/class_views.py,sha256=0DLltKePljdu4VpXwgEf8m2dfMXrveXtF7Sv6gkdZOg,16329
+test_coverage_tool/core/endpoint_extractors/cross_check.py,sha256=YaQboLENT0vjtehbDXePg_NZbpcYPSg0ZLVv5qGrbFE,7431
+test_coverage_tool/core/endpoint_extractors/inbound.py,sha256=WLtd7e4K_aMwEO3PdJFg0zPldLK27BZuGrv_wt1VytE,13932
+test_coverage_tool/core/endpoint_extractors/javascript.py,sha256=rbXbQgPzddQq6M7ZhfvNengQ4f9Ay0SF1Jbj36I50Yk,12603
+test_coverage_tool/core/endpoint_extractors/mock_libs.py,sha256=-AttDobCk3MXqHfSwWpF-quuPK0oOGWB3cUIuWfTK94,6018
+test_coverage_tool/core/endpoint_extractors/outbound.py,sha256=XHoEUVQqSNzUwrfb8Nm7dQ2EdaeDdtQDvJ1Uobve4_o,15600
+test_coverage_tool/core/endpoint_extractors/overrides.py,sha256=8fGy6qb3UmveeNe0kc_oQrEnVHPHBRR9t0I6N1vxtII,7520
+test_coverage_tool/core/endpoint_extractors/wrappers.py,sha256=cTk0RtaFKSveYRRjggRblG29_jQEG24HA3uYAFNc-HE,5854
+test_coverage_tool/history/__init__.py,sha256=57IVjW0AD4KGSYg-SQf6PXEh9_UkMTcdgHXMFBsXfA0,145
+test_coverage_tool/history/backfill.py,sha256=-QjCgnk5vfHn6P8CKcvro-BZmiZue7XeXhiFvKTLjAI,12256
+test_coverage_tool/history/comparison.py,sha256=N7iaoN3eDTkihBPfmTdstvim5ABEHmkXbzLCLEqMnOo,10301
+test_coverage_tool/history/comparison_dashboard.py,sha256=WOchsyj6Fvl-U0965Jjj0FuDqPY2oIkoKkx9q-Ourg4,11656
+test_coverage_tool/history/dashboard.py,sha256=cUHbRUUznD77Ykg0TElfJHG5IY6wn7rw4U2S9y4PgWY,28775
+test_coverage_tool/history/store.py,sha256=XrWNU8leGuLj4jcU8yLz10j-3VNhJ9uB39qIThzbGRU,21791
+test_coverage_tool/parsers/__init__.py,sha256=u1vbWuvsax5bMYtkb9MZm892ESO7oAgmSAyByNok7gs,377
+test_coverage_tool/parsers/_constants.py,sha256=v7dYrJdbS3izEc4-Wu4fxzagBlsrA6lk5nJQ2WskPxQ,281
+test_coverage_tool/parsers/code_parser.py,sha256=w-kpUZfG1XxxKHsTyNJLC3ngYYwFwAaWdyciyI-JgOY,6844
+test_coverage_tool/parsers/coverage_contexts.py,sha256=hY3fPIy0DCAsZcWARRxQZXBYtJS24ccVnv7jzlNfaIo,5981
+test_coverage_tool/parsers/coverage_parser.py,sha256=FRvmIHpO9wE4It0pVA6QYdYYBrYn-BCthaxUixQxBiE,6086
+test_coverage_tool/parsers/cypress_parser.py,sha256=RCwI_9nIVRKD-Fzq-VLrUb6VjuKq-9AhvTbG47XkRZ0,3640
+test_coverage_tool/parsers/http_traffic_parser.py,sha256=m2hVMBaDprIXTUEEYksDOddq9mkPdo8YTWjfeAsPnUI,4481
+test_coverage_tool/parsers/istanbul_parser.py,sha256=1qRikgW9tziLWWj_unusQd3_r9Qe74prBkuN5nWIi0U,5663
+test_coverage_tool/parsers/mutation_parser.py,sha256=FUmzjowqNDUemhSjVL0oSIhwCz48TDRYnyapi3jqYJ0,7677
+test_coverage_tool/parsers/pact_parser.py,sha256=kB9XJHzZTyK-bOVvQxZsoFe54-3cSIeTl8I919giAMQ,7760
+test_coverage_tool/parsers/spec_parser.py,sha256=QY3QEhRko-vo7-JIUYQp-83JzwyRXG3Uz97LI0HVL8Y,3656
+test_coverage_tool/parsers/test_parser.py,sha256=1JqlzS2z1PbKQRHd0fhIdSXVPhfICWGXnsS7wGST9gA,12136
+test_coverage_tool/portfolio/__init__.py,sha256=eUOGFqYIXYCgyBD9rS7tNdy0aQs8zui7tUy41yILwG0,541
+test_coverage_tool/portfolio/dashboard.py,sha256=gBqPLOSsfeSLTKgDyXOtfQlUjM5ka9fbkOlmeo6iwCM,3251
+test_coverage_tool/portfolio/rollup.py,sha256=MtaxHkgxBqDIxi9u15HbzVwrBRUHRzyM--fVTKpg6Cg,11329
+test_coverage_tool/portfolio/tokens.py,sha256=-4H8inW-qtfHdtwjYeWwKSLDK3lzEU_2wEjZOSEx-lE,4234
+test_coverage_tool/portfolio/_templates/portfolio.html.jinja,sha256=95TFeI4RmStVCMrzYU4n8qIM2w0hF6QqCQsmZT72A7E,4672
+test_coverage_tool/reports/__init__.py,sha256=4ou_gwaDnqraG_b8-dG3hd5K-Qhb1dJQeteDwNszeR4,283
+test_coverage_tool/reports/_format.py,sha256=Ap3FVSh2FaHfNTXXYuJYJtTHrcTSIopqvxKLBty8XFs,5183
+test_coverage_tool/reports/html_generator.py,sha256=sCJm-QKLtHNexmUr721Stup-zHcZh30wTQsWtPb96Eo,25371
+test_coverage_tool/reports/json_generator.py,sha256=rS0yTa6ZEcSzzQSB0fZzh6XpyomMRs-kjNR9dTCVgVc,20601
+test_coverage_tool/reports/pdf_generator.py,sha256=mowbnD6GkxO26hGlVxJhI8pv73fUT3OFSo4sjqaYTa4,12422
+test_coverage_tool/reports/_templates/report.html.jinja,sha256=E7c1g16cwwlGsVShSZKuij0T61DSaj0BvI4Q9-4xYxg,65976
+mentistest_coverage-0.2.2.dist-info/METADATA,sha256=h__Wvxd9GUL78DKGkLR6I_U-j4n9E89t17LcT5FjNLw,12523
+mentistest_coverage-0.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+mentistest_coverage-0.2.2.dist-info/entry_points.txt,sha256=009ZtUtesWqVrgcaNbv44YFDvkbqvd_x59puJLdMcmI,64
+mentistest_coverage-0.2.2.dist-info/top_level.txt,sha256=q5Bmd1bSzavT5kyJ8VG7k8IvagaQKecL7U0LQaX4EdU,19
+mentistest_coverage-0.2.2.dist-info/RECORD,,

mentistest_coverage-0.2.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mentistest_coverage-0.2.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mentistest = test_coverage_tool.cli.main:main

mentistest_coverage-0.2.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harry Trott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mentistest_coverage-0.2.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+test_coverage_tool

test_coverage_tool/__init__.py

@@ -0,0 +1,17 @@
+"""test_coverage_tool.
+
+A short description.
+"""
+
+from __future__ import annotations
+
+import logging as _std_lib_logging  # To avoid confusion with the package's logging.
+
+from . import _logging as logging
+from ._version import __version__
+
+logger = _std_lib_logging.getLogger(__name__)
+logger.setLevel(_std_lib_logging.WARNING)
+logger.addHandler(_std_lib_logging.NullHandler())
+
+__all__: list[str] = []

test_coverage_tool/_logging.py

@@ -0,0 +1,34 @@
+"""Console logger helper function."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+logger: logging.Logger = logging.getLogger("test_coverage_tool")
+
+
+def add_stream_handler(
+    level: int = logging.INFO,
+) -> logging.StreamHandler[Any]:
+    """Macro to add a StreamHandler to the package logger.
+
+    Useful for debugging or "semi-automatic" console scripts.
+
+    Args:
+        level: Logging level (use the logging module constants).
+
+    Returns:
+        the handler added to the package logger.
+    """
+    handler: logging.StreamHandler[Any] = logging.StreamHandler()
+    formatter = logging.Formatter(
+        "%(asctime)s: %(levelname)8s - %(name)s - %(message)s"
+    )
+    handler.setFormatter(formatter)
+    logger.addHandler(handler)
+    if level < logger.level:
+        logger.setLevel(level)
+    handler.setLevel(level)
+    logger.debug("Added a stderr logging handler to logger: %s", logger.name)
+    return handler

test_coverage_tool/_version.py

@@ -0,0 +1,4 @@
+"""Package version info."""
+
+COMMIT = None
+__version__ = "0.1.0"

test_coverage_tool/ai/__init__.py

@@ -0,0 +1,8 @@
+"""Optional AI-powered qualitative analysis."""
+
+from __future__ import annotations
+
+from test_coverage_tool.ai.analyzer import AIAnalyzer
+from test_coverage_tool.ai.config import AIConfig
+
+__all__ = ["AIAnalyzer", "AIConfig"]

test_coverage_tool/ai/_scrub.py

@@ -0,0 +1,83 @@
+"""Identifier scrubbing for AI prompts (PRODUCTION_REVIEW.md S4).
+
+The default prompt avoids source code but still carries test names,
+file paths, and project names — all of which can leak business
+context (``test_payment_card_validation_for_org_42_user_alice``,
+``customers/acme-corp/...``).  When ``AIConfig.scrub_identifiers`` is
+True we run every variable string through :func:`scrub` before it
+hits the model.
+
+The scrub is intentionally conservative: it replaces well-shaped PII
+patterns (email-like, UUID-like, multi-word proper nouns inside path
+segments) with stable placeholders.  Test-type words and version
+strings pass through untouched because the model needs them to make
+sensible recommendations.
+
+Stability matters: ``acme-corp`` always becomes ``<PII1>`` within a
+single :class:`Scrubber` instance so the model can still spot
+"the same customer appears in three tests" patterns without seeing
+the real name.
+"""
+
+from __future__ import annotations
+
+import re
+
+_EMAIL_RE = re.compile(r"[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}")
+_UUID_RE = re.compile(
+    r"\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-"
+    r"[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\b"
+)
+# Proper-noun segments: a path / underscore token that's at least two
+# alphabetic chunks joined by an underscore or hyphen, starting with
+# an upper-case letter or an all-lower-case word longer than 5 chars.
+# Heuristic, intentionally narrow.
+_PROPER_NOUN_RE = re.compile(
+    r"\b(?:[A-Z][a-z]{2,}(?:[_-][A-Za-z]{2,})+|"
+    r"[a-z]{6,}(?:[_-][a-z]{3,}){1,})\b"
+)
+
+
+class Scrubber:
+    """Deterministic identifier scrubber with stable placeholders.
+
+    A single instance carries a mapping from original token to
+    placeholder so repeated tokens scrub to the same placeholder
+    within one prompt — preserving the "same customer appears
+    several times" signal without exposing the real value.
+
+    Attributes:
+        prefix: Prefix for placeholders.  Defaults to ``"PII"``.
+    """
+
+    def __init__(self, prefix: str = "PII") -> None:
+        """Initialise the scrubber with an empty token map.
+
+        Args:
+            prefix: Placeholder prefix; produced tokens look like
+                ``<PII1>``.
+        """
+        self.prefix = prefix
+        self._tokens: dict[str, str] = {}
+
+    def scrub(self, text: str) -> str:
+        """Return *text* with detected PII replaced by stable placeholders.
+
+        Args:
+            text: Raw user-prompt-bound string.
+
+        Returns:
+            The same text with email / UUID / proper-noun-shaped
+            tokens replaced by ``<PII1>``, ``<PII2>``, ... in the
+            order they were first seen.
+        """
+        out = _EMAIL_RE.sub(self._replace, text)
+        out = _UUID_RE.sub(self._replace, out)
+        return _PROPER_NOUN_RE.sub(self._replace, out)
+
+    def _replace(self, match: re.Match[str]) -> str:
+        """Return the placeholder for *match*, registering it on first sight."""
+        token = match.group(0)
+        if token not in self._tokens:
+            self._tokens[token] = f"<{self.prefix}{len(self._tokens) + 1}>"
+        return self._tokens[token]