patchllm 0.2.1__py3-none-any.whl → 1.0.0__py3-none-any.whl

patchllm-0.2.1.dist-info/METADATA

@@ -1,127 +0,0 @@
-Metadata-Version: 2.4
-Name: patchllm
-Version: 0.2.1
-Summary: Lightweight tool to manage contexts and update code with LLMs
-Author: nassimberrada
-License: MIT License
-        
-        Copyright (c) 2025 nassimberrada
-        
-        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.
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: litellm
-Requires-Dist: python-dotenv
-Requires-Dist: rich
-Provides-Extra: voice
-Requires-Dist: SpeechRecognition; extra == "voice"
-Requires-Dist: pyttsx3; extra == "voice"
-Provides-Extra: url
-Requires-Dist: html2text; extra == "url"
-Dynamic: license-file
-
-<p align="center">
-  <picture>
-    <source srcset="./assets/logo_dark.png" media="(prefers-color-scheme: dark)">
-    <source srcset="./assets/logo_light.png" media="(prefers-color-scheme: light)">
-    <img src="./assets/logo_light.png" alt="PatchLLM Logo" height="200">
-  </picture>
-</p>
-
-## About
-PatchLLM is a command-line tool that lets you flexibly build LLM context from your codebase using glob patterns, URLs, and keyword searches. It then automatically applies file edits directly from the LLM's response.
-
-## Usage
-PatchLLM is designed to be used directly from your terminal.
-
-### 1. Initialize a Configuration
-The easiest way to get started is to run the interactive initializer. This will create a `configs.py` file for you.
-
-```bash
-patchllm --init
-```
-
-This will guide you through creating your first context configuration, including setting a base path and file patterns. You can add multiple configurations to this file.
-
-A generated `configs.py` might look like this:
-```python
-# configs.py
-configs = {
-    "default": {
-        "path": ".",
-        "include_patterns": ["**/*.py"],
-        "exclude_patterns": ["**/tests/*", "venv/*"],
-        "urls": ["https://docs.python.org/3/library/argparse.html"]
-    },
-    "docs": {
-        "path": "./docs",
-        "include_patterns": ["**/*.md"],
-    }
-}
-```
-
-### 2. Run a Task
-Use the `patchllm` command with a configuration name and a task instruction.
-
-```bash
-# Apply a change using the 'default' configuration
-patchllm --config default --task "Add type hints to the main function in main.py"
-```
-
-The tool will then:
-1.  Build a context from the files and URLs matching your configuration.
-2.  Send the context and your task to the configured LLM.
-3.  Parse the response and automatically write the changes to the relevant files.
-
-### All Commands & Options
-
-#### Configuration Management
-*   `--init`: Create a new configuration interactively.
-*   `--list-configs`: List all available configurations from your `configs.py`.
-*   `--show-config <name>`: Display the settings for a specific configuration.
-
-#### Core Task Execution
-*   `--config <name>`: The name of the configuration to use for building context.
-*   `--task "<instruction>"`: The task instruction for the LLM.
-*   `--model <model_name>`: Specify a different model (e.g., `claude-3-opus`). Defaults to `gemini/gemini-1.5-flash`.
-
-#### Context Handling
-*   `--context-out [filename]`: Save the generated context to a file (defaults to `context.md`) instead of sending it to the LLM.
-*   `--context-in <filename>`: Use a previously saved context file directly, skipping context generation.
-*   `--update False`: A flag to prevent sending the prompt to the LLM. Useful when you only want to generate and save the context with `--context-out`.
-
-#### Alternative Inputs
-*   `--from-file <filename>`: Apply file patches directly from a local file instead of from an LLM response.
-*   `--from-clipboard`: Apply file patches directly from your clipboard content.
-*   `--voice True`: Use voice recognition to provide the task instruction. Requires extra dependencies.
-
-### Setup
-
-PatchLLM uses [LiteLLM](https://github.com/BerriAI/litellm) under the hood. Please refer to their documentation for setting up API keys (e.g., `OPENAI_API_KEY`, `GEMINI_API_KEY`) in a `.env` file and for a full list of available models.
-
-To use the voice feature (`--voice True`), you will need to install extra dependencies:
-```bash
-pip install "speechrecognition>=3.10" "pyttsx3>=2.90"
-# Note: speechrecognition may require PyAudio, which might have system-level dependencies.
-```
-
-## License
-
-This project is licensed under the MIT License. See the `LICENSE` file for details.

patchllm-0.2.1.dist-info/RECORD

@@ -1,12 +0,0 @@
-patchllm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-patchllm/context.py,sha256=BZxhUUnlwejcY3I5jfIuk9r2xAqgN1eNcOARmD5VLzU,8520
-patchllm/listener.py,sha256=VjQ_CrSRT4-PolXAAradPKyt8NSUaUQwvgPNH7Oi9q0,968
-patchllm/main.py,sha256=lwEE98yFULW1C0Lo9i1z5u9_r7zJYPSalWxh8juSRT8,12931
-patchllm/parser.py,sha256=DNcf9iUH8umExfK78CSIwac1Bbu7K9iE3754y7CvYzs,3229
-patchllm/utils.py,sha256=hz28hd017gRGT632VQAYLPdX0KAS1GLvZzeUDCKbLc0,647
-patchllm-0.2.1.dist-info/licenses/LICENSE,sha256=vZxgIRNxffjkTV2NWLemgYjDRu0hSMTyFXCZ1zEWbUc,1077
-patchllm-0.2.1.dist-info/METADATA,sha256=zbk1TqpmkEbpXV1jtjLP34CYZ_MyDboZCRQ9FTnNCNk,5429
-patchllm-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-patchllm-0.2.1.dist-info/entry_points.txt,sha256=xm-W7FKOQd3o9RgK_4krVnO2sC8phpYxDCobf0htLiU,48
-patchllm-0.2.1.dist-info/top_level.txt,sha256=SLIZj9EhBXbSnYrbnV8EjL-OfNz-hXRwABCPCjE5Fas,9
-patchllm-0.2.1.dist-info/RECORD,,

patchllm-0.2.1.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-patchllm = patchllm.main:main