didibreak 0.1.0__tar.gz

didibreak-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtual environments
+.venv/
+
+# Build output
+build/
+dist/
+*.egg-info/
+
+# Generated at build time from spec/prompts/ (python/scripts/sync_prompts.py)
+python/src/didibreak/prompts/
+
+# Copied from the root LICENSE at build time (python/hatch_build.py)
+python/LICENSE
+
+# didibreak output when run on this repository
+.didibreak/
+
+# OS and editor files
+.DS_Store
+.idea/
+.vscode/

didibreak-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Levan Changelia
+
+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.

didibreak-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.5
+Name: didibreak
+Version: 0.1.0
+Summary: Find unintended behavior changes in Python code by running the old and new versions side by side.
+Project-URL: Homepage, https://github.com/changelia/didibreak
+Project-URL: Documentation, https://github.com/changelia/didibreak/tree/main/docs
+Project-URL: Changelog, https://github.com/changelia/didibreak/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/changelia/didibreak/issues
+Author: changelia
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai agents,behavior change,differential testing,llm,regression,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: httpx<1,>=0.28
+Description-Content-Type: text/markdown
+
+# didibreak (Python)
+
+didibreak finds unintended behavior changes in Python code changes. It runs the
+old and new versions of each changed function on the same generated inputs and
+reports where the results differ.
+
+```bash
+pip install didibreak
+export OPENAI_API_KEY="sk-..."    # or ANTHROPIC_API_KEY (experimental, not live-verified)
+didibreak check --intent "what the change should do"
+```
+
+Requires Python 3.11 or newer, Linux or macOS, and git. Version 0.1.0 is the
+first release (alpha). No telemetry: the only network requests go to the LLM
+provider you configure, with your own API key.
+
+Full documentation: https://github.com/changelia/didibreak/tree/main/docs

didibreak-0.1.0/README.md

@@ -0,0 +1,17 @@
+# didibreak (Python)
+
+didibreak finds unintended behavior changes in Python code changes. It runs the
+old and new versions of each changed function on the same generated inputs and
+reports where the results differ.
+
+```bash
+pip install didibreak
+export OPENAI_API_KEY="sk-..."    # or ANTHROPIC_API_KEY (experimental, not live-verified)
+didibreak check --intent "what the change should do"
+```
+
+Requires Python 3.11 or newer, Linux or macOS, and git. Version 0.1.0 is the
+first release (alpha). No telemetry: the only network requests go to the LLM
+provider you configure, with your own API key.
+
+Full documentation: https://github.com/changelia/didibreak/tree/main/docs

didibreak-0.1.0/hatch_build.py

@@ -0,0 +1,58 @@
+"""Hatch hooks that copy shared repository files into the Python project.
+
+- The metadata hook copies the root LICENSE to python/LICENSE. It must run in
+  the metadata phase: Hatch resolves ``license-files`` when it builds the
+  metadata, before any build hook runs.
+- The build hook copies spec/prompts/ into src/didibreak/prompts/ before each
+  sdist, wheel and editable build.
+
+When building from an extracted sdist there is no repository around the
+project; the sdist already contains both copies, so the hooks leave them as
+they are.
+"""
+
+import importlib.util
+import shutil
+from pathlib import Path
+from types import ModuleType
+from typing import Any
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+from hatchling.metadata.plugin.interface import MetadataHookInterface
+
+
+def _load_sync_prompts(project_root: Path) -> ModuleType:
+    script = project_root / "scripts" / "sync_prompts.py"
+    module_spec = importlib.util.spec_from_file_location("sync_prompts", script)
+    if module_spec is None or module_spec.loader is None:
+        raise RuntimeError(f"Cannot load {script}")
+    module = importlib.util.module_from_spec(module_spec)
+    module_spec.loader.exec_module(module)
+    return module
+
+
+class LicenseCopyMetadataHook(MetadataHookInterface):
+    """Copy the repository LICENSE so ``license-files`` can find it."""
+
+    PLUGIN_NAME = "custom"
+
+    def update(self, metadata: dict[str, Any]) -> None:
+        """Copy the license; the metadata itself is left unchanged."""
+        project_root = Path(self.root)
+        repository_license = project_root.parent / "LICENSE"
+        if repository_license.is_file():
+            shutil.copyfile(repository_license, project_root / "LICENSE")
+
+
+class PromptCopyBuildHook(BuildHookInterface):
+    """Copy the shared prompt templates into src/didibreak/prompts/."""
+
+    PLUGIN_NAME = "custom"
+
+    def initialize(self, version: str, build_data: dict[str, Any]) -> None:
+        """Copy the prompts before Hatch collects the files to build."""
+        sync_prompts = _load_sync_prompts(Path(self.root))
+        if sync_prompts.SPEC_PROMPTS.is_dir():
+            sync_prompts.copy_prompts(
+                sync_prompts.SPEC_PROMPTS, sync_prompts.PACKAGE_PROMPTS
+            )

didibreak-0.1.0/pyproject.toml

