PyPI - codeecho - Versions diffs - 1.0.0__py3-none-any.whl - Mend

codeecho 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

codeecho/.ignore +41 -0
codeecho/__init__.py +22 -0
codeecho/__main__.py +289 -0
codeecho/db.py +289 -0
codeecho/detector.py +246 -0
codeecho/extractor.py +139 -0
codeecho/fingerprint.py +38 -0
codeecho/logging.ini +28 -0
codeecho/models.py +52 -0
codeecho/normalizer.py +519 -0
codeecho/parser.py +94 -0
codeecho/reporter/__init__.py +6 -0
codeecho/reporter/html_reporter.py +212 -0
codeecho/reporter/json_reporter.py +82 -0
codeecho/scanner.py +109 -0
codeecho-1.0.0.dist-info/METADATA +208 -0
codeecho-1.0.0.dist-info/RECORD +20 -0
codeecho-1.0.0.dist-info/WHEEL +4 -0
codeecho-1.0.0.dist-info/entry_points.txt +3 -0
codeecho-1.0.0.dist-info/licenses/LICENSE +21 -0

codeecho/reporter/html_reporter.py ADDED Viewed

@@ -0,0 +1,212 @@
+"""
+HTML reporter: renders an inline self-contained report from session database results.
+The HTML is generated via a Jinja2 template embedded as a module-level string — no
+external files required.  The report includes a summary panel, per-clone-type stats,
+and expandable code-snippet cards for every clone group.
+:author: Ron Webb
+:since: 1.0.0
+"""
+import logging
+from datetime import datetime, timezone
+from pathlib import Path
+from jinja2 import BaseLoader, Environment
+from codeecho.db import SessionDB
+from codeecho.models import ScanResult
+_logger = logging.getLogger("codeecho.reporter.html")
+# ── Jinja2 template ───────────────────────────────────────────────────────────
+_TEMPLATE: str = """<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>CodeEcho — Clone Detection Report</title>
+<style>
+  :root{--bg:#0f1117;--surface:#1a1d27;--border:#2e3248;--accent:#7c6af7;
+        --t1:#ef4444;--t2:#f59e0b;--t3:#22c55e;--text:#e2e8f0;--muted:#94a3b8}
+  *{box-sizing:border-box;margin:0;padding:0}
+  body{background:var(--bg);color:var(--text);font-family:system-ui,sans-serif;
+       font-size:14px;line-height:1.6;padding:2rem}
+  h1{font-size:1.6rem;font-weight:700;margin-bottom:.25rem}
+  .subtitle{color:var(--muted);margin-bottom:1rem}
+  .toolbar{display:flex;align-items:center;gap:.5rem;margin-bottom:1.5rem}
+  .btn{background:var(--surface);border:1px solid var(--border);border-radius:6px;
+       color:var(--text);cursor:pointer;font-size:.8rem;padding:.35rem .9rem;
+       font-family:inherit}
+  .btn:hover{border-color:var(--accent);color:var(--accent)}
+  #show-all-btn{display:none;margin-left:auto}
+  .stats{display:flex;gap:1rem;flex-wrap:wrap;margin-bottom:1.5rem}
+  .stat{background:var(--surface);border:1px solid var(--border);border-radius:8px;
+        padding:1rem 1.5rem;min-width:130px}
+  .stat.clickable{cursor:pointer;transition:border-color .15s}
+  .stat.clickable:hover{border-color:var(--accent)}
+  .stat.active{border-color:var(--accent)}
+  .stat-val{font-size:2rem;font-weight:700}
+  .stat-lbl{color:var(--muted);font-size:.8rem;text-transform:uppercase;letter-spacing:.05em}
+  .type-badge{display:inline-block;border-radius:4px;padding:2px 8px;font-size:.75rem;
+              font-weight:600;color:#fff}
+  .t1{background:var(--t1)}.t2{background:var(--t2)}.t3{background:var(--t3)}
+  .type-section{margin-bottom:.5rem}
+  .type-section>summary{display:flex;align-items:center;gap:.5rem;list-style:none;
+                         font-size:1.1rem;font-weight:600;padding:.6rem .5rem .4rem;
+                         border-bottom:1px solid var(--border);cursor:pointer;
+                         user-select:none;margin:1.5rem 0 .75rem}
+  .type-section>summary::-webkit-details-marker{display:none}
+  .section-chevron{color:var(--muted);transition:transform .2s;margin-left:auto;font-style:normal}
+  details.type-section[open]>summary .section-chevron{transform:rotate(90deg)}
+  .group{background:var(--surface);border:1px solid var(--border);border-radius:8px;
+         margin-bottom:1rem;overflow:hidden}
+  .group-header{display:flex;align-items:center;gap:.75rem;padding:.75rem 1rem;
+                cursor:pointer;user-select:none}
+  .group-title{flex:1;font-weight:600}
+  .group-meta{color:var(--muted);font-size:.8rem}
+  .chevron{color:var(--muted);transition:transform .2s;font-style:normal}
+  details.group[open]>summary .chevron{transform:rotate(90deg)}
+  .member{border-top:1px solid var(--border);padding:.75rem 1rem}
+  .member-meta{color:var(--muted);font-size:.8rem;margin-bottom:.5rem}
+  .member-meta strong{color:var(--text)}
+  pre{background:#0a0c12;border-radius:6px;padding:.75rem;overflow-x:auto;
+      font-size:.8rem;line-height:1.5;max-height:320px}
+  .empty{color:var(--muted);font-style:italic;padding:.5rem 0}
+  footer{margin-top:2rem;color:var(--muted);font-size:.8rem}
+</style>
+</head>
+<body>
+<h1>CodeEcho</h1>
+<div class="subtitle">Clone Detection Report &mdash; {{ generated_at }}</div>
+<div class="toolbar">
+  <button class="btn" onclick="toggleAll(true)">Expand All</button>
+  <button class="btn" onclick="toggleAll(false)">Collapse All</button>
+  <button id="show-all-btn" class="btn" onclick="filterType(null)">&#8592; Show All Types</button>
+</div>
+<div class="stats">
+  <div class="stat">
+    <div class="stat-val">{{ result.files_scanned }}</div>
+    <div class="stat-lbl">Files Scanned</div>
+  </div>
+  <div class="stat">
+    <div class="stat-val">{{ result.fragments_extracted }}</div>
+    <div class="stat-lbl">Fragments</div>
+  </div>
+  <div class="stat clickable" data-type="1" onclick="filterType(1)">
+    <div class="stat-val" style="color:var(--t1)">{{ result.type1_groups }}</div>
+    <div class="stat-lbl">Type-1 Groups</div>
+  </div>
+  <div class="stat clickable" data-type="2" onclick="filterType(2)">
+    <div class="stat-val" style="color:var(--t2)">{{ result.type2_groups }}</div>
+    <div class="stat-lbl">Type-2 Groups</div>
+  </div>
+  <div class="stat clickable" data-type="3" onclick="filterType(3)">
+    <div class="stat-val" style="color:var(--t3)">{{ result.type3_groups }}</div>
+    <div class="stat-lbl">Type-3 Groups</div>
+  </div>
+</div>
+{% for type_num, type_label, css_class in [(1,'Type-1 — Exact Clones','t1'),
+                                            (2,'Type-2 — Structural Clones','t2'),
+                                            (3,'Type-3 — Near Duplicates','t3')] %}
+{% set type_groups = groups_by_type[type_num] %}
+<details class="type-section" data-type="{{ type_num }}" open>
+  <summary>
+    <span class="type-badge {{ css_class }}">Type-{{ type_num }}</span>
+    {{ type_label }}
+    <i class="section-chevron">&#9658;</i>
+  </summary>
+  {% if type_groups %}
+  {% for entry in type_groups %}
+  <details class="group">
+    <summary class="group-header">
+      <i class="chevron">&#9658;</i>
+      <span class="group-title">Group {{ loop.index }} &mdash; {{ entry.members | length }} members</span>
+      {% if entry.group.similarity_score is not none %}
+      <span class="group-meta">similarity {{ "%.0f"|format(entry.group.similarity_score * 100) }}%</span>
+      {% endif %}
+    </summary>
+    {% for frag in entry.members %}
+    <div class="member">
+      <div class="member-meta">
+        <strong>{{ frag.language }}</strong> {{ frag.fragment_type }} &bull;
+        <strong>{{ frag.file_path }}</strong>
+        lines {{ frag.start_line }}–{{ frag.end_line }}
+      </div>
+      <pre>{{ frag.source_text }}</pre>
+    </div>
+    {% endfor %}
+  </details>
+  {% endfor %}
+  {% else %}
+  <div class="empty">No {{ type_label }} found.</div>
+  {% endif %}
+</details>
+{% endfor %}
+<footer>Scan path: {{ result.scan_path }} &bull; Session: {{ result.session_id }}</footer>
+<script>
+function toggleAll(open) {
+  document.querySelectorAll('details').forEach(function(d) { d.open = open; });
+}
+function filterType(type) {
+  var sections = document.querySelectorAll('.type-section');
+  var showAllBtn = document.getElementById('show-all-btn');
+  var statCards = document.querySelectorAll('.stat.clickable');
+  if (type === null) {
+    sections.forEach(function(s) { s.style.display = ''; });
+    showAllBtn.style.display = 'none';
+    statCards.forEach(function(c) { c.classList.remove('active'); });
+  } else {
+    sections.forEach(function(s) {
+      s.style.display = (parseInt(s.dataset.type) === type) ? '' : 'none';
+    });
+    showAllBtn.style.display = 'inline-block';
+    statCards.forEach(function(c) {
+      c.classList.toggle('active', parseInt(c.dataset.type) === type);
+    });
+  }
+}
+</script>
+</body>
+</html>"""
+def write(
+    session_db: SessionDB,
+    result: ScanResult,
+    output_path: Path,
+) -> Path:
+    """Render all clone groups for *result.session_id* to an HTML file at *output_path*.
+    :param session_db: Open :class:`~codeecho.db.SessionDB` context.
+    :param result: Summary statistics from the scan.
+    :param output_path: Destination HTML file path.
+    :returns: The resolved path of the written file.
+    """
+    groups = session_db.get_clone_groups(result.session_id)
+    groups_by_type: dict[int, list[dict]] = {1: [], 2: [], 3: []}
+    for group in groups:
+        members = session_db.get_fragments_for_group(group)
+        entry = {"group": group, "members": members}
+        groups_by_type[group.clone_type].append(entry)
+    env = Environment(loader=BaseLoader(), autoescape=True)  # type: ignore[call-arg]
+    tmpl = env.from_string(_TEMPLATE)
+    html = tmpl.render(
+        result=result,
+        groups_by_type=groups_by_type,
+        generated_at=datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC"),
+    )
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(html, encoding="utf-8")
+    _logger.debug("HTML report written to %s", output_path)
+    return output_path.resolve()

