codeecho 1.0.1__tar.gz → 1.2.0__tar.gz

codeecho-1.2.0/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## 1.2.0 - 2026-09-18
+
+### Added
+
+- `config.ini` (seeded into `CODEECHO_CONFIG_DIR`) with an `[override]` section that lets you rename
+  the `.ignore` file via the `ignore-file` key. Falls back to the bundled `.ignore` when the
+  configured file is missing.
+- `--target-list` flag: treat `PATH` as a single file listing scan targets, one per line (blank
+  lines and `#`-prefixed comments are skipped), instead of passing `PATH` arguments directly.
+- `--basis` flag: 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) 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, `is_basis` per member).
+
+## 1.1.0 - 2026-08-15
+
+### Added
+
+- Gosu (`.gs`, `.gsx`) is now parsed with a dedicated [tree-sitter-gosu](https://github.com/rcw3bb/tree-sitter-gosu)
+  grammar instead of the Java fallback, enabling accurate fragment extraction using Gosu-native node types
+  (`compilation_unit`, `function_declaration`, `constructor_declaration`, `class_declaration`).
+
+## 1.0.1 - 2026-07-10
+
+### Fixed
+
+- Type-3 clone detection no longer flags fragments as clones when one is nested inside the other
+  within the same file (e.g. a `function` inside its enclosing `class`).
+- Type-3 clone groups now drop outer/container fragments (e.g. a whole-`file` fragment) when a
+  more specific nested fragment from the same file is already a member of that group, preventing
+  false positives caused by union-find transitivity.
+
+## 1.0.0 - 2026-07-10
+
+### Added
+
+- Initial release of codeecho.

{codeecho-1.0.1 → codeecho-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeecho
-Version: 1.0.1
+Version: 1.2.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
          
@@ -37,18 +37,18 @@ 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-gosu (>=0.2.0,<0.3.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.1
+# codeecho 1.2.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)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.0-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)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.0.1-blue.svg)](CHANGELOG.md)
+> 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.
 
 ## Prerequisites
 
@@ -76,14 +76,14 @@ python -m codeecho <path> [options]
 
 ### Supported languages
 
-| Language | Extensions |
-|----------|-----------|
-| Python | `.py` |
-| JavaScript | `.js`, `.mjs`, `.cjs` |
-| TypeScript | `.ts`, `.tsx` |
-| Java | `.java` |
-| Go | `.go` |
-| Gosu | `.gs`, `.gsx` |
+| Language | Extensions | Grammar |
+|----------|-----------|--------|
+| Python | `.py` | [tree-sitter-python](https://github.com/tree-sitter/tree-sitter-python) |
+| JavaScript | `.js`, `.mjs`, `.cjs` | [tree-sitter-javascript](https://github.com/tree-sitter/tree-sitter-javascript) |
+| TypeScript | `.ts`, `.tsx` | [tree-sitter-typescript](https://github.com/tree-sitter/tree-sitter-typescript) |
+| Java | `.java` | [tree-sitter-java](https://github.com/tree-sitter/tree-sitter-java) |
+| Go | `.go` | [tree-sitter-go](https://github.com/tree-sitter/tree-sitter-go) |
+| Gosu | `.gs`, `.gsx` | [tree-sitter-gosu](https://github.com/rcw3bb/tree-sitter-gosu) |
 
 ### Arguments
 
@@ -103,6 +103,8 @@ python -m codeecho <path> [options]
 | `--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). |
+| `--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). |
 | `--version` | | Print the version and exit. |
 | `-h, --help` | | Show help and exit. |
 
@@ -138,16 +140,39 @@ Exclude test and vendor directories:
 python -m codeecho . --exclude "*/tests/*" --exclude "*/vendor/*"
 ```
 
+Scan targets listed in a file, one path per line:
+
+```powershell
+python -m codeecho targets.txt --target-list
+```
+
+Find where code from a reference/basis set of files is duplicated elsewhere in the codebase:
+
+```powershell
+python -m codeecho src --basis basis.txt
+```
+
 ## 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. |
+| `CODEECHO_CONFIG_DIR` | Directory where `logging.ini`, `.ignore`, and `config.ini` 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.
 
+### Overriding the ignore filename
+
+`config.ini` (also seeded into `CODEECHO_CONFIG_DIR` on first run) contains an `[override]` section with an `ignore-file` key, which names the file used in place of `.ignore`, resolved relative to `CODEECHO_CONFIG_DIR`:
+
+```ini
+[override]
+ignore-file = .ignore
+```
+
+Point `ignore-file` at a different filename to use an alternate ignore file (also placed inside `CODEECHO_CONFIG_DIR`). If the configured file is missing, codeecho logs a warning and falls back to the bundled `.ignore`.
+
 ## Development
 
 ### Prerequisites
@@ -196,11 +221,11 @@ poetry run pylint codeecho
 poetry run pytest --cov=codeecho tests --cov-report html
 ```
 
-## [Changelog](CHANGELOG.md)
+## [Changelog](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md)
 
 ## License
 
-This project is licensed under the [MIT License](LICENSE).
+This project is licensed under the [MIT License](https://github.com/rcw3bb/codeecho/blob/main/LICENSE).
 
 ## Author
 

{codeecho-1.0.1 → codeecho-1.2.0}/README.md

@@ -1,9 +1,8 @@
-# codeecho 1.0.1
+# codeecho 1.2.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)](https://github.com/rcw3bb/codeecho/blob/main/LICENSE) [![Version](https://img.shields.io/badge/Version-1.2.0-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)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.0.1-blue.svg)](CHANGELOG.md)
+> 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.
 
 ## Prerequisites
 
@@ -31,14 +30,14 @@ python -m codeecho <path> [options]
 
 ### Supported languages
 
-| Language | Extensions |
-|----------|-----------|
-| Python | `.py` |
-| JavaScript | `.js`, `.mjs`, `.cjs` |
-| TypeScript | `.ts`, `.tsx` |
-| Java | `.java` |
-| Go | `.go` |
-| Gosu | `.gs`, `.gsx` |
+| Language | Extensions | Grammar |
+|----------|-----------|--------|
+| Python | `.py` | [tree-sitter-python](https://github.com/tree-sitter/tree-sitter-python) |
+| JavaScript | `.js`, `.mjs`, `.cjs` | [tree-sitter-javascript](https://github.com/tree-sitter/tree-sitter-javascript) |
+| TypeScript | `.ts`, `.tsx` | [tree-sitter-typescript](https://github.com/tree-sitter/tree-sitter-typescript) |
+| Java | `.java` | [tree-sitter-java](https://github.com/tree-sitter/tree-sitter-java) |
+| Go | `.go` | [tree-sitter-go](https://github.com/tree-sitter/tree-sitter-go) |
+| Gosu | `.gs`, `.gsx` | [tree-sitter-gosu](https://github.com/rcw3bb/tree-sitter-gosu) |
 
 ### Arguments
 
@@ -58,6 +57,8 @@ python -m codeecho <path> [options]
 | `--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). |
+| `--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). |
 | `--version` | | Print the version and exit. |
 | `-h, --help` | | Show help and exit. |
 
@@ -93,16 +94,39 @@ Exclude test and vendor directories:
 python -m codeecho . --exclude "*/tests/*" --exclude "*/vendor/*"
 ```
 
+Scan targets listed in a file, one path per line:
+
+```powershell
+python -m codeecho targets.txt --target-list
+```
+
+Find where code from a reference/basis set of files is duplicated elsewhere in the codebase:
+
+```powershell
+python -m codeecho src --basis basis.txt
+```
+
 ## 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. |
+| `CODEECHO_CONFIG_DIR` | Directory where `logging.ini`, `.ignore`, and `config.ini` 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.
 
+### Overriding the ignore filename
+
+`config.ini` (also seeded into `CODEECHO_CONFIG_DIR` on first run) contains an `[override]` section with an `ignore-file` key, which names the file used in place of `.ignore`, resolved relative to `CODEECHO_CONFIG_DIR`:
+
+```ini
+[override]
+ignore-file = .ignore
+```
+
+Point `ignore-file` at a different filename to use an alternate ignore file (also placed inside `CODEECHO_CONFIG_DIR`). If the configured file is missing, codeecho logs a warning and falls back to the bundled `.ignore`.
+
 ## Development
 
 ### Prerequisites
@@ -151,11 +175,11 @@ poetry run pylint codeecho
 poetry run pytest --cov=codeecho tests --cov-report html
 ```
 
-## [Changelog](CHANGELOG.md)
+## [Changelog](https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md)
 
 ## License
 
-This project is licensed under the [MIT License](LICENSE).
+This project is licensed under the [MIT License](https://github.com/rcw3bb/codeecho/blob/main/LICENSE).
 
 ## Author
 

{codeecho-1.0.1 → codeecho-1.2.0}/codeecho/__init__.py

@@ -2,21 +2,25 @@
 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.
+
+:author: Ron Webb
+:since: 1.0.0
 """
 
 from env_dir_bootstrap import EnvDirBootstrap
 from logenrich import setup_logger
 
-__version__ = "1.0.1"
+__version__ = "1.2.0"
 
 _bootstrapper = EnvDirBootstrap(
     env_var="CODEECHO_CONFIG_DIR",
-    resources=["logging.ini", ".ignore"],
+    resources=["logging.ini", ".ignore", "config.ini"],
     package="codeecho",
 )
 
 _bootstrapper.setup()
 
 CONF_DIR = str(_bootstrapper.get_dir())
+DEFAULT_IGNORE_PATH = _bootstrapper.resolve(".ignore")
 
 setup_logger("codeecho", conf_dir=CONF_DIR)