codeclone 1.0.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

codeclone-1.0.0.dist-info/METADATA

@@ -1,211 +0,0 @@
-Metadata-Version: 2.4
-Name: codeclone
-Version: 1.0.0
-Summary: AST-based code clone detector for Python focused on architectural duplication
-Author-email: Den Rozhnovskiy <pytelemonbot@mail.ru>
-Maintainer-email: Den Rozhnovskiy <pytelemonbot@mail.ru>
-License: MIT
-Project-URL: Homepage, https://github.com/orenlab/codeclone
-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
-Keywords: python,ast,code-clone,duplication,static-analysis,ci,architecture
-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: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-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: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: dev
-Requires-Dist: pytest>=9.0.0; extra == "dev"
-Requires-Dist: build>=1.2.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
-Dynamic: license-file
-
-# CodeClone
-
-**CodeClone** is an AST-based code clone detector for Python, focused on **architectural duplication**, not simple
-copy-paste.
-
-It is designed to help teams:
-
-- discover structural and logical code duplication,
-- understand architectural hotspots,
-- and prevent *new* duplication from entering the codebase via CI.
-
-Unlike token- or text-based tools, CodeClone works on **normalized Python AST**, which makes it robust against renaming,
-formatting, and minor refactoring.
-
----
-
-## Why CodeClone?
-
-Most existing tools detect *textual* duplication.
-CodeClone detects **structural and block-level duplication** that usually indicates missing abstractions or
-architectural drift.
-
-Typical use cases:
-
-- duplicated service logic across layers (API ↔ application),
-- repeated validation or guard blocks,
-- copy-pasted request/handler flows,
-- duplicated orchestration logic in routers, handlers, or services.
-
----
-
-## Features
-
-### Function-level clone detection (Type-2)
-
-- Detects functions and methods with identical structure.
-- Robust to:
-    - variable renaming,
-    - constant changes,
-    - formatting differences.
-- Ideal for spotting architectural duplication between layers.
-
-### Block-level clone detection (Type-3-lite)
-
-- Detects repeated **statement blocks** inside larger functions.
-- Targets:
-    - validation blocks,
-    - guard clauses,
-    - repeated orchestration logic.
-- Carefully filtered to avoid noise:
-    - no overlapping windows,
-    - no clones inside the same function,
-    - no `__init__` noise.
-
-### Low-noise by design
-
-- AST normalization instead of token matching.
-- Size and statement-count thresholds.
-- Conservative defaults tuned for real-world Python projects.
-
-### CI-friendly baseline mode
-
-- Establish a baseline of existing clones.
-- Fail CI **only when new clones are introduced**.
-- Safe for legacy codebases.
-
----
-
-## Installation
-
-```bash
-pip install codeclone
-```
-
-Python 3.10+ is required.
-
-⸻
-
-Quick Start
-
-Run on a project:
-
-```bash
-codeclone .
-```
-
-This will:
-
-* scan Python files,
-* detect function-level and block-level clones,
-* print a summary to stdout.
-
-Generate reports:
-
-```bash
-codeclone . \
-  --json-out .cache/codeclone/report.json \
-  --text-out .cache/codeclone/report.txt
-```
-
-⸻
-
-Baseline Workflow (Recommended)
-
-1. Create a baseline
-
-Run once on your current codebase:
-
-```bash
-codeclone . --update-baseline
-```
-
-This creates a file:
-
-```bash
-.codeclone-baseline.json
-```
-
-Commit this file to the repository.
-
-⸻
-
-2. Use in CI
-
-In CI, run:
-
-```bash
-codeclone . --fail-on-new
-```
-
-Behavior:
-
-* ✅ existing clones are allowed,
-* ❌ build fails if new function or block clones appear,
-* ✅ refactoring that removes duplication is always allowed.
-
-This enables gradual improvement without breaking existing development flow.
-
-⸻
-
-What CodeClone Is (and Is Not)
-
-CodeClone is
-
-* an architectural analysis tool,
-* a duplication radar,
-* a CI guard against copy-paste.
-
-CodeClone is not
-
-* a linter,
-* a formatter,
-* a replacement for SonarQube or static analyzers,
-* a semantic equivalence prover.
-
-It intentionally focuses on high-signal duplication.
-
-⸻
-
-How It Works (High Level)
-
-* Parses Python source into AST.
-* Normalizes:
-    - variable names,
-    - constants,
-    - attributes,
-    - docstrings and annotations.
-* Computes stable structural fingerprints.
-* Detects:
-    - identical function structures,
-    - repeated statement blocks across functions.
-* Applies filters to suppress noise.
-
-⸻
-
-License
-
-MIT License

codeclone-1.0.0.dist-info/RECORD

@@ -1,17 +0,0 @@
-codeclone/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-codeclone/baseline.py,sha256=1848Ugh4l3czOUIgXN68oPx_tu2nzbnnZQUixD1OXXA,1367
-codeclone/blockhash.py,sha256=QewX6jSCc7Q2tDsBXicFGzaMzKPb2S6unMEZEvwuwDs,414
-codeclone/blocks.py,sha256=6nXELQsH2OKl7ScNyLQiR7rMY2jfnsnGTt5_yXbwh3Y,1533
-codeclone/cache.py,sha256=kiqfj5V3evW3hyhKMVqW7EFUiN9AO4mntFPUzfXAjsA,1156
-codeclone/cli.py,sha256=uggGIVDw2QLQKKh5BsZYb2XGpe0ysEsQKx-7JDcepXA,4526
-codeclone/extractor.py,sha256=ubMfYfM87F1apEmzBnnv9W4daY7Gv2nQHthiNoeTTno,2884
-codeclone/fingerprint.py,sha256=pSucv648MGe6LwNczxJBbQjnAOcpHgkXSokaHwGr5zw,364
-codeclone/normalize.py,sha256=hG__ZqJCtUMVIv7c_a9PHfzSVGDbrAIOH5JYXnLfuOk,2930
-codeclone/report.py,sha256=Ptgne99-nsyvAGyJL3SsPNH9fQLorV2mVf--a0KXfxE,1639
-codeclone/scanner.py,sha256=_xomEXvx1mLhMVRiMXW-gkBUV_9Z3GixFV5nK0Pqeq4,831
-codeclone-1.0.0.dist-info/licenses/LICENSE,sha256=ndXAbunvN-jCQjgCaoBOF5AN4FcRlAa0R7hK1lWDuBU,1073
-codeclone-1.0.0.dist-info/METADATA,sha256=F9-0TneuHJuI2USqeIgW0Ayrue4KVTL-5Um69vaN3-I,4993
-codeclone-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-codeclone-1.0.0.dist-info/entry_points.txt,sha256=_MI9DVTLOmv3OlxpyogdOmMAduiLVIdHeOlZ_KBsrIY,49
-codeclone-1.0.0.dist-info/top_level.txt,sha256=4tQa_d-4Zle-qV9KmNDkWq0WHYgZsW9vdaeF30rNntg,10
-codeclone-1.0.0.dist-info/RECORD,,