codeecho/reporter/json_reporter.py ADDED Viewed

@@ -0,0 +1,82 @@
+"""
+JSON reporter: serialises clone detection results from the session database to a JSON file.
+:author: Ron Webb
+:since: 1.0.0
+"""
+import json
+import logging
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+from codeecho.db import SessionDB
+from codeecho.models import CloneGroup, Fragment, ScanResult
+_logger = logging.getLogger("codeecho.reporter.json")
+def _fragment_to_dict(frag: Fragment) -> dict[str, Any]:
+    return {
+        "fragment_id": frag.fragment_id,
+        "file": frag.file_path,
+        "language": frag.language,
+        "fragment_type": frag.fragment_type,
+        "start_line": frag.start_line,
+        "end_line": frag.end_line,
+        "token_count": frag.token_count,
+        "source_text": frag.source_text,
+    }
+def _group_to_dict(group: CloneGroup, members: list[Fragment]) -> dict[str, Any]:
+    result: dict[str, Any] = {
+        "group_id": group.group_id,
+        "clone_type": group.clone_type,
+        "representative_hash": group.representative_hash,
+        "members": [_fragment_to_dict(f) for f in members],
+    }
+    if group.similarity_score is not None:
+        result["similarity_score"] = round(group.similarity_score, 4)
+    return result
+def write(
+    session_db: SessionDB,
+    result: ScanResult,
+    output_path: Path,
+) -> Path:
+    """Serialise all clone groups for *result.session_id* to *output_path*.
+    :param session_db: Open :class:`~codeecho.db.SessionDB` context.
+    :param result: Summary statistics from the scan.
+    :param output_path: Destination JSON file path.
+    :returns: The resolved path of the written file.
+    """
+    groups = session_db.get_clone_groups(result.session_id)
+    groups_data: list[dict[str, Any]] = []
+    for group in groups:
+        members = session_db.get_fragments_for_group(group)
+        groups_data.append(_group_to_dict(group, members))
+    payload = {
+        "generated_at": datetime.now(timezone.utc).isoformat(),
+        "session_id": result.session_id,
+        "scan_path": result.scan_path,
+        "summary": {
+            "files_scanned": result.files_scanned,
+            "fragments_extracted": result.fragments_extracted,
+            "type1_groups": result.type1_groups,
+            "type2_groups": result.type2_groups,
+            "type3_groups": result.type3_groups,
+        },
+        "clone_groups": groups_data,
+    }
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(
+        json.dumps(payload, indent=2, ensure_ascii=False), encoding="utf-8"
+    )
+    _logger.debug("JSON report written to %s", output_path)
+    return output_path.resolve()