@@ -0,0 +1,100 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "didibreak"
+dynamic = ["version"]
+description = "Find unintended behavior changes in Python code by running the old and new versions side by side."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "changelia" }]
+keywords = ["behavior change", "regression", "testing", "llm", "ai agents", "differential testing"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = [
+    "httpx>=0.28,<1",
+]
+
+[project.urls]
+Homepage = "https://github.com/changelia/didibreak"
+Documentation = "https://github.com/changelia/didibreak/tree/main/docs"
+Changelog = "https://github.com/changelia/didibreak/blob/main/CHANGELOG.md"
+Issues = "https://github.com/changelia/didibreak/issues"
+
+[project.scripts]
+didibreak = "didibreak.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "ruff",
+    "mypy",
+    "jsonschema==4.26.0",  # dev only: validates reports against spec/report.schema.json
+]
+
+[tool.ruff]
+target-version = "py311"
+# Fixture repositories hold sample user code, some of it deliberately
+# unformatted; they are data, not project code.
+extend-exclude = ["tests/fixtures"]
+
+[tool.ruff.lint]
+# Rule set from the Code quality standards.
+select = ["E", "F", "W", "I", "B", "UP", "SIM", "RUF", "D"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+# Test names describe the behavior; docstrings on each test add nothing.
+"tests/**" = ["D1"]
+
+[tool.mypy]
+strict = true
+python_version = "3.11"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["-ra", "--strict-markers", "--strict-config"]
+xfail_strict = true
+
+[tool.hatch.version]
+path = "src/didibreak/__init__.py"
+
+[tool.hatch.build]
+# Copied from the repository at build time (git-ignored) but must be packaged.
+artifacts = ["src/didibreak/prompts/", "/LICENSE"]
+
+[tool.hatch.metadata.hooks.custom]
+# hatch_build.py: copies the root LICENSE to python/LICENSE.
+
+[tool.hatch.build.hooks.custom]
+# hatch_build.py: copies spec/prompts/ into src/didibreak/prompts/.
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/didibreak"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/didibreak",
+  "tests",
+  "scripts",
+  "hatch_build.py",
+  "README.md",
+  "LICENSE",
+]

didibreak-0.1.0/scripts/check_dist.py

@@ -0,0 +1,103 @@
+"""Check the contents of the built wheel and sdist in a dist/ folder.
+
+The packages must contain only the Python package (no spec/, docs/ or JS
+files, except the copied prompts) and must ship the license. CI runs this
+after ``uv build``; it uses only the standard library.
+"""
+
+import argparse
+import sys
+import tarfile
+import zipfile
+from collections.abc import Sequence
+from pathlib import Path
+
+_FORBIDDEN_SDIST_FOLDERS = ("spec/", "docs/", "js/")
+
+
+def check_wheel(wheel: Path) -> list[str]:
+    """List problems in a wheel; empty when it is correct.
+
+    Args:
+        wheel: Path to the ``.whl`` file.
+
+    Returns:
+        One human-readable line per problem.
+    """
+    with zipfile.ZipFile(wheel) as archive:
+        names = archive.namelist()
+    problems = [
+        f"unexpected file in wheel: {name}"
+        for name in names
+        if not name.startswith("didibreak/") and ".dist-info/" not in name
+    ]
+    if not any(name.endswith(".dist-info/licenses/LICENSE") for name in names):
+        problems.append("wheel has no .dist-info/licenses/LICENSE")
+    return problems
+
+
+def check_sdist(sdist: Path) -> list[str]:
+    """List problems in an sdist; empty when it is correct.
+
+    Args:
+        sdist: Path to the ``.tar.gz`` file.
+
+    Returns:
+        One human-readable line per problem.
+    """
+    with tarfile.open(sdist) as archive:
+        members = archive.getmembers()
+        pkg_info = next((m for m in members if m.name.endswith("/PKG-INFO")), None)
+        metadata = ""
+        if pkg_info is not None:
+            extracted = archive.extractfile(pkg_info)
+            if extracted is not None:
+                metadata = extracted.read().decode("utf-8")
+    # Member names start with the "<name>-<version>/" folder.
+    relative_names = [m.name.partition("/")[2] for m in members]
+    problems = [
+        f"unexpected file in sdist: {name}"
+        for name in relative_names
+        if name.startswith(_FORBIDDEN_SDIST_FOLDERS)
+    ]
+    if "LICENSE" not in relative_names:
+        problems.append("sdist has no LICENSE")
+    if "License-File: LICENSE" not in metadata.splitlines():
+        problems.append("sdist PKG-INFO has no 'License-File: LICENSE'")
+    return problems
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Check the single wheel and sdist in the given folder.
+
+    Args:
+        argv: Arguments without the program name. Defaults to ``sys.argv[1:]``.
+
+    Returns:
+        0 when both archives are correct, 1 otherwise.
+    """
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    parser.add_argument("dist_dir", type=Path, help="folder written by uv build")
+    arguments = parser.parse_args(argv)
+
+    wheels = sorted(arguments.dist_dir.glob("*.whl"))
+    sdists = sorted(arguments.dist_dir.glob("*.tar.gz"))
+    if len(wheels) != 1 or len(sdists) != 1:
+        print(
+            f"Expected one wheel and one sdist in {arguments.dist_dir}, "
+            f"found {len(wheels)} and {len(sdists)}.",
+            file=sys.stderr,
+        )
+        return 1
+
+    problems = check_wheel(wheels[0]) + check_sdist(sdists[0])
+    for problem in problems:
+        print(problem, file=sys.stderr)
+    if problems:
+        return 1
+    print(f"OK: {wheels[0].name}, {sdists[0].name}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())