codeecho 1.1.0__tar.gz → 1.2.1__tar.gz

codeecho-1.2.1/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+## 1.2.1 - 2026-09-19
+
+### Changed
+
+- Packaging metadata updated for publishing to PyPI: added `keywords`, `classifiers`,
+  and `[project.urls]` (Homepage, Repository, Documentation, Bug Tracker, Changelog).
+- License declared via the SPDX `license = "MIT"` string with `license-files = ["LICENSE"]`
+  instead of the deprecated `{file = "LICENSE"}` table, and the redundant MIT classifier
+  was dropped.
+- The `codeecho` console entry point moved from `[tool.poetry.scripts]` to `[project.scripts]`.
+
+## 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.1.0 → codeecho-1.2.1}/PKG-INFO

@@ -1,34 +1,20 @@
 Metadata-Version: 2.4
 Name: codeecho
-Version: 1.1.0
+Version: 1.2.1
 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-Expression: MIT
 License-File: LICENSE
+Keywords: code-duplication,clone-detection,refactoring,static-analysis,tree-sitter
 Author: Ron Webb
 Requires-Python: >=3.14
-Classifier: License :: Other/Proprietary License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Libraries
 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)
@@ -42,14 +28,18 @@ 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)
+Project-URL: Changelog, https://github.com/rcw3bb/codeecho/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/rcw3bb/codeecho#readme
+Project-URL: Homepage, https://github.com/rcw3bb/codeecho
+Project-URL: Issues, https://github.com/rcw3bb/codeecho/issues
+Project-URL: Repository, https://github.com/rcw3bb/codeecho
 Description-Content-Type: text/markdown
 
-# codeecho 1.1.0
+# 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.
+[![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.1-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.1.0-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
 
@@ -104,6 +94,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. |
 
@@ -139,16 +131,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
@@ -197,11 +212,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.1.0 → codeecho-1.2.1}/README.md

@@ -1,9 +1,8 @@
-# codeecho 1.1.0
+# 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.
+[![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.1-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.1.0-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
 
@@ -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.1.0 → codeecho-1.2.1}/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.1.0"
+__version__ = "1.2.1"
 
 _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)