search-replace-py 0.0.1__tar.gz

search_replace_py-0.0.1/.github/workflows/lint.yml

@@ -0,0 +1,29 @@
+name: Linting
+
+on:
+  push:
+    branches: ["master"]
+  pull_request:
+    branches: ["master"]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run linter
+        shell: bash
+        run: uv run -- make lint

search_replace_py-0.0.1/.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Unit Testing
+
+on:
+  push:
+    branches: ["master"]
+  pull_request:
+    branches: ["master"]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run tests
+        shell: bash
+        run: uv run -- make test

search_replace_py-0.0.1/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+aider-main/

search_replace_py-0.0.1/.python-version

@@ -0,0 +1 @@
+3.14

search_replace_py-0.0.1/LICENSE

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

search_replace_py-0.0.1/Makefile

@@ -0,0 +1,37 @@
+.PHONY: init install format lint test build publish clean
+
+PYTHON ?= uv run
+
+DIST_DIR := dist
+
+init:
+	@command -v uv >/dev/null 2>&1 || { echo >&2 "Error: uv is not installed."; exit 1; }
+
+install: init
+	@uv sync
+
+format: init
+	@$(PYTHON) ruff check search_replace tests --fix
+	@$(PYTHON) black search_replace tests
+
+lint: init
+	@$(PYTHON) ruff check search_replace tests
+	@$(PYTHON) black --check search_replace tests
+	@$(PYTHON) mypy search_replace
+
+test: init
+	@$(PYTHON) pytest
+
+# Preferred build (uv)
+build: init
+	@rm -rf $(DIST_DIR)
+	@uv build
+	@ls -la $(DIST_DIR)
+
+# Publish to PyPI (requires UV_PUBLISH_TOKEN)
+publish: build
+	@test -n "$$UV_PUBLISH_TOKEN" || { echo >&2 "Error: UV_PUBLISH_TOKEN is not set"; exit 1; }
+	@uv publish
+
+clean:
+	@rm -rf $(DIST_DIR) .pytest_cache .ruff_cache .mypy_cache