codeecho/scanner.py ADDED Viewed

@@ -0,0 +1,109 @@
+"""
+File-system scanner that discovers source files for clone detection.
+:author: Ron Webb
+:since: 1.0.0
+"""
+import fnmatch
+import logging
+from pathlib import Path
+from braincraft import IgnoreFile
+_logger = logging.getLogger("codeecho.scanner")
+EXTENSION_TO_LANGUAGE: dict[str, str] = {
+    ".py": "Python",
+    ".js": "JavaScript",
+    ".mjs": "JavaScript",
+    ".cjs": "JavaScript",
+    ".ts": "TypeScript",
+    ".tsx": "TypeScript",
+    ".java": "Java",
+    ".go": "Go",
+    ".gs": "Gosu",
+    ".gsx": "Gosu",
+}
+_DEFAULT_EXCLUDE_DIRS: frozenset[str] = frozenset(
+    {
+        ".git",
+        ".svn",
+        ".hg",
+        ".venv",
+        "venv",
+        "env",
+        ".env",
+        "__pycache__",
+        "node_modules",
+        "build",
+        "dist",
+        "target",
+        "out",
+        ".tox",
+        ".pytest_cache",
+        "htmlcov",
+        ".mypy_cache",
+        ".ruff_cache",
+    }
+)
+def scan(
+    root: Path,
+    exclude_patterns: tuple[str, ...] = (),
+    ignore_file: IgnoreFile | None = None,
+) -> list[tuple[Path, str]]:
+    """Walk *root* recursively and return ``(path, language)`` pairs for supported files.
+    :param root: Root directory to scan.
+    :param exclude_patterns: Glob patterns (fnmatch-style) whose matching paths are skipped.
+    :param ignore_file: Optional gitignore-style :class:`~braincraft.IgnoreFile`; matched paths are skipped.
+    :returns: List of ``(absolute_path, language_name)`` tuples.
+    """
+    results: list[tuple[Path, str]] = []
+    root = root.resolve()
+    _logger.debug("Scanning root: %s", root)
+    for entry in _walk(root, exclude_patterns, ignore_file):
+        suffix = entry.suffix.lower()
+        if language := EXTENSION_TO_LANGUAGE.get(suffix):
+            results.append((entry, language))
+    _logger.debug("Found %d source files under %s", len(results), root)
+    return results
+def _walk(
+    root: Path,
+    exclude_patterns: tuple[str, ...],
+    ignore_file: IgnoreFile | None,
+):
+    """Recursively collect file paths, skipping excluded directories and glob-matched files."""
+    try:
+        for child in sorted(root.iterdir()):
+            if child.is_dir():
+                if child.name in _DEFAULT_EXCLUDE_DIRS:
+                    continue
+                if _matches_any(child, exclude_patterns):
+                    continue
+                if ignore_file is not None and ignore_file.is_ignored(child):
+                    _logger.debug("Ignored (ignore file): %s", child)
+                    continue
+                yield from _walk(child, exclude_patterns, ignore_file)
+            elif child.is_file():
+                if _matches_any(child, exclude_patterns):
+                    continue
+                if ignore_file is not None and ignore_file.is_ignored(child):
+                    _logger.debug("Ignored (ignore file): %s", child)
+                    continue
+                yield child
+    except PermissionError as exc:
+        _logger.warning("Permission denied reading %s: %s", root, exc)
+def _matches_any(path: Path, patterns: tuple[str, ...]) -> bool:
+    """Return True if *path* matches any of the given fnmatch-style *patterns*."""
+    path_str = str(path)
+    return any(fnmatch.fnmatch(path_str, p) for p in patterns)

