patch-code 0.1.0__py3-none-any.whl

patch/copypaste.py

@@ -0,0 +1,72 @@
+import threading
+import time
+
+import pyperclip
+
+
+class ClipboardWatcher:
+    """Watches clipboard for changes and updates IO placeholder"""
+
+    def __init__(self, io, verbose=False):
+        self.io = io
+        self.verbose = verbose
+        self.stop_event = None
+        self.watcher_thread = None
+        self.last_clipboard = None
+        self.io.clipboard_watcher = self
+
+    def start(self):
+        """Start watching clipboard for changes"""
+        self.stop_event = threading.Event()
+        self.last_clipboard = pyperclip.paste()
+
+        def watch_clipboard():
+            while not self.stop_event.is_set():
+                try:
+                    current = pyperclip.paste()
+                    if current != self.last_clipboard:
+                        self.last_clipboard = current
+                        self.io.interrupt_input()
+                        self.io.placeholder = current
+                        if len(current.splitlines()) > 1:
+                            self.io.placeholder = "\n" + self.io.placeholder + "\n"
+
+                    time.sleep(0.5)
+                except Exception as e:
+                    if self.verbose:
+                        from patch.dump import dump
+
+                        dump(f"Clipboard watcher error: {e}")
+                    continue
+
+        self.watcher_thread = threading.Thread(target=watch_clipboard, daemon=True)
+        self.watcher_thread.start()
+
+    def stop(self):
+        """Stop watching clipboard for changes"""
+        if self.stop_event:
+            self.stop_event.set()
+        if self.watcher_thread:
+            self.watcher_thread.join()
+            self.watcher_thread = None
+            self.stop_event = None
+
+
+def main():
+    """Example usage of the clipboard watcher"""
+    from patch.io import InputOutput
+
+    io = InputOutput()
+    watcher = ClipboardWatcher(io, verbose=True)
+
+    try:
+        watcher.start()
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\nStopped watching clipboard")
+        watcher.stop()
+
+
+if __name__ == "__main__":
+    main()

patch/deprecated.py

