codeecho 1.2.2__tar.gz → 1.2.3__tar.gz

{codeecho-1.2.2 → codeecho-1.2.3}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.2.3 - 2026-10-01
+
+### Changed
+
+- `--min-tokens` (default `10`, unchanged) now measures a fragment's **line count** instead of its
+  raw token count: a fragment must span at least this many lines to be considered. Annotations,
+  braces, and semicolons could previously inflate a trivial one-line getter/override's token count
+  enough to slip past `--min-tokens` and surface as a noisy Type-1 clone group; line count is a
+  more reliable measure of fragment size.
+
 ## 1.2.2 - 2026-09-23
 
 ### Changed

{codeecho-1.2.2 → codeecho-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeecho
-Version: 1.2.2
+Version: 1.2.3
 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-Expression: MIT
 License-File: LICENSE
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 
 # codeecho
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.2-green.svg)](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md) [![Python](https://img.shields.io/badge/Python-3.14%2B-blue)](https://www.python.org/) [![PyPI](https://img.shields.io/badge/PyPI-codeecho-orange)](https://pypi.org/project/codeecho/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.3-green.svg)](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md) [![Python](https://img.shields.io/badge/Python-3.14%2B-blue)](https://www.python.org/) [![PyPI](https://img.shields.io/badge/PyPI-codeecho-orange)](https://pypi.org/project/codeecho/)
 
 > 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.
 
@@ -92,7 +92,7 @@ python -m codeecho <path> [options]
 | `--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. |
+| `--min-tokens <n>` | `10` | Minimum line count for a code fragment to be included. |
 | `--exclude <pattern>` | _(none)_ | Glob pattern(s) to exclude from scanning (repeatable). |
 | `--target-list` | `false` | Treat `PATH` as a single existing file listing target paths (files and/or directories), one per line, instead of individual `PATH` arguments. Blank lines and lines starting with `#` are skipped. |
 | `--basis <file>` | _(none)_ | File listing basis target paths, one per line — same format as `--target-list`. Absolute file/directory entries are merged into the scan automatically and matched exactly; relative entries (e.g. a bare filename like `Foo.gs`) are matched by filename/suffix against any file discovered in the scan. The report is filtered to only clone groups touching at least one basis file, and groups duplicated purely among basis files are flagged (`basis_internal` in JSON, a "Basis-to-Basis" badge in HTML). |

{codeecho-1.2.2 → codeecho-1.2.3}/README.md

@@ -1,6 +1,6 @@
 # codeecho
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.2-green.svg)](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md) [![Python](https://img.shields.io/badge/Python-3.14%2B-blue)](https://www.python.org/) [![PyPI](https://img.shields.io/badge/PyPI-codeecho-orange)](https://pypi.org/project/codeecho/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.3-green.svg)](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md) [![Python](https://img.shields.io/badge/Python-3.14%2B-blue)](https://www.python.org/) [![PyPI](https://img.shields.io/badge/PyPI-codeecho-orange)](https://pypi.org/project/codeecho/)
 
 > 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.
 
@@ -55,7 +55,7 @@ python -m codeecho <path> [options]
 | `--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. |
+| `--min-tokens <n>` | `10` | Minimum line count for a code fragment to be included. |
 | `--exclude <pattern>` | _(none)_ | Glob pattern(s) to exclude from scanning (repeatable). |
 | `--target-list` | `false` | Treat `PATH` as a single existing file listing target paths (files and/or directories), one per line, instead of individual `PATH` arguments. Blank lines and lines starting with `#` are skipped. |
 | `--basis <file>` | _(none)_ | File listing basis target paths, one per line — same format as `--target-list`. Absolute file/directory entries are merged into the scan automatically and matched exactly; relative entries (e.g. a bare filename like `Foo.gs`) are matched by filename/suffix against any file discovered in the scan. The report is filtered to only clone groups touching at least one basis file, and groups duplicated purely among basis files are flagged (`basis_internal` in JSON, a "Basis-to-Basis" badge in HTML). |

{codeecho-1.2.2 → codeecho-1.2.3}/codeecho/__init__.py

@@ -10,7 +10,7 @@ maintainable designs.
 from env_dir_bootstrap import EnvDirBootstrap
 from logenrich import setup_logger
 
-__version__ = "1.2.2"
+__version__ = "1.2.3"
 
 _bootstrapper = EnvDirBootstrap(
     env_var="CODEECHO_CONFIG_DIR",

{codeecho-1.2.2 → codeecho-1.2.3}/codeecho/__main__.py

@@ -237,7 +237,7 @@ def _discover_files(
     default=10,
     show_default=True,
     type=click.IntRange(1),
-    help="Minimum token count for a fragment to be considered.",
+    help="Minimum line count for a fragment to be considered.",
 )
 @click.option(
     "--exclude",

{codeecho-1.2.2 → codeecho-1.2.3}/codeecho/extractor.py

@@ -91,7 +91,7 @@ def extract_fragments(  # pylint: disable=too-many-arguments,too-many-positional
     :param file_path: Absolute path of the source file.
     :param language_name: Language name (e.g. ``"Python"``).
     :param session_id: UUID of the current scan session.
-    :param min_tokens: Fragments with fewer raw tokens are discarded.
+    :param min_tokens: Fragments spanning fewer lines than this are discarded.
     :returns: List of fully-populated :class:`Fragment` objects.
     :since: 1.0.0
     """
@@ -118,14 +118,14 @@ def extract_fragments(  # pylint: disable=too-many-arguments,too-many-positional
         ]
         del cursor, captures  # free tree-sitter objects before processing
         for start_b, end_b in node_ranges:
+            start_ln = bisect_left(newline_offsets, start_b) + 1
+            end_ln = bisect_left(newline_offsets, end_b) + 1
+            if end_ln - start_ln + 1 < min_tokens:
+                continue
             src_text = source_bytes[start_b:end_b].decode("utf-8", errors="replace")
             raw_tokens, norm_tokens = normalizer.tokenise_and_normalise(
                 src_text, language_name
             )
-            if len(raw_tokens) < min_tokens:
-                continue
-            start_ln = bisect_left(newline_offsets, start_b) + 1
-            end_ln = bisect_left(newline_offsets, end_b) + 1
             fragments.append(
                 Fragment(
                     fragment_id=str(uuid.uuid4()),

{codeecho-1.2.2 → codeecho-1.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codeecho"
-version = "1.2.2"
+version = "1.2.3"
 description = "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."
 authors = [
     {name = "Ron Webb"}