patchling 0.8.0__tar.gz → 0.9.0__tar.gz

{patchling-0.8.0 → patchling-0.9.0}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: patchling
-Version: 0.8.0
+Version: 0.9.0
 Summary: Natural-language code transformation as a library: generate unified diffs with LLMs and apply them resiliently with smartapply. Formerly gptdiff.
-Home-page: https://github.com/255BITS/patchling-py
 Author: 255labs
-Project-URL: Documentation, https://patchling.255labs.xyz
+License: MIT
+Project-URL: Homepage, https://github.com/255BITS/patchling-py
+Project-URL: Documentation, https://255bits.github.io/patchling-py
 Project-URL: Source, https://github.com/255BITS/patchling-py
 Project-URL: Browser/Node runtime (npm), https://www.npmjs.com/package/patchling
 Project-URL: Built with patchling (nanoodle), https://nanoodle.com
@@ -12,6 +13,7 @@ Keywords: patchling,smartapply,llm,diff,unified-diff,patch,code-transformation,a
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: openai>=1.0.0
@@ -23,17 +25,7 @@ Requires-Dist: pytest-mock; extra == "test"
 Provides-Extra: docs
 Requires-Dist: mkdocs; extra == "docs"
 Requires-Dist: mkdocs-material; extra == "docs"
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
 Dynamic: license-file
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: summary
 
 # Patchling
 
@@ -54,15 +46,10 @@ print(updated["main.py"])
 
 Files in, files out. No filesystem access required, no agent harness. The hard part — applying an LLM-generated diff that `git apply` would reject — is what `smartapply` solves: per-file, AI-assisted patch resolution that survives fuzzy hunks, renames, new files, and deletions.
 