search_replace_py-0.0.1/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: search-replace-py
+Version: 0.0.1
+Summary: Parse and apply Aider-style SEARCH/REPLACE patch blocks to files
+Project-URL: Homepage, https://github.com/marcius-llmus/search-replace-py
+Project-URL: Repository, https://github.com/marcius-llmus/search-replace-py
+Project-URL: Issues, https://github.com/marcius-llmus/search-replace-py/issues
+Project-URL: Changelog, https://github.com/marcius-llmus/search-replace-py/releases
+Author: marcin
+License: MIT License
+        
+        Copyright (c) 2026 marcin
+        
+        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-File: LICENSE
+Keywords: aider,diff,editblock,llm,patch,replace,search,tooling
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# search-replace-py
+
+A standalone Python library for parsing and applying SEARCH/REPLACE patch blocks, extracted from [Aider's](https://github.com/Aider-AI/aider) editblock engine.
+
+Use it to give any LLM the ability to propose and apply precise code changes using the battle-tested editblock format.
+
+---
+
+## How it works
+
+The editblock format is Aider's primary mechanism for LLM-driven code editing. The LLM is prompted to output changes as structured `SEARCH/REPLACE` blocks:
+
+````
+```python
+mathweb/flask/app.py
+<<<<<<< SEARCH
+from flask import Flask
+=======
+import math
+from flask import Flask
+>>>>>>> REPLACE
+```
+````
+
+This library provides:
+
+1. **`render_system_prompt()`** — returns the rendered system prompt string to instruct the LLM.
+2. **`get_example_messages()`** — returns a `FewShotExampleMessages` named tuple with four plain strings (two user + two assistant turns) to prepend to the conversation history.
+3. **`apply_diff(llm_response, root)`** — parses the LLM's response and applies all blocks to disk in one call.
+
+---
+
+## What is included
+
+- Block parsing (`<<<<<<< SEARCH`, `=======`, `>>>>>>> REPLACE`) with filename discovery and fuzzy filename resolution.
+- Three replacement strategies:
+  - exact match
+  - leading-whitespace-tolerant match
+  - dotdotdot (`...`) segmented replacement
+- Typed errors (`ParseError`, `ApplyError`) for clean error handling in retry loops.
+
+---
+
+## Installation
+
+```bash
+pip install search-replace-py
+# or with uv
+uv add search-replace-py
+```
+
+---
+
+## Quick start
+
+```python
+from pathlib import Path
+from search_replace import render_system_prompt, get_example_messages, apply_diff
+
+# 1. Build the system prompt — plain string, append your own context if needed
+system_prompt = render_system_prompt()
+
+# 2. Build the messages list; prepend few-shot examples before the real request
+ex = get_example_messages()
+messages = [{"role": "system", "content": system_prompt}]
+messages += [
+    {"role": "user",      "content": ex.first_user_message},
+    {"role": "assistant", "content": ex.first_assistant_message},
+    {"role": "user",      "content": ex.second_user_message},
+    {"role": "assistant", "content": ex.second_assistant_message},
+]
+messages.append({"role": "user", "content": "Add a docstring to the greet() function in hello.py"})
+
+# 3. Send to your LLM and get a response string
+llm_response = "..."
+
+# 4. Parse and apply in one call
+apply_diff(llm_response, root=Path("."))
+```
+
+---
+
+## Integration with Pydantic AI
+
+[Pydantic AI](https://ai.pydantic.dev) accepts a string for `instructions` and a list of `ModelMessage` objects for `message_history`.
+
+```python
+from pathlib import Path
+
+from pydantic_ai import Agent, ModelRequest, ModelResponse, TextPart, UserPromptPart
+from search_replace import render_system_prompt, get_example_messages, apply_diff
+
+ex = get_example_messages()
+
+few_shot = [
+    ModelRequest(parts=[UserPromptPart(content=ex.first_user_message)]),
+    ModelResponse(parts=[TextPart(content=ex.first_assistant_message)]),
+    ModelRequest(parts=[UserPromptPart(content=ex.second_user_message)]),
+    ModelResponse(parts=[TextPart(content=ex.second_assistant_message)]),
+]
+
+agent = Agent("openai:gpt-5.2", instructions=render_system_prompt())
+
+auth_py = Path("auth.py").read_text()
+result = agent.run_sync(
+    f"Refactor the login function in auth.py to use bcrypt.\n\nauth.py\n```python\n{auth_py}\n```",
+    message_history=few_shot,
+)
+
+apply_diff(result.output, root=Path("."))
+```
+
+### With dry-run validation before writing
+
+```python
+from search_replace import parse_edit_blocks, apply_edits
+from search_replace.errors import ApplyError
+
+blocks = parse_edit_blocks(result.output)
+
+# Validate all blocks match before touching disk.
+# Without dry_run, blocks that match are written immediately — a later failure
+# would leave files partially patched with no rollback.
+try:
+    apply_edits(blocks.edits, root=Path("."), dry_run=True)
+except ApplyError as e:
+    # feed the error back to the LLM for a retry
+    print(f"Patch would not apply: {e}")
+else:
+    apply_edits(blocks.edits, root=Path("."))
+```
+
+---
+
+## Public API
+
+```python
+from search_replace import (
+    # Prompt
+    render_system_prompt,
+    get_example_messages,    # returns FewShotExampleMessages
+    FewShotExampleMessages,  # NamedTuple: first/second_user/assistant_message
+    render_prompt,           # render a single template string
+    EditBlockFencedPrompts,  # raw class with main_system, system_reminder, example_messages
+
+    # Parse + apply (convenience)
+    apply_diff,
+
+    # Parsing
+    parse_edit_blocks,
+    find_original_update_blocks,
+    EditBlock,
+
+    # Applying
+    apply_edits,              # pass dry_run=True to validate without writing
+
+    # Errors
+    ParseError,
+    ApplyError,
+    MissingFilenameError,
+)
+```
+
+---
+
+## Tests and validation
+
+- `tests/test_parser.py` — block parsing, filename resolution, edge cases
+- `tests/test_apply.py` — replacement strategies, whitespace tolerance, new-file creation
+- `tests/test_prompts.py` — `render_system_prompt` and `get_example_messages` output
+- `tests/test_parity_harness.py` — byte-for-byte comparison against Aider's reference output on the real 100K-line `chat-history.md` fixture
+
+```bash
+uv run python -m pytest tests/
+```
+
+---
+
+## Credits
+
+The parsing engine, replacement strategies, and prompt templates in this library are derived from [Aider](https://github.com/Aider-AI/aider), created by [Paul Gauthier](https://github.com/paul-gauthier). Aider is an outstanding AI pair-programming tool — this library simply extracts and packages its editblock mechanism so it can be reused in other applications. All credit for the original design and implementation goes to him.
+
+---
+
+## Extraction notes
+
+- Extracted from `aider/coders/editblock_coder.py` and the fenced editblock prompt module.
+- Runtime coupling to Aider's coder/model lifecycle is fully removed.
+- Error message contracts for malformed blocks and failed apply paths are preserved to maintain LLM retry-loop compatibility.
+- `replace_closest_edit_distance()` remains defined but inactive, preserving the original behaviour of the early return in `replace_most_similar_chunk()`.

search_replace_py-0.0.1/README.md

@@ -0,0 +1,190 @@
+# search-replace-py
+
+A standalone Python library for parsing and applying SEARCH/REPLACE patch blocks, extracted from [Aider's](https://github.com/Aider-AI/aider) editblock engine.
+
+Use it to give any LLM the ability to propose and apply precise code changes using the battle-tested editblock format.
+
+---
+
+## How it works
+
+The editblock format is Aider's primary mechanism for LLM-driven code editing. The LLM is prompted to output changes as structured `SEARCH/REPLACE` blocks:
+
+````
+```python
+mathweb/flask/app.py
+<<<<<<< SEARCH
+from flask import Flask
+=======
+import math
+from flask import Flask
+>>>>>>> REPLACE
+```
+````
+
+This library provides:
+
+1. **`render_system_prompt()`** — returns the rendered system prompt string to instruct the LLM.
+2. **`get_example_messages()`** — returns a `FewShotExampleMessages` named tuple with four plain strings (two user + two assistant turns) to prepend to the conversation history.
+3. **`apply_diff(llm_response, root)`** — parses the LLM's response and applies all blocks to disk in one call.
+
+---
+
+## What is included
+
+- Block parsing (`<<<<<<< SEARCH`, `=======`, `>>>>>>> REPLACE`) with filename discovery and fuzzy filename resolution.
+- Three replacement strategies:
+  - exact match
+  - leading-whitespace-tolerant match
+  - dotdotdot (`...`) segmented replacement
+- Typed errors (`ParseError`, `ApplyError`) for clean error handling in retry loops.
+
+---
+
+## Installation
+
+```bash
+pip install search-replace-py
+# or with uv
+uv add search-replace-py
+```
+
+---
+
+## Quick start
+
+```python
+from pathlib import Path
+from search_replace import render_system_prompt, get_example_messages, apply_diff
+
+# 1. Build the system prompt — plain string, append your own context if needed
+system_prompt = render_system_prompt()
+
+# 2. Build the messages list; prepend few-shot examples before the real request
+ex = get_example_messages()
+messages = [{"role": "system", "content": system_prompt}]
+messages += [
+    {"role": "user",      "content": ex.first_user_message},
+    {"role": "assistant", "content": ex.first_assistant_message},
+    {"role": "user",      "content": ex.second_user_message},
+    {"role": "assistant", "content": ex.second_assistant_message},
+]
+messages.append({"role": "user", "content": "Add a docstring to the greet() function in hello.py"})
+
+# 3. Send to your LLM and get a response string
+llm_response = "..."
+
+# 4. Parse and apply in one call
+apply_diff(llm_response, root=Path("."))
+```
+
+---
+
+## Integration with Pydantic AI
+
+[Pydantic AI](https://ai.pydantic.dev) accepts a string for `instructions` and a list of `ModelMessage` objects for `message_history`.
+
+```python
+from pathlib import Path
+
+from pydantic_ai import Agent, ModelRequest, ModelResponse, TextPart, UserPromptPart
+from search_replace import render_system_prompt, get_example_messages, apply_diff
+
+ex = get_example_messages()
+
+few_shot = [
+    ModelRequest(parts=[UserPromptPart(content=ex.first_user_message)]),
+    ModelResponse(parts=[TextPart(content=ex.first_assistant_message)]),
+    ModelRequest(parts=[UserPromptPart(content=ex.second_user_message)]),
+    ModelResponse(parts=[TextPart(content=ex.second_assistant_message)]),
+]
+
+agent = Agent("openai:gpt-5.2", instructions=render_system_prompt())
+
+auth_py = Path("auth.py").read_text()
+result = agent.run_sync(
+    f"Refactor the login function in auth.py to use bcrypt.\n\nauth.py\n```python\n{auth_py}\n```",
+    message_history=few_shot,
+)
+
+apply_diff(result.output, root=Path("."))
+```
+
+### With dry-run validation before writing
+
+```python
+from search_replace import parse_edit_blocks, apply_edits
+from search_replace.errors import ApplyError
+
+blocks = parse_edit_blocks(result.output)
+
+# Validate all blocks match before touching disk.
+# Without dry_run, blocks that match are written immediately — a later failure
+# would leave files partially patched with no rollback.
+try:
+    apply_edits(blocks.edits, root=Path("."), dry_run=True)
+except ApplyError as e:
+    # feed the error back to the LLM for a retry
+    print(f"Patch would not apply: {e}")
+else:
+    apply_edits(blocks.edits, root=Path("."))
+```
+
+---
+
+## Public API
+
+```python
+from search_replace import (
+    # Prompt
+    render_system_prompt,
+    get_example_messages,    # returns FewShotExampleMessages
+    FewShotExampleMessages,  # NamedTuple: first/second_user/assistant_message
+    render_prompt,           # render a single template string
+    EditBlockFencedPrompts,  # raw class with main_system, system_reminder, example_messages
+
+    # Parse + apply (convenience)
+    apply_diff,
+
+    # Parsing
+    parse_edit_blocks,
+    find_original_update_blocks,
+    EditBlock,
+
+    # Applying
+    apply_edits,              # pass dry_run=True to validate without writing
+
+    # Errors
+    ParseError,
+    ApplyError,
+    MissingFilenameError,
+)
+```
+
+---
+
+## Tests and validation
+
+- `tests/test_parser.py` — block parsing, filename resolution, edge cases
+- `tests/test_apply.py` — replacement strategies, whitespace tolerance, new-file creation
+- `tests/test_prompts.py` — `render_system_prompt` and `get_example_messages` output
+- `tests/test_parity_harness.py` — byte-for-byte comparison against Aider's reference output on the real 100K-line `chat-history.md` fixture
+
+```bash
+uv run python -m pytest tests/
+```
+
+---
+
+## Credits
+
+The parsing engine, replacement strategies, and prompt templates in this library are derived from [Aider](https://github.com/Aider-AI/aider), created by [Paul Gauthier](https://github.com/paul-gauthier). Aider is an outstanding AI pair-programming tool — this library simply extracts and packages its editblock mechanism so it can be reused in other applications. All credit for the original design and implementation goes to him.
+
+---
+
+## Extraction notes
+
+- Extracted from `aider/coders/editblock_coder.py` and the fenced editblock prompt module.
+- Runtime coupling to Aider's coder/model lifecycle is fully removed.
+- Error message contracts for malformed blocks and failed apply paths are preserved to maintain LLM retry-loop compatibility.
+- `replace_closest_edit_distance()` remains defined but inactive, preserving the original behaviour of the early return in `replace_most_similar_chunk()`.

search_replace_py-0.0.1/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from search-replace-py!")
+
+
+if __name__ == "__main__":
+    main()

search_replace_py-0.0.1/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "search-replace-py"
+version = "0.0.1"
+description = "Parse and apply Aider-style SEARCH/REPLACE patch blocks to files"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = []
+
+license = { file = "LICENSE" }
+authors = [{ name = "marcin" }]
+keywords = ["search", "replace", "patch", "diff", "editblock", "aider", "llm", "tooling"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Version Control",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/marcius-llmus/search-replace-py"
+Repository = "https://github.com/marcius-llmus/search-replace-py"
+Issues = "https://github.com/marcius-llmus/search-replace-py/issues"
+Changelog = "https://github.com/marcius-llmus/search-replace-py/releases"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "ruff>=0.2.2,<1.0.0",
+    "black>=25.12.0",
+    "mypy>=1.8.0,<2.0.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
+[tool.uv]
+default-groups = ["dev"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["search_replace"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

search_replace_py-0.0.1/search_replace/__init__.py

@@ -0,0 +1,38 @@
+from .apply import apply_diff, apply_edits
+from .errors import (
+    ApplyError,
+    MissingFilenameError,
+    ParseError,
+    PathEscapeError,
+    SearchReplaceError,
+)
+from .parser import all_fences, find_original_update_blocks, parse_edit_blocks
+from .prompts import (
+    EditBlockFencedPrompts,
+    FewShotExampleMessages,
+    get_example_messages,
+    render_system_prompt,
+)
+from .types import ApplyResult, DEFAULT_FENCE, EditBlock, Fence, ParseResult
+
+__all__ = [
+    "ApplyError",
+    "ApplyResult",
+    "apply_diff",
+    "apply_edits",
+    "all_fences",
+    "DEFAULT_FENCE",
+    "EditBlock",
+    "EditBlockFencedPrompts",
+    "Fence",
+    "FewShotExampleMessages",
+    "find_original_update_blocks",
+    "get_example_messages",
+    "MissingFilenameError",
+    "parse_edit_blocks",
+    "ParseError",
+    "PathEscapeError",
+    "ParseResult",
+    "render_system_prompt",
+    "SearchReplaceError",
+]