codeclone 1.1.0__py3-none-any.whl → 1.2.1__py3-none-any.whl

{codeclone-1.1.0.dist-info → codeclone-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeclone
-Version: 1.1.0
+Version: 1.2.1
 Summary: AST and CFG-based code clone detector for Python focused on architectural duplication
 Author-email: Den Rozhnovskiy <pytelemonbot@mail.ru>
 Maintainer-email: Den Rozhnovskiy <pytelemonbot@mail.ru>
@@ -10,11 +10,10 @@ Project-URL: Repository, https://github.com/orenlab/codeclone
 Project-URL: Issues, https://github.com/orenlab/codeclone/issues
 Project-URL: Changelog, https://github.com/orenlab/codeclone/releases
 Project-URL: Documentation, https://github.com/orenlab/codeclone/tree/main/docs
-Keywords: python,ast,code-clone,duplication,static-analysis,ci,architecture
+Keywords: python,ast,cfg,code-clone,duplication,static-analysis,architecture,control-flow,ci
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
 Classifier: License :: OSI Approved :: MIT License
@@ -23,26 +22,31 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pygments>=2.19.2
+Requires-Dist: rich>=14.3.2
 Provides-Extra: dev
 Requires-Dist: pytest>=9.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.1.0; extra == "dev"
 Requires-Dist: build>=1.2.0; extra == "dev"
 Requires-Dist: twine>=5.0.0; extra == "dev"
 Requires-Dist: mypy>=1.19.1; extra == "dev"
+Requires-Dist: ruff>=0.12.0; extra == "dev"
 Dynamic: license-file
 
 # CodeClone
 
 [![PyPI](https://img.shields.io/pypi/v/codeclone.svg)](https://pypi.org/project/codeclone/)
 [![Downloads](https://img.shields.io/pypi/dm/codeclone.svg)](https://pypi.org/project/codeclone/)
+[![tests](https://github.com/orenlab/codeclone/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/orenlab/codeclone/actions/workflows/tests.yml)
 [![Python](https://img.shields.io/pypi/pyversions/codeclone.svg)](https://pypi.org/project/codeclone/)
 [![License](https://img.shields.io/pypi/l/codeclone.svg)](LICENSE)
 
-**CodeClone** is a Python code clone detector based on **normalized AST and control-flow graphs (CFG)**.
+**CodeClone** is a Python code clone detector based on **normalized Python AST and Control Flow Graphs (CFG)**.
 It helps teams discover architectural duplication and prevent new copy-paste from entering the codebase via CI.
 
 CodeClone is designed to help teams:
@@ -51,15 +55,16 @@ CodeClone is designed to help teams:
 - identify architectural hotspots,
 - prevent *new* duplication via CI and pre-commit hooks.
 
-Unlike token- or text-based tools, CodeClone operates on **normalized Python AST and CFG**, making it robust against renaming,
-formatting, and minor refactoring.
+Unlike token- or text-based tools, CodeClone operates on **normalized Python AST and CFG**, making it robust against
+renaming, formatting, and minor refactoring.
 
 ---
 
 ## Why CodeClone?
 
 Most existing tools detect *textual* duplication.
-CodeClone detects **structural and block-level duplication**, which usually signals missing abstractions or architectural drift.
+CodeClone detects **structural and block-level duplication**, which usually signals missing abstractions or
+architectural drift.
 
 Typical use cases:
 
@@ -77,11 +82,11 @@ Typical use cases:
 - Detects functions and methods with identical **control-flow structure**.
 - Based on **Control Flow Graph (CFG)** fingerprinting.
 - Robust to:
-  - variable renaming,
-  - constant changes,
-  - attribute renaming,
-  - formatting differences,
-  - docstrings and type annotations.
+    - variable renaming,
+    - constant changes,
+    - attribute renaming,
+    - formatting differences,
+    - docstrings and type annotations.
 - Ideal for spotting architectural duplication across layers.
 
 ### Block-level clone detection (Type-3-lite)
@@ -89,24 +94,29 @@ Typical use cases:
 - Detects repeated **statement blocks** inside larger functions.
 - Uses sliding windows over CFG-normalized statement sequences.
 - Targets:
-  - validation blocks,
-  - guard clauses,
-  - repeated orchestration logic.
+    - validation blocks,
+    - guard clauses,
+    - repeated orchestration logic.
 - Carefully filtered to reduce noise:
-  - no overlapping windows,
-  - no clones inside the same function,
-  - no `__init__` noise,
-  - size and statement-count thresholds.
+    - no overlapping windows,
+    - no clones inside the same function,
+    - no `__init__` noise,
+    - size and statement-count thresholds.
 
 ### Control-Flow Awareness (CFG v1)
 
 - Each function is converted into a **Control Flow Graph**.
 - CFG nodes contain normalized AST statements.
-- CFG edges represent structural control flow (`if`, `for`, `while`).
+- CFG edges represent structural control flow:
+    - `if` / `else`
+    - `for` / `async for` / `while`
+    - `try` / `except` / `finally`
+    - `with` / `async with`
+    - `match` / `case` (Python 3.10+)
 - Current CFG semantics (v1):
-  - `break` and `continue` are treated as statements (no jump targets),
-  - after-blocks are explicit and always present,
-  - focus is on **structural similarity**, not precise runtime semantics.
+    - `break` and `continue` are treated as statements (no jump targets),
+    - after-blocks are explicit and always present,
+    - focus is on **structural similarity**, not precise runtime semantics.
 
 This design keeps clone detection **stable, deterministic, and low-noise**.
 
@@ -115,6 +125,7 @@ This design keeps clone detection **stable, deterministic, and low-noise**.
 - AST + CFG normalization instead of token matching.
 - Conservative defaults tuned for real-world Python projects.
 - Explicit thresholds for size and statement count.
+- No probabilistic scoring or heuristic similarity thresholds.
 - Focus on *architectural duplication*, not micro-similarities.
 
 ### CI-friendly baseline mode
@@ -154,14 +165,14 @@ Generate reports:
 
 ```bash
 codeclone . \
-  --json-out .cache/codeclone/report.json \
-  --text-out .cache/codeclone/report.txt
+  --json .cache/codeclone/report.json \
+  --text .cache/codeclone/report.txt
 ```
 
 Generate an HTML report:
 
 ```bash
-codeclone . --html-out .cache/codeclone/report.html
+codeclone . --html .cache/codeclone/report.html
 ```
 
 ---
@@ -181,14 +192,26 @@ Commit the generated baseline file to the repository.
 ### 2. Use in CI
 
 ```bash
-codeclone . --fail-on-new
+codeclone . --fail-on-new --no-progress
 ```
 
 Behavior:
 
-- ✅ existing clones are allowed,
-- ❌ build fails if *new* clones appear,
-- ✅ refactoring that removes duplication is always allowed.
+- existing clones are allowed,
+- the build fails if *new* clones appear,
+- refactoring that removes duplication is always allowed.
+
+`--fail-on-new` exits with a non-zero code when new clones are detected.
+
+### Python Version Consistency for Baseline Checks
+
+Due to inherent differences in Python’s AST between interpreter versions, baseline
+generation and verification must be performed using the same Python version.
+
+This ensures deterministic and reproducible clone detection results.
+
+CI checks therefore pin baseline verification to a single Python version, while the
+test matrix continues to validate compatibility across Python 3.10–3.14.
 
 ---
 
@@ -196,14 +219,14 @@ Behavior:
 
 ```yaml
 repos:
--   repo: local
+  - repo: local
     hooks:
-    -   id: codeclone
+      - id: codeclone
         name: CodeClone
         entry: codeclone
         language: python
-        args: [".", "--fail-on-new"]
-        types: [python]
+        args: [ ".", "--fail-on-new" ]
+        types: [ python ]
 ```
 
 ---
@@ -235,6 +258,10 @@ repos:
 5. Detect function-level and block-level clones.
 6. Apply conservative filters to suppress noise.
 
+See the architectural overview:
+
+- [docs/architecture.md](docs/architecture.md)
+
 ---
 
 ## Control Flow Graph (CFG)
@@ -245,6 +272,7 @@ to improve structural clone detection robustness.
 The CFG is a **structural abstraction**, not a runtime execution model.
 
 See full design and semantics:
+
 - [docs/cfg.md](docs/cfg.md)
 
 ---

codeclone-1.2.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+codeclone/__init__.py,sha256=M4X23w41G4ph6fx29JG3qrkkyWaTSwvCe5O6jeJvFd0,364
+codeclone/baseline.py,sha256=Y367RgcTlBwQxkQmm4gGwWft7yhp7u3BMeeWQsZgV6I,2533
+codeclone/blockhash.py,sha256=0vavcw3nkg7IIIqqYRObVmzHSJSC3tbzmiVqqr21miA,594
+codeclone/blocks.py,sha256=BAWb9iPvSWYggQr9SlWIpb-7lyvVvrW0dxjTEnKdm0o,1796
+codeclone/cache.py,sha256=3Ky4ubZZsDvHTwqSRPQ9nPl4t4eCsUtiXCWeNBOZfIo,5493
+codeclone/cfg.py,sha256=XJWb2fcKxa3f6ffRMrQroX6QzkPcByZPNwjhsebbx2g,8236
+codeclone/cfg_model.py,sha256=D2KK4OZrVV-OCwFECw-Ej_u32uekNgj6pdTqCvZa5H0,1170
+codeclone/cli.py,sha256=SjoTSBDNyrjlNhTMze_-Y1GvuZ1nB4wVa027y9XiOgc,20550
+codeclone/errors.py,sha256=3QRu2IR8I-VgJLkT3B9DZ0fW4Sxi-EnBYVUeX3rfWhw,556
+codeclone/extractor.py,sha256=LixKDPJpP2V1UIwW0vsFJm6BKr1NijD8BCGJB3I9lds,6946
+codeclone/fingerprint.py,sha256=H0YY209sfGf02VeLlxHNDp7n6es0vLiMmq3TBWDm3SE,545
+codeclone/html_report.py,sha256=OwVRt4o3DZ17RMDgzI5578bqbyHLqC0mnedmDlYWwag,16369
+codeclone/normalize.py,sha256=BOTgJS5NmJxgBwHFxkqWqRNL1uk9rJtjdeQtSgFscS8,4461
+codeclone/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codeclone/report.py,sha256=g8EiUksjrQXjJch8-KfJT-IsMkONNnuaj1rNOIfPDbE,2153
+codeclone/scanner.py,sha256=44YbL9fiDauNgwrMbnLijoH3CMWInro4vBsIlBLQu-M,2669
+codeclone/templates.py,sha256=UDEzE_X7n5eWU1CyXChxNhVPM6j3OvVBYDlWcyQaY7I,29375
+codeclone-1.2.1.dist-info/licenses/LICENSE,sha256=ndXAbunvN-jCQjgCaoBOF5AN4FcRlAa0R7hK1lWDuBU,1073
+codeclone-1.2.1.dist-info/METADATA,sha256=Xxe9hqv01xYFZpjmS0gmzAGzobMV5Cyb_MvvkzjL1Vs,8110
+codeclone-1.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+codeclone-1.2.1.dist-info/entry_points.txt,sha256=_MI9DVTLOmv3OlxpyogdOmMAduiLVIdHeOlZ_KBsrIY,49
+codeclone-1.2.1.dist-info/top_level.txt,sha256=4tQa_d-4Zle-qV9KmNDkWq0WHYgZsW9vdaeF30rNntg,10
+codeclone-1.2.1.dist-info/RECORD,,

{codeclone-1.1.0.dist-info → codeclone-1.2.1.dist-info}/WHEEL

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

codeclone-1.1.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-codeclone/__init__.py,sha256=_MZuqgioYGn49qw6_OluedgcRvuu8IhAwVgHkM4Kj7s,364
-codeclone/baseline.py,sha256=VdIh5AeWeAod6MZ1EV2UWMlvlhwHwlbyUJM_RXbhf24,1545
-codeclone/blockhash.py,sha256=jOswW9jqe9ww3y4r-gLTUZjMmn0CHXpU5qTtFndKQ10,594
-codeclone/blocks.py,sha256=Y75BSpzf-zyyeD9-vKnQfJ3QwIjYxMwiN9DbEqnbONg,1735
-codeclone/cache.py,sha256=PZ9XgHc3A-JSGXHYQHJK_Ldu24EIaGL7Spi2cTpbEUo,1334
-codeclone/cfg.py,sha256=e4zCfHeqWRvxIN1E4D-t_717ZftQY7XlwgYBfFaa9oU,4794
-codeclone/cli.py,sha256=Zp6e7PC-9WJIBkqX88V-4L7wryi1c2qPB87Pbpo4BfE,5177
-codeclone/extractor.py,sha256=crCxgkK1n2fl5FUz6HtbaEZUH5CO8S0zqM0Xj0RSE6E,4558
-codeclone/fingerprint.py,sha256=H0YY209sfGf02VeLlxHNDp7n6es0vLiMmq3TBWDm3SE,545
-codeclone/html_report.py,sha256=Es4lYOMm24O2UTsaF59qjvCxLA2nwojwLX-zOpvluro,24337
-codeclone/normalize.py,sha256=AzKE-1kOrOV3LVK8x4gGytulxXVYBkB0W_3oIqiRWS8,3236
-codeclone/report.py,sha256=2Yu9267M2GLYKqsMAD4mrTUWhTbHP6_fIOGqhtDkxL0,1912
-codeclone/scanner.py,sha256=BdJFyaLv1xvimVkJyvvTN0FcG2RQZzRlTlHWi2fRQnU,1050
-codeclone-1.1.0.dist-info/licenses/LICENSE,sha256=ndXAbunvN-jCQjgCaoBOF5AN4FcRlAa0R7hK1lWDuBU,1073
-codeclone-1.1.0.dist-info/METADATA,sha256=J2l_qX6VxJ_WRCK87KJPuzdVlFI5hcFR9lWjMzuQ55w,6984
-codeclone-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-codeclone-1.1.0.dist-info/entry_points.txt,sha256=_MI9DVTLOmv3OlxpyogdOmMAduiLVIdHeOlZ_KBsrIY,49
-codeclone-1.1.0.dist-info/top_level.txt,sha256=4tQa_d-4Zle-qV9KmNDkWq0WHYgZsW9vdaeF30rNntg,10
-codeclone-1.1.0.dist-info/RECORD,,