codeecho-1.0.0.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: codeecho
+Version: 1.0.0
+Summary: A developer tool that scans your codebase to detect and highlight ECHOES of duplicated or near-duplicated code so you can refactor toward cleaner, more maintainable designs.
+License: MIT License
+         Copyright (c) 2026 Ron Webb
+         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.
+License-File: LICENSE
+Author: Ron Webb
+Requires-Python: >=3.14
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: braincraft (>=1.2.0,<2.0.0)
+Requires-Dist: click (>=8.4.2,<9.0.0)
+Requires-Dist: env-dir-bootstrap (>=1.1.0,<2.0.0)
+Requires-Dist: jinja2 (>=3.1)
+Requires-Dist: logenrich (>=1.0.1,<2.0.0)
+Requires-Dist: rich (>=15.0.0,<16.0.0)
+Requires-Dist: tree-sitter (>=0.26.0,<0.27.0)
+Requires-Dist: tree-sitter-go (>=0.25.0,<0.26.0)
+Requires-Dist: tree-sitter-java (>=0.23.5,<0.24.0)
+Requires-Dist: tree-sitter-javascript (>=0.25.0,<0.26.0)
+Requires-Dist: tree-sitter-python (>=0.25.0,<0.26.0)
+Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
+Description-Content-Type: text/markdown
+# codeecho 1.0.0
+> A developer tool that scans your codebase to detect and highlight **echoes** of duplicated or near-duplicated code, so you can refactor toward cleaner, more maintainable designs.
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](CHANGELOG.md)
+## Prerequisites
+- Python `>=3.14`
+## Installation
+```powershell
+pip install codeecho
+```
+## Usage
+```powershell
+python -m codeecho <path> [options]
+```
+### Clone detection levels
+| Type | Detection strategy | Example |
+|------|--------------------|---------|
+| **Type-1** | Exact copy-paste — identical token sequences | Two functions with the same code copied verbatim |
+| **Type-2** | Structural clone — same structure, renamed identifiers / literals | Same logic with different variable names |
+| **Type-3** | Near-duplicate — high Jaccard similarity on token sets | Nearly identical functions with a few extra lines |
+### Supported languages
+| Language | Extensions |
+|----------|-----------|
+| Python | `.py` |
+| JavaScript | `.js`, `.mjs`, `.cjs` |
+| TypeScript | `.ts`, `.tsx` |
+| Java | `.java` |
+| Go | `.go` |
+| Gosu | `.gs`, `.gsx` |
+### Arguments
+| Argument | Description |
+|----------|-------------|
+| `path` | Root directory to scan. |
+### Options
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--types <types>` | `all` | Clone types to detect: comma-separated (`1`, `2`, `3`) or `all`. |
+| `--threshold <float>` | `0.8` | Jaccard similarity threshold for Type-3 detection (`0.0`–`1.0`). |
+| `--output <name>` | `codeecho-output` | Base name (without extension) for output file(s). |
+| `--output-dir <dir>` | `<cwd>/reports` | Directory where output file(s) will be written. |
+| `--db-dir <dir>` | `~/.codeecho` | Directory for the SQLite scratch database (`codeecho.db`). Session records are removed after the report is written. |
+| `--format <fmt>` | `both` | Output format: `json`, `html`, or `both`. |
+| `--min-tokens <n>` | `10` | Minimum token count for a code fragment to be included. |
+| `--exclude <pattern>` | _(none)_ | Glob pattern(s) to exclude from scanning (repeatable). |
+| `--version` | | Print the version and exit. |
+| `-h, --help` | | Show help and exit. |
+### Examples
+Scan the current directory and write both JSON and HTML reports:
+```powershell
+python -m codeecho .
+```
+Detect only Type-1 and Type-2 clones in a `src/` tree:
+```powershell
+python -m codeecho src --types 1,2
+```
+Scan with a custom output name and directory:
+```powershell
+python -m codeecho . --output my-scan --output-dir audit/reports
+```
+Lower the Type-3 threshold to catch more near-duplicates:
+```powershell
+python -m codeecho . --threshold 0.6
+```
+Exclude test and vendor directories:
+```powershell
+python -m codeecho . --exclude "*/tests/*" --exclude "*/vendor/*"
+```
+## Configuration
+| Environment variable | Description |
+|----------------------|-------------|
+| `CODEECHO_CONFIG_DIR` | Directory where `logging.ini` and `.ignore` are seeded on first run. When unset, the bundled copies inside the package are used directly. |
+### `.ignore` file
+On first run, a `.ignore` file is seeded into `CODEECHO_CONFIG_DIR` (or the package directory when unset). It follows gitignore syntax and is applied during file scanning to exclude paths in addition to any `--exclude` patterns passed on the command line. Edit this file to permanently suppress paths you never want scanned.
+## Development
+### Prerequisites
+- Poetry `2.2+`
+### Setup
+```powershell
+poetry install
+```
+### Run
+```powershell
+poetry run python -m codeecho <path> [options]
+```
+### Architecture
+```mermaid
+flowchart TD
+    CLI["__main__.py\n(Click CLI)"] --> ScannerM["scanner.py\nFile discovery"]
+    ScannerM --> Parser["parser.py\nTree-sitter parsing"]
+    Parser --> Extractor["extractor.py\nFragment extraction\n(functions · classes · files)"]
+    Extractor --> Normalizer["normalizer.py\nRegex tokeniser\nType-2 normalisation"]
+    Normalizer --> Fingerprint["fingerprint.py\nSHA-256 hashing"]
+    Fingerprint --> DB["db.py\nSQLite session store"]
+    DB --> Detector["detector.py\nType-1 / 2 hash grouping\nType-3 Jaccard similarity"]
+    Detector --> DB
+    DB --> JSON["reporter/json_reporter.py\nJSON report"]
+    DB --> HTML["reporter/html_reporter.py\nHTML report"]
+    DB -->|delete session| Cleanup["Session cleanup"]
+```
+### Format and Lint
+```powershell
+poetry run black codeecho
+poetry run pylint codeecho
+```
+### Run Tests with Coverage
+```powershell
+poetry run pytest --cov=codeecho tests --cov-report html
+```
+## [Changelog](CHANGELOG.md)
+## License
+This project is licensed under the [MIT License](LICENSE).
+## Author
+Ron Webb

codeecho-1.0.0.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,20 @@
+codeecho/.ignore,sha256=nFtm2m82jdMWoOE-zN1Blkl5zPzvj-RTp1RBVUX0Rkk,890
+codeecho/__init__.py,sha256=Zn5pJRqT5mi4SKNXA_Om6vsbRrdEMsqutUX1zdy_Y1E,566
+codeecho/__main__.py,sha256=Q8TyKYoVVdM5sRr4S1GTbNGhgVkads4JZKSPpjxxwsM,9904
+codeecho/db.py,sha256=kYKWzgK43vVus9Yd7GU5Pq1Gpyzm-Cv-EePtz-t8uHc,10846
+codeecho/detector.py,sha256=SXVWizPkF4vioW1YLauT5X4vCX7aeNyRUlH0e7nQ9V0,9189
+codeecho/extractor.py,sha256=Q1xAmm2uxaCl79JrMKRLbMv_8he91ux4l3XzrBiHC3E,5942
+codeecho/fingerprint.py,sha256=1XiUbOu_o-f2BmIgKtoY7R82MPvRlP6h3_Mhjcykwgo,1153
+codeecho/logging.ini,sha256=RS__BOZiTPN8NPq_uXsAKiSnoieotWk0eUm12hYyR5k,532
+codeecho/models.py,sha256=9jF8iv8nr27gLvLU5xejqL5VHaCp5Hu0yiN3Jbhjkhk,1372
+codeecho/normalizer.py,sha256=2LkqTVHQ5pIVELd4U-BUwZInS_0W_A30n4PrWjYoNR4,14287
+codeecho/parser.py,sha256=FMIpdNuYZ1KNfXknmNIgpaB8vBjJZcJqmnfSma8bbH4,3521
+codeecho/reporter/__init__.py,sha256=aKypjtT_gmODQrdTQ8vPqiKAN117Ge9AgdR63WbggRg,134
+codeecho/reporter/html_reporter.py,sha256=tuOK2GzAJ7EePhqN37XEiXkucLf2ovx1HdGXiNZSuZ0,9222
+codeecho/reporter/json_reporter.py,sha256=d-xyQBmXWSsrtHK1FQhpa3s1hhFKfVRC7bZ2pmrV814,2731
+codeecho/scanner.py,sha256=NnU_hWwgX5Ih75dpnlkXo8keTEAWJBsMY-ZNAIo0m-s,3363
+codeecho-1.0.0.dist-info/entry_points.txt,sha256=xFm7C6gbwIifpmqvbD9yxlFEt6yhKYOQUs-THG3lzGU,51
+codeecho-1.0.0.dist-info/licenses/LICENSE,sha256=2cmui6TBSfJF5E2Qr0xNS8x4ZY0grz8qLEBEW1CgpjA,1086
+codeecho-1.0.0.dist-info/METADATA,sha256=lk33QRK9aOC-G6dtlT7jSsop-l8A0jQOLoS2HQbKhds,7060
+codeecho-1.0.0.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
+codeecho-1.0.0.dist-info/RECORD,,

codeecho-1.0.0.dist-info/WHEEL ADDED Viewed

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.2
+Root-Is-Purelib: true
+Tag: py3-none-any

codeecho-1.0.0.dist-info/entry_points.txt ADDED Viewed

@@ -0,0 +1,3 @@
+[console_scripts]
+codeecho=codeecho.__main__:main

codeecho-1.0.0.dist-info/licenses/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Ron Webb
+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.