@@ -0,0 +1,126 @@
+def add_deprecated_model_args(parser, group):
+    """Add deprecated model shortcut arguments to the argparse parser."""
+    opus_model = "claude-3-opus-20240229"
+    group.add_argument(
+        "--opus",
+        action="store_true",
+        help=f"Use {opus_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    sonnet_model = "anthropic/claude-3-7-sonnet-20250219"
+    group.add_argument(
+        "--sonnet",
+        action="store_true",
+        help=f"Use {sonnet_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    haiku_model = "claude-3-5-haiku-20241022"
+    group.add_argument(
+        "--haiku",
+        action="store_true",
+        help=f"Use {haiku_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    gpt_4_model = "gpt-4-0613"
+    group.add_argument(
+        "--4",
+        "-4",
+        action="store_true",
+        help=f"Use {gpt_4_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    gpt_4o_model = "gpt-4o"
+    group.add_argument(
+        "--4o",
+        action="store_true",
+        help=f"Use {gpt_4o_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    gpt_4o_mini_model = "gpt-4o-mini"
+    group.add_argument(
+        "--mini",
+        action="store_true",
+        help=f"Use {gpt_4o_mini_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    gpt_4_turbo_model = "gpt-4-1106-preview"
+    group.add_argument(
+        "--4-turbo",
+        action="store_true",
+        help=f"Use {gpt_4_turbo_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    gpt_3_model_name = "gpt-3.5-turbo"
+    group.add_argument(
+        "--35turbo",
+        "--35-turbo",
+        "--3",
+        "-3",
+        action="store_true",
+        help=f"Use {gpt_3_model_name} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    deepseek_model = "deepseek/deepseek-chat"
+    group.add_argument(
+        "--deepseek",
+        action="store_true",
+        help=f"Use {deepseek_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    o1_mini_model = "o1-mini"
+    group.add_argument(
+        "--o1-mini",
+        action="store_true",
+        help=f"Use {o1_mini_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+    o1_preview_model = "o1-preview"
+    group.add_argument(
+        "--o1-preview",
+        action="store_true",
+        help=f"Use {o1_preview_model} model for the main chat (deprecated, use --model)",
+        default=False,
+    )
+
+
+def handle_deprecated_model_args(args, io):
+    """Handle deprecated model shortcut arguments and provide appropriate warnings."""
+    # Define model mapping
+    model_map = {
+        "opus": "claude-3-opus-20240229",
+        "sonnet": "anthropic/claude-3-7-sonnet-20250219",
+        "haiku": "claude-3-5-haiku-20241022",
+        "4": "gpt-4-0613",
+        "4o": "gpt-4o",
+        "mini": "gpt-4o-mini",
+        "4_turbo": "gpt-4-1106-preview",
+        "35turbo": "gpt-3.5-turbo",
+        "deepseek": "deepseek/deepseek-chat",
+        "o1_mini": "o1-mini",
+        "o1_preview": "o1-preview",
+    }
+
+    # Check if any deprecated args are used
+    for arg_name, model_name in model_map.items():
+        arg_name_clean = arg_name.replace("-", "_")
+        if hasattr(args, arg_name_clean) and getattr(args, arg_name_clean):
+            # Find preferred name to display in warning
+            from patch.models import MODEL_ALIASES
+
+            display_name = model_name
+            # Check if there's a shorter alias for this model
+            for alias, full_name in MODEL_ALIASES.items():
+                if full_name == model_name:
+                    display_name = alias
+                    break
+
+            # Show the warning
+            io.tool_warning(
+                f"The --{arg_name.replace('_', '-')} flag is deprecated and will be removed in a"
+                f" future version. Please use --model {display_name} instead."
+            )
+
+            # Set the model
+            if not args.model:
+                args.model = model_name
+            break

patch/diffs.py

@@ -0,0 +1,128 @@
+import difflib
+import sys
+
+from .dump import dump  # noqa: F401
+
+
+def main():
+    if len(sys.argv) != 3:
+        print("Usage: python diffs.py file1 file")
+        sys.exit(1)
+
+    file_orig, file_updated = sys.argv[1], sys.argv[2]
+
+    with open(file_orig, "r", encoding="utf-8") as f:
+        lines_orig = f.readlines()
+
+    with open(file_updated, "r", encoding="utf-8") as f:
+        lines_updated = f.readlines()
+
+    for i in range(len(file_updated)):
+        res = diff_partial_update(lines_orig, lines_updated[:i])
+        print(res)
+        input()
+
+
+def create_progress_bar(percentage):
+    block = "█"
+    empty = "░"
+    total_blocks = 30
+    filled_blocks = int(total_blocks * percentage // 100)
+    empty_blocks = total_blocks - filled_blocks
+    bar = block * filled_blocks + empty * empty_blocks
+    return bar
+
+
+def assert_newlines(lines):
+    if not lines:
+        return
+    for line in lines[:-1]:
+        assert line and line[-1] == "\n", line
+
+
+def diff_partial_update(lines_orig, lines_updated, final=False, fname=None):
+    """
+    Given only the first part of an updated file, show the diff while
+    ignoring the block of "deleted" lines that are past the end of the
+    partially complete update.
+    """
+
+    # dump(lines_orig)
+    # dump(lines_updated)
+
+    assert_newlines(lines_orig)
+
+    num_orig_lines = len(lines_orig)
+
+    if final:
+        last_non_deleted = num_orig_lines
+    else:
+        last_non_deleted = find_last_non_deleted(lines_orig, lines_updated)
+
+    # dump(last_non_deleted)
+    if last_non_deleted is None:
+        return ""
+
+    if num_orig_lines:
+        pct = last_non_deleted * 100 / num_orig_lines
+    else:
+        pct = 50
+    bar = create_progress_bar(pct)
+    bar = f" {last_non_deleted:3d} / {num_orig_lines:3d} lines [{bar}] {pct:3.0f}%\n"
+
+    lines_orig = lines_orig[:last_non_deleted]
+
+    if not final:
+        lines_updated = lines_updated[:-1] + [bar]
+
+    diff = difflib.unified_diff(lines_orig, lines_updated, n=5)
+
+    diff = list(diff)[2:]
+
+    diff = "".join(diff)
+    if not diff.endswith("\n"):
+        diff += "\n"
+
+    for i in range(3, 10):
+        backticks = "`" * i
+        if backticks not in diff:
+            break
+
+    show = f"{backticks}diff\n"
+    if fname:
+        show += f"--- {fname} original\n"
+        show += f"+++ {fname} updated\n"
+
+    show += diff
+
+    show += f"{backticks}\n\n"
+
+    # print(diff)
+
+    return show
+
+
+def find_last_non_deleted(lines_orig, lines_updated):
+    diff = list(difflib.ndiff(lines_orig, lines_updated))
+
+    num_orig = 0
+    last_non_deleted_orig = None
+
+    for line in diff:
+        # print(f"{num_orig:2d} {num_updated:2d} {line}", end="")
+        code = line[0]
+        if code == " ":
+            num_orig += 1
+            last_non_deleted_orig = num_orig
+        elif code == "-":
+            # line only in orig
+            num_orig += 1
+        elif code == "+":
+            # line only in updated
+            pass
+
+    return last_non_deleted_orig
+
+
+if __name__ == "__main__":
+    main()

patch/docs/__init__.py

@@ -0,0 +1 @@
+"""Packaged Markdown documentation for Patch's interactive help."""

patch/docs/analytics.md

@@ -0,0 +1,28 @@
+# Analytics
+
+Patch ships no analytics destination. No analytics events are sent and no opt-in
+prompt appears unless you configure your own PostHog project. Upstream Aider's
+project keys have been removed. Patch operates no analytics service.
+
+## Your own telemetry
+
+The inherited instrumentation can be enabled with both
+`--analytics-posthog-project-api-key KEY` and `--analytics`. The first time,
+Patch asks you to confirm. `--analytics-posthog-host HOST` selects a custom host.
+`--no-analytics` disables collection for the session;
+`python -m patch --analytics-disable` records a permanent opt-out.
+
+Events include feature usage, public model names, token counts, error indicators,
+system information, and a random UUID. Unknown model names are redacted.
+Automatic exception capture is disabled. Review [the source](../analytics.py)
+before enabling instrumentation for your own deployment.
+
+## Local logs
+
+```bash
+python -m patch --analytics-log events.jsonl --no-analytics
+```
+
+This writes events locally without uploading them. Review logs before sharing
+them and keep them out of version control. User-level analytics preferences and
+the UUID are stored in `~/.patch/analytics.json`.

patch/docs/config.md

@@ -0,0 +1,43 @@
+# Configuration
+
+Run `python -m patch --help` for the complete, current CLI option reference.
+Most options also accept `.patch.conf.yml` entries or `PATCH_*` environment variables.
+For example, `--dark-mode`, `dark-mode: true` in YAML, and `PATCH_DARK_MODE=true`
+are equivalent. Command-line values override environment and configuration values.
+
+Patch searches for `.patch.conf.yml` in your home directory, Git repository root,
+and current directory, with nearer configuration taking precedence. Use
+`--config FILE` for an explicit configuration file.
+
+```yaml
+model: sonnet
+dark-mode: true
+auto-commits: false
+```
+
+## Environment and credentials
+
+Provider credentials retain their own names, such as `ANTHROPIC_API_KEY` and
+`OPENAI_API_KEY`. Store them in your shell environment or an untracked `.env` file.
+Use `--env-file FILE` to select an environment file. YAML `api-key` entries and
+`--api-key provider=KEY` also support providers beyond OpenAI and Anthropic.
+`--set-env NAME=value` sets other provider variables.
+
+Review repository-local YAML and `.env` files before running Patch: they can
+configure executable commands and provider endpoints. Never load untrusted
+repository settings with credentials present.
+
+## Linting and tests
+
+Patch can automatically lint edited files (`--auto-lint`, enabled by default).
+Configure `--lint-cmd COMMAND` or `--lint-cmd 'python: COMMAND'`. Use
+`--test-cmd COMMAND` with `--auto-test` for automatic tests, or `/test COMMAND`
+inside chat. Only configure trusted commands.
+
+## State and privacy
+
+Patch uses `.patch*` state files and `~/.patch/` for user-level data and caches.
+`--input-history-file` and `--chat-history-file` change history destinations.
+History, logs, and verbose settings can contain sensitive data; do not publish them
+without review. Patch does not migrate `.aider*` or `AIDER_*` settings automatically.
+See [analytics](analytics.md) for the disabled-by-default telemetry instrumentation.

patch/docs/git.md

@@ -0,0 +1,22 @@
+# Git integration
+
+Patch works best in a Git repository. By default it commits its edits with a
+generated message and can commit pre-existing dirty changes before editing those
+files. Review changes with `/diff` and normal Git commands.
+
+`--no-auto-commits` disables automatic commits of model edits.
+`--no-dirty-commits` disables the pre-edit commit of existing changes.
+`--no-git` disables Git integration. `/commit` asks Patch to commit changes;
+`/git <arguments>` runs Git directly.
+
+## Undo
+
+`/undo` reverts the last eligible Patch commit. It is not a general backup system;
+check `git status` and `git diff` before destructive Git operations. Keep your own
+commits and backups, especially when automatic commits are disabled.
+
+## Attribution
+
+Use `--attribute-author`, `--attribute-committer`, and the commit-message
+attribution options shown by `python -m patch --help` to control Patch attribution.
+Configure your own Git user name and email before working in a repository.

patch/docs/install.md

@@ -0,0 +1,54 @@
+# Installing Patch
+
+Patch supports Python 3.10–3.14. Use an isolated virtual environment:
+
+```bash
+python -m venv .venv
+# macOS / Linux:
+source .venv/bin/activate
+# Windows PowerShell: .venv\Scripts\Activate.ps1
+python -m pip install patch-code
+python -m patch --help
+```
+
+Run `python -m pip install --upgrade patch-code` to upgrade. Update notices do not
+install anything automatically. Use `python -m patch` to avoid the Unix `patch`
+utility. For source development see [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Interactive help
+
+```bash
+python -m pip install 'patch-code[help]' --extra-index-url https://download.pytorch.org/whl/cpu
+```
+
+`/help <question>` can offer to install this extra. The first use downloads a
+Hugging Face embedding model and indexes the packaged Markdown docs; subsequent
+uses cache the index under `~/.patch/caches/`. Retrieval runs locally, but the
+question and relevant docs are sent to your configured chat model for an answer.
+Bare `/help` and `python -m patch --help` do not require this extra.
+
+## Browser UI
+
+```bash
+python -m pip install 'patch-code[browser]'
+python -m patch --browser
+```
+
+The experimental UI is intended for a trusted single user. Do not expose it to
+untrusted networks or share it with other users: it can edit files and run commands.
+
+## Enable Playwright
+
+For pages that need browser rendering:
+
+```bash
+python -m pip install 'patch-code[playwright]'
+python -m playwright install --with-deps chromium
+```
+
+## Installation problems
+
+Check that `python --version` is supported and `python -m pip --version` points at
+the active environment. Use the same Python for installation and launch. Avoid
+naming local files `patch.py` or `patch`, which can shadow the installed package.
+Recreate the virtual environment if it contains incompatible dependencies.

patch/docs/models.md

@@ -0,0 +1,59 @@
+# Models
+
+Select a model with `python -m patch --model MODEL` or `/model MODEL` in chat.
+`python -m patch --list-models QUERY` lists matching known names. Aliases such as
+`sonnet` are defined in [the model module](../models.py); they can change over time.
+
+## API keys
+
+Use provider environment variables such as `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`,
+`GEMINI_API_KEY`, or `OPENROUTER_API_KEY`. Alternatively use
+`--api-key anthropic=YOUR_KEY` (substitute your provider). Shell history and process
+listings can expose command-line keys, so prefer a private environment or `.env`.
+Never commit credentials or paste them into issue reports.
+
+Examples of model selection:
+
+```bash
+python -m patch --model sonnet
+python -m patch --model openrouter/anthropic/claude-3.5-sonnet
+python -m patch --model ollama_chat/YOUR_LOCAL_MODEL
+```
+
+For Ollama, start its server and pull the model first; set `OLLAMA_API_BASE` if
+needed. For an OpenAI-compatible server use an `openai/` model name and configure
+`OPENAI_API_BASE` and `OPENAI_API_KEY` as required by that server. Availability,
+prices, permissions, and context limits are controlled by the provider.
+
+## Model warnings
+
+Unknown context limits or token costs mean Patch lacks model metadata, not
+necessarily that the model cannot work. Check the provider's model name and limits.
+Add metadata with `.patch.model.metadata.json` or `--model-metadata-file`.
+The JSON maps model names to LiteLLM metadata such as `max_input_tokens`,
+`max_output_tokens`, `input_cost_per_token`, `output_cost_per_token`,
+`litellm_provider`, and `mode`.
+
+## Model settings
+
+Use `.patch.model.settings.yml` or `--model-settings-file` for a YAML list of
+settings. For example:
+
+```yaml
+- name: openai/your-model
+  edit_format: whole
+  weak_model_name: null
+  use_repo_map: true
+```
+
+See [the packaged settings](../resources/model-settings.yml) for supported examples.
+These are distinct from model metadata. Use `--alias short:provider/model` to
+define a short name. See [configuration](config.md) for storing command options.
+
+## Edit formats
+
+Patch chooses an edit format from its model settings. `diff` uses SEARCH/REPLACE
+blocks; `whole` replaces full files; `udiff` uses unified diffs; `patch` uses
+explicit patch operations. `--edit-format FORMAT` overrides the default.
+Choose a format your model follows reliably. Use `/ask` for discussion without
+edits and `/architect` for a plan followed by a separate editor model.

patch/docs/troubleshooting.md

@@ -0,0 +1,23 @@
+# Troubleshooting
+
+Start with `python -m patch --help` and `/help`. For installation/import problems
+see [installation](install.md#installation-problems); for credentials and provider
+errors see [models](models.md#api-keys). Report reproducible problems in
+[Patch issues](https://github.com/PierrunoYT/patch/issues), omitting credentials,
+private code, and unredacted logs.
+
+## Edit errors
+
+An edit error means Patch could not apply the model's requested format or match
+its source text. Patch normally sends feedback to the model so it can retry.
+If failures repeat, reduce the request, add the correct files, and use a model
+with reliable editing support. Check [edit formats](models.md#edit-formats).
+Review the diff: a failed response may still have applied some edits.
+
+## Token limits
+
+Use `/tokens` to inspect context usage. `/drop` unnecessary files and `/clear`
+old chat history; ask for smaller changes. Large files, pasted output, and long
+conversations consume input context. Output limits can truncate edits, so review
+files and tests rather than assuming a finished response made complete changes.
+Check [model metadata](models.md#model-warnings) if the reported limits look wrong.

patch/docs/usage.md

@@ -0,0 +1,47 @@
+# Using Patch
+
+Patch is an AI pair-programming tool for your terminal, forked from Aider.
+Start in your project directory with `python -m patch file1.py file2.py`, then
+describe the change you want. Review the edits and run your tests.
+See [installation](install.md), [models](models.md), [configuration](config.md),
+[Git integration](git.md), and [troubleshooting](troubleshooting.md).
+
+## Adding files
+
+Use `/add path/to/file` to share editable files, `/read path/to/file` for read-only
+context, `/ls` to list files, and `/drop path/to/file` to remove files from chat.
+Only add files needed for the task: adding everything costs tokens and can confuse
+the model. The repository map supplies related context without adding every file.
+Use `/tokens` to inspect context usage.
+
+## Large repositories
+
+Start Patch in the repository and add only the files you expect to edit.
+Use `.patchignore` with Git-ignore patterns to exclude irrelevant files from the
+repository map and file discovery. Adjust `--map-tokens` to control map size;
+`--map-tokens 0` disables the map. `/map` shows it and `/map-refresh` refreshes it.
+
+## Commands and modes
+
+- `/help` lists commands without installing extras. `/help <question>` retrieves
+  these packaged docs and asks your configured model for an answer; it requires
+  the [help extra](install.md#interactive-help) and may incur model API charges.
+- `/ask <question>` discusses code without editing; `/code <request>` requests edits.
+- `/architect <request>` uses a planning model followed by an editor model.
+  `/chat-mode` changes the mode for subsequent messages.
+- `/model <name>` changes the main model; `/models <query>` searches model names.
+- `/diff` reviews the last changes; `/undo` undoes the last eligible Patch commit.
+- `/run <command>` runs a shell command and offers to add its output to chat.
+- `/test <command>` runs tests and offers to fix failures; `/lint` runs configured linters.
+- `/clear` clears chat history; `/reset` also drops files; `/exit` ends the session.
+
+## More context
+
+Use `/web <URL>` to read a page, `/add` for a supported image, and `/voice` for
+microphone transcription. Voice requires an audio device and transcription provider
+credentials. Use `/paste` for clipboard content and `/editor` to write a prompt
+in your editor. `/multiline-mode` toggles multiline input.
+
+`--watch-files` reacts to AI comment markers in source files. Only enable it in
+trusted projects: other local processes that write files can trigger model turns.
+The experimental `--browser` UI requires the [browser extra](install.md#browser-ui).

patch/dump.py

@@ -0,0 +1,29 @@
+import json
+import traceback
+
+
+def cvt(s):
+    if isinstance(s, str):
+        return s
+    try:
+        return json.dumps(s, indent=4)
+    except TypeError:
+        return str(s)
+
+
+def dump(*vals):
+    # http://docs.python.org/library/traceback.html
+    stack = traceback.extract_stack()
+    vars = stack[-2][3]
+
+    # strip away the call to dump()
+    vars = "(".join(vars.split("(")[1:])
+    vars = ")".join(vars.split(")")[:-1])
+
+    vals = [cvt(v) for v in vals]
+    has_newline = sum(1 for v in vals if "\n" in v)
+    if has_newline:
+        print("%s:" % vars)
+        print(", ".join(vals))
+    else:
+        print("%s:" % vars, ", ".join(vals))