-📚 Full documentation at [patchling.255labs.xyz](https://patchling.255labs.xyz)
+🌐 Project home: [patchling.app](https://patchling.app) — try it live in your browser · 📚 Full documentation at [255bits.github.io/patchling-py](https://255bits.github.io/patchling-py)
 
-Prefer the browser? **[patchling](https://github.com/255BITS/patchling)** is a JavaScript port of
-`generateDiff` + `smartapply` — try the **[live demos →](https://255bits.github.io/patchling-examples/)**.
-
-> **The patchling family** —
-> **patchling** (you are here) ·
-> [**patchling**](https://github.com/255BITS/patchling) (browser-first JS port) ·
-> [**patchling-examples**](https://github.com/255BITS/patchling-examples) (live browser demos)
+Prefer the browser? The same primitive ships on npm as **[patchling for JS](https://github.com/255BITS/patchling)**
+(`generateDiff` + `smartapply`, zero-dependency ESM) — try the **[live demos →](https://255bits.github.io/patchling-examples/)**.
 
 ---
 
@@ -72,12 +59,13 @@ The same primitive exists for every runtime, and it powers a real product:
 
 | Project | What it is |
 |---------|------------|
-| **patchling** (this repo) | Python library + CLI tools — [PyPI](https://pypi.org/project/patchling/) |
-| **[patchling](https://github.com/255BITS/patchling)** | Zero-dependency ESM port for browser and Node — `generateDiff` + `smartapply` on in-memory file maps |
+| **patchling for Python** (this repo) | Python library + CLI tools — [PyPI](https://pypi.org/project/patchling/) |
+| **[patchling for JS](https://github.com/255BITS/patchling)** | Zero-dependency ESM package for browser and Node — `generateDiff` + `smartapply` on in-memory file maps — [npm](https://www.npmjs.com/package/patchling) |
+| **[patchling.app](https://patchling.app)** | Project homepage with a live in-browser demo of the whole diff → smartapply loop |
 | **[nanoodle.com](https://nanoodle.com)** | Visual AI workflow editor built on patchling — no server, no signup, bring your own key. See the primitive working in production |
 | **[Live demos](https://255bits.github.io/patchling-examples/)** | Browser examples: LLM-edited games, 3D scenes, stream overlays, AI characters |
 
-Building for the browser? Start with [patchling](https://github.com/255BITS/patchling). Building a Python backend, pipeline, or your own agent? You're in the right repo.
+Building for the browser? Start with [patchling for JS](https://github.com/255BITS/patchling). Building a Python backend, pipeline, or your own agent? You're in the right repo.
 
 ---
 
@@ -128,10 +116,11 @@ See [examples/usage_example.py](examples/usage_example.py) for a runnable versio
 
 - `generate_diff(environment: str, goal: str, model: str = ...) -> str` — generates a unified diff implementing the goal. `model` defaults to the `GPTDIFF_MODEL` env var.
 - `smartapply(diff_text: str, files: dict[str, str], model: str = ...) -> dict[str, str]` — applies a diff with AI-powered conflict resolution. Handles new files, deletions, and hunks that standard patching rejects. Returns a new dict; input is not mutated.
-- `build_environment(files: dict[str, str]) -> str` — serializes a files dict into the environment string `generate_diff` expects.
+- `build_environment(files: dict[str, str]) -> str` — serializes a files dict into the environment string `generate_diff` expects. Pass `filter_relevant=True` and `task=` to drop files a cheap model marks irrelevant first.
+- `filter_relevant(files, task, model=..., concurrency=..., cache=...) -> FilterRelevantResult` — opt-in relevance filter for large directories. Each file is sent, with the task, to a cheap OpenAI-compatible model that answers yes/no. Only the `yes` files are returned for `generate_diff` and `smartapply`. The default model is `xiaomi/mimo-v2.6-flash` (Flask recall 1.0 and ~0.8x overhead figures are UNVERIFIED). The JS counterpart is `filterRelevant`.
 - `load_project_files(path, cwd) -> dict` / `save_files(files, base_dir)` — optional filesystem helpers for when you *do* want to read/write a real project (respects `.gitignore` and `.gptignore`).
 
-Full signatures, error handling, and edge cases: [API Reference](https://patchling.255labs.xyz/api).
+Full signatures, error handling, and edge cases: [API Reference](https://255bits.github.io/patchling-py/api).
 
 **Pipeline example** — sequential transformations over an in-memory codebase:
 
@@ -176,6 +165,7 @@ export GPTDIFF_SMARTAPPLY_MODEL='gpt5-mini'
 | `GPTDIFF_MODEL` | Model for diff generation | `gemini-3-pro-preview` |
 | `GPTDIFF_SMARTAPPLY_MODEL` | Model for applying diffs | `GPTDIFF_MODEL` |
 | `GPTDIFF_LLM_BASE_URL` | OpenAI-compatible endpoint | `https://nano-gpt.com/api/v1/` |
+| `GPTDIFF_FILTER_MODEL` | Cheap model for `filter_relevant` | `xiaomi/mimo-v2.6-flash` (Flask recall 1.0 / ~0.8x overhead: UNVERIFIED) |
 
 ---
 
@@ -203,7 +193,7 @@ patchling "Add type hints to all functions" --apply
 patchling "Add logging" src/api/ src/utils/helpers.py
 ```
 
-Useful flags: `--model`, `--temperature`, `--prepend <file>` (custom instructions), `--image <path>` (visual context), `--nobeep`. Full list: [CLI Reference](https://patchling.255labs.xyz/cli).
+Useful flags: `--model`, `--temperature`, `--prepend <file>` (custom instructions), `--image <path>` (visual context), `--filter-relevant` (ask a cheap model which files to send; `--filter-model` picks that model), `--nobeep`. Full list: [CLI Reference](https://255bits.github.io/patchling-py/cli).
 
 Because changes arrive as diffs, the CLI is git-native: review with `git diff`, keep with `git add -p`, discard with `git checkout .`.
 
@@ -216,7 +206,7 @@ patchling-apply path/to/diff.patch
 patchling-apply --diff "<diff text>"
 ```
 
-Options: `--project-dir`, `--model`, `--max_tokens`, `--nobeep`. Details: [patchling-apply docs](https://patchling.255labs.xyz/patchling-apply).
+Options: `--project-dir`, `--model`, `--max_tokens`, `--nobeep`. Details: [patchling-apply docs](https://255bits.github.io/patchling-py/patchling-apply).
 
 ### Agent loops
 
@@ -230,7 +220,7 @@ while true; do
 done
 ```
 
-One overnight test-coverage loop took a project from 18 to 127 test cases. Recipes and guardrails: [Automation Guide](https://patchling.255labs.xyz/examples/automation).
+One overnight test-coverage loop took a project from 18 to 127 test cases. Recipes and guardrails: [Automation Guide](https://255bits.github.io/patchling-py/examples/automation).
 
 ---
 
@@ -243,7 +233,7 @@ pytest tests/
 
 ## Documentation
 
-Docs live at [patchling.255labs.xyz](https://patchling.255labs.xyz). To preview locally:
+Docs live at [255bits.github.io/patchling-py](https://255bits.github.io/patchling-py). To preview locally:
 
 ```bash
 pip install .[docs]
@@ -252,7 +242,8 @@ mkdocs serve
 
 ## Related projects
 
-- [patchling](https://github.com/255BITS/patchling) — the browser/Node port
+- [patchling.app](https://patchling.app) — project home, with a live in-browser demo
+- [patchling for JS](https://github.com/255BITS/patchling) — the browser/Node package on [npm](https://www.npmjs.com/package/patchling)
 - [nanoodle.com](https://nanoodle.com) — visual AI workflow editor built on patchling
 - [patchling live demos](https://255bits.github.io/patchling-examples/)
 - [AI Agent Toolbox](https://github.com/255BITS/ai-agent-toolbox) — powers Patchling's tool-call parsing across models

{patchling-0.8.0 → patchling-0.9.0}/README.md

@@ -17,15 +17,10 @@ print(updated["main.py"])
 
 Files in, files out. No filesystem access required, no agent harness. The hard part — applying an LLM-generated diff that `git apply` would reject — is what `smartapply` solves: per-file, AI-assisted patch resolution that survives fuzzy hunks, renames, new files, and deletions.
 
-📚 Full documentation at [patchling.255labs.xyz](https://patchling.255labs.xyz)
+🌐 Project home: [patchling.app](https://patchling.app) — try it live in your browser · 📚 Full documentation at [255bits.github.io/patchling-py](https://255bits.github.io/patchling-py)
 
-Prefer the browser? **[patchling](https://github.com/255BITS/patchling)** is a JavaScript port of
-`generateDiff` + `smartapply` — try the **[live demos →](https://255bits.github.io/patchling-examples/)**.
-
-> **The patchling family** —
-> **patchling** (you are here) ·
-> [**patchling**](https://github.com/255BITS/patchling) (browser-first JS port) ·
-> [**patchling-examples**](https://github.com/255BITS/patchling-examples) (live browser demos)
+Prefer the browser? The same primitive ships on npm as **[patchling for JS](https://github.com/255BITS/patchling)**
+(`generateDiff` + `smartapply`, zero-dependency ESM) — try the **[live demos →](https://255bits.github.io/patchling-examples/)**.
 
 ---
 
@@ -35,12 +30,13 @@ The same primitive exists for every runtime, and it powers a real product:
 
 | Project | What it is |
 |---------|------------|
-| **patchling** (this repo) | Python library + CLI tools — [PyPI](https://pypi.org/project/patchling/) |
-| **[patchling](https://github.com/255BITS/patchling)** | Zero-dependency ESM port for browser and Node — `generateDiff` + `smartapply` on in-memory file maps |
+| **patchling for Python** (this repo) | Python library + CLI tools — [PyPI](https://pypi.org/project/patchling/) |
+| **[patchling for JS](https://github.com/255BITS/patchling)** | Zero-dependency ESM package for browser and Node — `generateDiff` + `smartapply` on in-memory file maps — [npm](https://www.npmjs.com/package/patchling) |
+| **[patchling.app](https://patchling.app)** | Project homepage with a live in-browser demo of the whole diff → smartapply loop |
 | **[nanoodle.com](https://nanoodle.com)** | Visual AI workflow editor built on patchling — no server, no signup, bring your own key. See the primitive working in production |
 | **[Live demos](https://255bits.github.io/patchling-examples/)** | Browser examples: LLM-edited games, 3D scenes, stream overlays, AI characters |
 
-Building for the browser? Start with [patchling](https://github.com/255BITS/patchling). Building a Python backend, pipeline, or your own agent? You're in the right repo.
+Building for the browser? Start with [patchling for JS](https://github.com/255BITS/patchling). Building a Python backend, pipeline, or your own agent? You're in the right repo.
 
 ---
 
@@ -91,10 +87,11 @@ See [examples/usage_example.py](examples/usage_example.py) for a runnable versio
 
 - `generate_diff(environment: str, goal: str, model: str = ...) -> str` — generates a unified diff implementing the goal. `model` defaults to the `GPTDIFF_MODEL` env var.
 - `smartapply(diff_text: str, files: dict[str, str], model: str = ...) -> dict[str, str]` — applies a diff with AI-powered conflict resolution. Handles new files, deletions, and hunks that standard patching rejects. Returns a new dict; input is not mutated.
-- `build_environment(files: dict[str, str]) -> str` — serializes a files dict into the environment string `generate_diff` expects.
+- `build_environment(files: dict[str, str]) -> str` — serializes a files dict into the environment string `generate_diff` expects. Pass `filter_relevant=True` and `task=` to drop files a cheap model marks irrelevant first.
+- `filter_relevant(files, task, model=..., concurrency=..., cache=...) -> FilterRelevantResult` — opt-in relevance filter for large directories. Each file is sent, with the task, to a cheap OpenAI-compatible model that answers yes/no. Only the `yes` files are returned for `generate_diff` and `smartapply`. The default model is `xiaomi/mimo-v2.6-flash` (Flask recall 1.0 and ~0.8x overhead figures are UNVERIFIED). The JS counterpart is `filterRelevant`.
 - `load_project_files(path, cwd) -> dict` / `save_files(files, base_dir)` — optional filesystem helpers for when you *do* want to read/write a real project (respects `.gitignore` and `.gptignore`).
 
-Full signatures, error handling, and edge cases: [API Reference](https://patchling.255labs.xyz/api).
+Full signatures, error handling, and edge cases: [API Reference](https://255bits.github.io/patchling-py/api).
 
 **Pipeline example** — sequential transformations over an in-memory codebase:
 
@@ -139,6 +136,7 @@ export GPTDIFF_SMARTAPPLY_MODEL='gpt5-mini'
 | `GPTDIFF_MODEL` | Model for diff generation | `gemini-3-pro-preview` |
 | `GPTDIFF_SMARTAPPLY_MODEL` | Model for applying diffs | `GPTDIFF_MODEL` |
 | `GPTDIFF_LLM_BASE_URL` | OpenAI-compatible endpoint | `https://nano-gpt.com/api/v1/` |
+| `GPTDIFF_FILTER_MODEL` | Cheap model for `filter_relevant` | `xiaomi/mimo-v2.6-flash` (Flask recall 1.0 / ~0.8x overhead: UNVERIFIED) |
 
 ---
 
@@ -166,7 +164,7 @@ patchling "Add type hints to all functions" --apply
 patchling "Add logging" src/api/ src/utils/helpers.py
 ```
 
-Useful flags: `--model`, `--temperature`, `--prepend <file>` (custom instructions), `--image <path>` (visual context), `--nobeep`. Full list: [CLI Reference](https://patchling.255labs.xyz/cli).
+Useful flags: `--model`, `--temperature`, `--prepend <file>` (custom instructions), `--image <path>` (visual context), `--filter-relevant` (ask a cheap model which files to send; `--filter-model` picks that model), `--nobeep`. Full list: [CLI Reference](https://255bits.github.io/patchling-py/cli).
 
 Because changes arrive as diffs, the CLI is git-native: review with `git diff`, keep with `git add -p`, discard with `git checkout .`.
 
@@ -179,7 +177,7 @@ patchling-apply path/to/diff.patch
 patchling-apply --diff "<diff text>"
 ```
 
-Options: `--project-dir`, `--model`, `--max_tokens`, `--nobeep`. Details: [patchling-apply docs](https://patchling.255labs.xyz/patchling-apply).
+Options: `--project-dir`, `--model`, `--max_tokens`, `--nobeep`. Details: [patchling-apply docs](https://255bits.github.io/patchling-py/patchling-apply).
 
 ### Agent loops
 
@@ -193,7 +191,7 @@ while true; do
 done
 ```
 
-One overnight test-coverage loop took a project from 18 to 127 test cases. Recipes and guardrails: [Automation Guide](https://patchling.255labs.xyz/examples/automation).
+One overnight test-coverage loop took a project from 18 to 127 test cases. Recipes and guardrails: [Automation Guide](https://255bits.github.io/patchling-py/examples/automation).
 
 ---
 
@@ -206,7 +204,7 @@ pytest tests/
 
 ## Documentation
 
-Docs live at [patchling.255labs.xyz](https://patchling.255labs.xyz). To preview locally:
+Docs live at [255bits.github.io/patchling-py](https://255bits.github.io/patchling-py). To preview locally:
 
 ```bash
 pip install .[docs]
@@ -215,7 +213,8 @@ mkdocs serve
 
 ## Related projects
 
-- [patchling](https://github.com/255BITS/patchling) — the browser/Node port
+- [patchling.app](https://patchling.app) — project home, with a live in-browser demo
+- [patchling for JS](https://github.com/255BITS/patchling) — the browser/Node package on [npm](https://www.npmjs.com/package/patchling)
 - [nanoodle.com](https://nanoodle.com) — visual AI workflow editor built on patchling
 - [patchling live demos](https://255bits.github.io/patchling-examples/)
 - [AI Agent Toolbox](https://github.com/255BITS/ai-agent-toolbox) — powers Patchling's tool-call parsing across models

patchling-0.9.0/patchling/__init__.py

@@ -0,0 +1,61 @@
+"""Natural-language diffs and resilient patch application.
+
+Public names mirror 255BITS/patchling (the JavaScript package) in snake_case.
+Existing names such as ``generate_diff`` and ``smartapply`` stay in place.
+"""
+
+from .applydiff import apply_diff, extract_diff_blocks, parse_diff_per_file
+from .core import (
+    SmartApplyError,
+    build_environment,
+    call_llm,
+    call_llm_for_diff,
+    color_code_diff,
+    generate_diff,
+    load_project_files,
+    resolve_api_key,
+    resolve_base_url,
+    save_files,
+    smartapply,
+    strip_bad_output,
+    strip_think_tags,
+    swallow_reasoning,
+)
+from .env import DEFAULT_BASE_URL, DEFAULT_MODEL, get_env, set_env
+from .relevance import (
+    FilterRelevantResult,
+    RelevanceCache,
+    RelevanceDecision,
+    filter_relevant,
+)
+
+__version__ = "0.9.0"
+
+__all__ = [
+    "__version__",
+    "DEFAULT_BASE_URL",
+    "DEFAULT_MODEL",
+    "FilterRelevantResult",
+    "RelevanceCache",
+    "RelevanceDecision",
+    "SmartApplyError",
+    "apply_diff",
+    "build_environment",
+    "call_llm",
+    "call_llm_for_diff",
+    "color_code_diff",
+    "extract_diff_blocks",
+    "filter_relevant",
+    "generate_diff",
+    "get_env",
+    "load_project_files",
+    "parse_diff_per_file",
+    "resolve_api_key",
+    "resolve_base_url",
+    "save_files",
+    "set_env",
+    "smartapply",
+    "strip_bad_output",
+    "strip_think_tags",
+    "swallow_reasoning",
+]