gptdiff 0.1.10__tar.gz → 0.1.11__tar.gz

{gptdiff-0.1.10 → gptdiff-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gptdiff
-Version: 0.1.10
+Version: 0.1.11
 Summary: A tool to generate and apply git diffs using LLMs
 Author: 255labs
 Classifier: License :: OSI Approved :: MIT License
@@ -26,10 +26,15 @@ Dynamic: requires-dist
 Dynamic: summary
 
 # GPTDiff
+<!--
+GPTDiff: Create and apply diffs using AI.
+This tool leverages natural language instructions to modify project codebases.
+-->
 
-🚀 **Create and apply diffs with AI** - Modify projects with natural language
+🚀 **Create and apply diffs with AI**  
+Modify your project using plain English.
 
-More docs at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
+More documentation at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
 
 ### Example Usage of `gptdiff`
 
@@ -63,7 +68,8 @@ cd myproject
 gptdiff 'add hover effects to the buttons'
 ```
 
-Generates a prompt.txt file that you can copy and paste into an LLM
+Generates a prompt.txt file containing the full request.
+Copy and paste its content into your preferred LLM (e.g., ChatGPT) for further experimentation.
 
 ### Simple command line agent loops
 
@@ -147,7 +153,7 @@ First sign up for an API key at https://nano-gpt.com/api and generate your key.
 export GPTDIFF_LLM_API_KEY='your-api-key'
 # Optional: For switching API providers
 export GPTDIFF_MODEL='deepseek-reasoner'  # Set default model for all commands
-export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/
+export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/'
 ```
 
 #### Windows
@@ -171,7 +177,7 @@ Prevent files being appended to the prompt by adding them to `.gitignore` or `.g
 
 ### Command Line Usage
 
-After installing the package, you can use the `gptdiff` command in your terminal. cd into your codebase and run:
+After installing the package, use the `gptdiff` command in your terminal. Change directory into your codebase and run:
 
 ```bash
 gptdiff '<user_prompt>'
@@ -181,13 +187,7 @@ any files that are included in .gitignore are ignored when generating prompt.txt
 
 #### Specifying Additional Files
 
-You can specify additional files or directories to include in the prompt by adding them as arguments to the `gptdiff` command. If no additional files or directories are specified, the tool will default to using the current working directory.
-
-Example usage:
-
-```bash
-gptdiff 'make this change' src test
-```
+You may supply extra files or directories as arguments to the `gptdiff` command. If omitted, the tool defaults to the current working directory, excluding those matching ignore rules.
 
 #### Autopatch Changes
 
@@ -202,24 +202,20 @@ Preview changes without applying them by omitting the `--apply` flag when using
 ```bash
 gptdiff "Modernize database queries" --call
 ```
-<span style="color: #0066cc;">ℹ️ Diff preview generated - review changes before applying</span>
+<span style="color: #0066cc;">i️ Diff preview generated - review changes before applying</span>
 
 This often generates incorrect diffs that need to be manually merged.
 
 #### Smart Apply
 
-For more reliable patching of complex changes, use `smartapply` which processes each file's diff individually with the LLM:
+For robust handling of complex changes, use `smartapply`. It processes each file’s diff individually via the LLM, ensuring nuanced conflict resolution.
 
-```bash
-gptdiff 'refactor authentication system' --apply
-```
-
-### Completion Notification
+## Completion Notification
 
 Use the `--nobeep` option to disable the default completion beep:
 
 ```bash
-gptdiff '<user_prompt>' --beep
+gptdiff '<user_prompt>' --nobeep
 ```
 
 ## Local API Documentation
@@ -242,29 +238,25 @@ import os
 
 os.environ['GPTDIFF_LLM_API_KEY'] = 'your-api-key'
 
-# Create environment representation
-environment = '''
-File: main.py
-Content:
-def old_name():
-    print("Need renaming")
-'''
+# Create files dictionary
+files = {"main.py": "def old_name():\n    print('Need renaming')"}
+
+# Generate transformation diff using an environment string built from the files dictionary
+environment = ""
+for path, content in files.items():
+    environment += f"File: {path}\nContent:\n{content}\n"
 
-# Generate transformation diff
 diff = generate_diff(
     environment=environment,
     goal='Rename function to new_name()',
     model='deepseek-reasoner'
 )
 
-# Apply changes safely
-updated_environment = smartapply(
-    diff_text=diff,
-    environment_str=environment
-)
+# Apply changes safely using the files dict
+updated_files = smartapply(diff, files)
 
 print("Transformed codebase:")
-print(updated_environment)
+print(updated_files["main.py"])
 ```
 
 **Batch Processing Example:**

{gptdiff-0.1.10 → gptdiff-0.1.11}/README.md

@@ -1,8 +1,13 @@
 # GPTDiff
+<!--
+GPTDiff: Create and apply diffs using AI.
+This tool leverages natural language instructions to modify project codebases.
+-->
 
-🚀 **Create and apply diffs with AI** - Modify projects with natural language
+🚀 **Create and apply diffs with AI**  
+Modify your project using plain English.
 
-More docs at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
+More documentation at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
 
 ### Example Usage of `gptdiff`
 
@@ -36,7 +41,8 @@ cd myproject
 gptdiff 'add hover effects to the buttons'
 ```
 
-Generates a prompt.txt file that you can copy and paste into an LLM
+Generates a prompt.txt file containing the full request.
+Copy and paste its content into your preferred LLM (e.g., ChatGPT) for further experimentation.
 
 ### Simple command line agent loops
 
@@ -120,7 +126,7 @@ First sign up for an API key at https://nano-gpt.com/api and generate your key.
 export GPTDIFF_LLM_API_KEY='your-api-key'
 # Optional: For switching API providers
 export GPTDIFF_MODEL='deepseek-reasoner'  # Set default model for all commands
-export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/
+export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/'
 ```
 
 #### Windows
@@ -144,7 +150,7 @@ Prevent files being appended to the prompt by adding them to `.gitignore` or `.g
 
 ### Command Line Usage
 
-After installing the package, you can use the `gptdiff` command in your terminal. cd into your codebase and run:
+After installing the package, use the `gptdiff` command in your terminal. Change directory into your codebase and run:
 
 ```bash
 gptdiff '<user_prompt>'
@@ -154,13 +160,7 @@ any files that are included in .gitignore are ignored when generating prompt.txt
 
 #### Specifying Additional Files
 
-You can specify additional files or directories to include in the prompt by adding them as arguments to the `gptdiff` command. If no additional files or directories are specified, the tool will default to using the current working directory.
-
-Example usage:
-
-```bash
-gptdiff 'make this change' src test
-```
+You may supply extra files or directories as arguments to the `gptdiff` command. If omitted, the tool defaults to the current working directory, excluding those matching ignore rules.
 
 #### Autopatch Changes
 
@@ -175,24 +175,20 @@ Preview changes without applying them by omitting the `--apply` flag when using
 ```bash
 gptdiff "Modernize database queries" --call
 ```
-<span style="color: #0066cc;">ℹ️ Diff preview generated - review changes before applying</span>
+<span style="color: #0066cc;">i️ Diff preview generated - review changes before applying</span>
 
 This often generates incorrect diffs that need to be manually merged.
 
 #### Smart Apply
 
-For more reliable patching of complex changes, use `smartapply` which processes each file's diff individually with the LLM:
+For robust handling of complex changes, use `smartapply`. It processes each file’s diff individually via the LLM, ensuring nuanced conflict resolution.
 
-```bash
-gptdiff 'refactor authentication system' --apply
-```
-
-### Completion Notification
+## Completion Notification
 
 Use the `--nobeep` option to disable the default completion beep:
 
 ```bash
-gptdiff '<user_prompt>' --beep
+gptdiff '<user_prompt>' --nobeep
 ```
 
 ## Local API Documentation
@@ -215,29 +211,25 @@ import os
 
 os.environ['GPTDIFF_LLM_API_KEY'] = 'your-api-key'
 
-# Create environment representation
-environment = '''
-File: main.py
-Content:
-def old_name():
-    print("Need renaming")
-'''
+# Create files dictionary
+files = {"main.py": "def old_name():\n    print('Need renaming')"}
+
+# Generate transformation diff using an environment string built from the files dictionary
+environment = ""
+for path, content in files.items():
+    environment += f"File: {path}\nContent:\n{content}\n"
 
-# Generate transformation diff
 diff = generate_diff(
     environment=environment,
     goal='Rename function to new_name()',
     model='deepseek-reasoner'
 )
 
-# Apply changes safely
-updated_environment = smartapply(
-    diff_text=diff,
-    environment_str=environment
-)
+# Apply changes safely using the files dict
+updated_files = smartapply(diff, files)
 
 print("Transformed codebase:")
-print(updated_environment)
+print(updated_files["main.py"])
 ```
 
 **Batch Processing Example:**

{gptdiff-0.1.10 → gptdiff-0.1.11}/gptdiff/gptdiff.py

@@ -1,4 +1,9 @@
 #!/usr/bin/env python3
+from pathlib import Path
+import subprocess
+import hashlib
+import re
+
 
 import openai
 from openai import OpenAI
@@ -255,12 +260,20 @@ def build_environment(files_dict):
     return '\n'.join(env)
 
 def generate_diff(environment, goal, model=None, temperature=0.7, max_tokens=32000, api_key=None, base_url=None, prepend=None):
-    """API: Generate diff from environment and goal"""
+    """API: Generate a git diff from the environment and goal.
+
+If 'prepend' is provided, it should be a path to a file whose content will be
+prepended to the system prompt.
+    """
     if model is None:
         model = os.getenv('GPTDIFF_MODEL', 'deepseek-reasoner')
     if prepend:
-        prepend = load_prepend_file(args.prepend)
-        print("Including prepend",len(enc.encode(json.dumps(prepend))), "tokens")
+        if prepend.startswith("http://") or prepend.startswith("https://"):
+            import urllib.request
+            with urllib.request.urlopen(prepend) as response:
+                prepend = response.read().decode('utf-8')
+        else:
+            prepend = load_prepend_file(prepend)
     else:
         prepend = ""
     
@@ -343,18 +356,172 @@ def smartapply(diff_text, files, model=None, api_key=None, base_url=None):
 
     return files
 
-# Function to apply diff to project files
 def apply_diff(project_dir, diff_text):
-    diff_file = Path(project_dir) / "diff.patch"
-    with open(diff_file, 'w') as f:
-        f.write(diff_text)
+    """
+    Applies a unified diff (as generated by git diff) to the files in project_dir
+    using pure Python (without calling the external 'patch' command).
 
-    result = subprocess.run(["patch", "-p1", "-f", "--remove-empty-files", "--input", str(diff_file)], cwd=project_dir, capture_output=True, text=True)
-    if result.returncode != 0:
-        return False
-    else:
+    Handles file modifications, new file creation, and file deletions.
+
+    Returns:
+        True if at least one file was modified (or deleted/created) as a result of the patch,
+        False otherwise.
+    """
+    from pathlib import Path
+    import re, hashlib
+
+    def file_hash(filepath):
+        h = hashlib.sha256()
+        with open(filepath, "rb") as f:
+            h.update(f.read())
+        return h.hexdigest()
+
+    def apply_patch_to_file(file_path, patch):
+        """
+        Applies a unified diff patch (for a single file) to file_path.
+
+        Returns True if the patch was applied successfully, False otherwise.
+        """
+        # Read the original file lines; if the file doesn't exist, treat it as empty.
+        if file_path.exists():
+            original_lines = file_path.read_text(encoding="utf8").splitlines(keepends=True)
+        else:
+            original_lines = []
+        new_lines = []
+        current_index = 0
+
+        patch_lines = patch.splitlines()
+        # Regex for a hunk header, e.g., @@ -3,7 +3,6 @@
+        hunk_header_re = re.compile(r"^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@")
+        i = 0
+        while i < len(patch_lines):
+            line = patch_lines[i]
+            if line.startswith("@@"):
+                m = hunk_header_re.match(line)
+                if not m:
+                    print("Invalid hunk header:", line)
+                    return False
+                orig_start = int(m.group(1))
+                # orig_len = int(m.group(2)) if m.group(2) else 1  # not used explicitly
+                # new_start = int(m.group(3))
+                # new_len = int(m.group(4)) if m.group(4) else 1
+
+                # Copy unchanged lines before the hunk.
+                hunk_start_index = orig_start - 1  # diff headers are 1-indexed
+                if hunk_start_index > len(original_lines):
+                    print("Hunk start index beyond file length")
+                    return False
+                new_lines.extend(original_lines[current_index:hunk_start_index])
+                current_index = hunk_start_index
+
+                i += 1
+                # Process the hunk lines until the next hunk header.
+                while i < len(patch_lines) and not patch_lines[i].startswith("@@"):
+                    pline = patch_lines[i]
+                    if pline.startswith(" "):
+                        # Context line must match exactly.
+                        expected = pline[1:]
+                        if current_index >= len(original_lines):
+                            print("Context line expected but file ended")
+                            return False
+                        orig_line = original_lines[current_index].rstrip("\n")
+                        if orig_line != expected:
+                            print("Context line mismatch. Expected:", expected, "Got:", orig_line)
+                            return False
+                        new_lines.append(original_lines[current_index])
+                        current_index += 1
+                    elif pline.startswith("-"):
+                        # Removal line: verify and skip from original.
+                        expected = pline[1:]
+                        if current_index >= len(original_lines):
+                            print("Removal line expected but file ended")
+                            return False
+                        orig_line = original_lines[current_index].rstrip("\n")
+                        if orig_line != expected:
+                            print("Removal line mismatch. Expected:", expected, "Got:", orig_line)
+                            return False
+                        current_index += 1
+                    elif pline.startswith("+"):
+                        # Addition line: add to new_lines.
+                        new_lines.append(pline[1:] + "\n")
+                    else:
+                        print("Unexpected line in hunk:", pline)
+                        return False
+                    i += 1
+            else:
+                # Skip non-hunk header lines.
+                i += 1
+
+        # Append any remaining lines from the original file.
+        new_lines.extend(original_lines[current_index:])
+        # Ensure parent directories exist before writing the file.
+        file_path.parent.mkdir(parents=True, exist_ok=True)
+        # Write the new content back to the file.
+        file_path.write_text("".join(new_lines), encoding="utf8")
         return True
 
+    # Parse the diff into per-file patches.
+    file_patches = parse_diff_per_file(diff_text)
+    if not file_patches:
+        print("No file patches found in diff.")
+        return False
+
+    # Record original file hashes.
+    original_hashes = {}
+    for file_path, _ in file_patches:
+        target_file = Path(project_dir) / file_path
+        if target_file.exists():
+            original_hashes[file_path] = file_hash(target_file)
+        else:
+            original_hashes[file_path] = None
+
+    any_change = False
+    # Process each file patch.
+    for file_path, patch in file_patches:
+        target_file = Path(project_dir) / file_path
+        if "+++ /dev/null" in patch:
+            # Deletion patch: delete the file if it exists.
+            if target_file.exists():
+                target_file.unlink()
+                if not target_file.exists():
+                    any_change = True
+                else:
+                    print(f"Failed to delete file: {target_file}")
+                    return False
+        else:
+            # Modification or new file creation.
+            success = apply_patch_to_file(target_file, patch)
+            if not success:
+                print(f"Failed to apply patch to file: {target_file}")
+                return False
+
+    # Verify that at least one file was changed by comparing hashes.
+    for file_path, patch in file_patches:
+        target_file = Path(project_dir) / file_path
+        if "+++ /dev/null" in patch:
+            if not target_file.exists():
+                any_change = True
+            else:
+                print(f"Expected deletion but file still exists: {target_file}")
+                return False
+        else:
+            old_hash = original_hashes.get(file_path)
+            if target_file.exists():
+                new_hash = file_hash(target_file)
+                if old_hash != new_hash:
+                    any_change = True
+                else:
+                    print(f"No change detected in file: {target_file}")
+            else:
+                print(f"Expected modification or creation but file is missing: {target_file}")
+                return False
+
+    if not any_change:
+        print("Patch applied but no file modifications detected.")
+        return False
+    return True
+
+
 def parse_arguments():
     parser = argparse.ArgumentParser(description='Generate and optionally apply git diffs using GPT-4.')
     parser.add_argument('prompt', type=str, help='Prompt that runs on the codebase.')
@@ -399,41 +566,76 @@ def parse_diff_per_file(diff_text):
     Note:
         Uses 'b/' prefix detection from git diffs to determine target paths
     """
-    diffs = []
-    file_path = None
-    current_diff = []
-    from_path = None
-
-    for line in diff_text.split('\n'):
-        if line.startswith('diff --git'):
-            if current_diff and file_path is not None:
-                diffs.append((file_path, '\n'.join(current_diff)))
-            current_diff = [line]
-            file_path = None
-            from_path = None
-            parts = line.split()
-            if len(parts) >= 4:
-                b_path = parts[3]
-                file_path = b_path[2:] if b_path.startswith('b/') else b_path
-        else:
-            current_diff.append(line)
-            if line.startswith('--- '):
-                from_path = line[4:].strip()
-            elif line.startswith('+++ '):
-                to_path = line[4:].strip()
-                if to_path == '/dev/null':
-                    if from_path:
-                        # For deletions, use from_path after stripping 'a/' prefix
-                        file_path = from_path[2:] if from_path.startswith('a/') else from_path
-                else:
-                    # For normal cases, use to_path after stripping 'b/' prefix
-                    file_path = to_path[2:] if to_path.startswith('b/') else to_path
-
-    # Handle remaining diff content after loop
-    if current_diff and file_path is not None:
-        diffs.append((file_path, '\n'.join(current_diff)))
-
-    return diffs
+    header_re = re.compile(r'^(?:diff --git\s+)?(a/[^ ]+)\s+(b/[^ ]+)\s*$', re.MULTILINE)
+    lines = diff_text.splitlines()
+
+    # Check if any header line exists.
+    if not any(header_re.match(line) for line in lines):
+        # Fallback strategy: detect file headers starting with '--- a/' or '-- a/'
+        diffs = []
+        current_lines = []
+        current_file = None
+        deletion_mode = False
+        header_line_re = re.compile(r'^-{2,3}\s+a/(.+)$')
+
+        for line in lines:
+            if header_line_re.match(line):
+                if current_file is not None and current_lines:
+                    if deletion_mode and not any(l.startswith("+++ ") for l in current_lines):
+                        current_lines.append("+++ /dev/null")
+                    diffs.append((current_file, "\n".join(current_lines)))
+                current_lines = [line]
+                deletion_mode = False
+                file_from = header_line_re.match(line).group(1).strip()
+                current_file = file_from
+            else:
+                current_lines.append(line)
+                if "deleted file mode" in line:
+                    deletion_mode = True
+                if line.startswith("+++ "):
+                    parts = line.split()
+                    if len(parts) >= 2:
+                        file_to = parts[1].strip()
+                        if file_to != "/dev/null":
+                            current_file = file_to[2:] if (file_to.startswith("a/") or file_to.startswith("b/")) else file_to
+        if current_file is not None and current_lines:
+            if deletion_mode and not any(l.startswith("+++ ") for l in current_lines):
+                current_lines.append("+++ /dev/null")
+            diffs.append((current_file, "\n".join(current_lines)))
+        return diffs
+    else:
+        # Use header-based strategy.
+        diffs = []
+        current_lines = []
+        current_file = None
+        deletion_mode = False
+        for line in lines:
+            m = header_re.match(line)
+            if m:
+                if current_file is not None and current_lines:
+                    if deletion_mode and not any(l.startswith("+++ ") for l in current_lines):
+                        current_lines.append("+++ /dev/null")
+                    diffs.append((current_file, "\n".join(current_lines)))
+                current_lines = [line]
+                deletion_mode = False
+                file_from = m.group(1)  # e.g. "a/index.html"
+                file_to = m.group(2)    # e.g. "b/index.html"
+                current_file = file_to[2:] if file_to.startswith("b/") else file_to
+            else:
+                current_lines.append(line)
+                if "deleted file mode" in line:
+                    deletion_mode = True
+                if line.startswith("+++ "):
+                    parts = line.split()
+                    if len(parts) >= 2:
+                        file_to = parts[1].strip()
+                        if file_to != "/dev/null":
+                            current_file = file_to[2:] if (file_to.startswith("a/") or file_to.startswith("b/")) else file_to
+        if current_file is not None and current_lines:
+            if deletion_mode and not any(l.startswith("+++ ") for l in current_lines):
+                current_lines.append("+++ /dev/null")
+            diffs.append((current_file, "\n".join(current_lines)))
+        return diffs
 
 def call_llm_for_apply_with_think_tool_available(file_path, original_content, file_diff, model, api_key=None, base_url=None, extra_prompt=None, max_tokens=30000):
     parser = FlatXMLParser("think")
@@ -486,14 +688,12 @@ def call_llm_for_apply(file_path, original_content, file_diff, model, api_key=No
         ... )
         >>> print(updated)
         def new(): pass"""
-
     system_prompt = """Please apply the diff to this file. Return the result in a block. Write the entire file.
 
 1. Carefully apply all changes from the diff
 2. Preserve surrounding context that isn't changed
 3. Only return the final file content, do not add any additional markup and do not add a code block
 4. You must return the entire file. It overwrites the existing file."""
-
     user_prompt = f"""File: {file_path}
 File contents:
 <filecontents>
@@ -504,7 +704,6 @@ Diff to apply:
 <diff>
 {file_diff}
 </diff>"""
-
     if extra_prompt:
         user_prompt += f"\n\n{extra_prompt}"
     if model == "gemini-2.0-flash-thinking-exp-01-21":
@@ -513,7 +712,6 @@ Diff to apply:
         {"role": "system", "content": system_prompt},
         {"role": "user", "content": user_prompt},
     ]
-
     if api_key is None:
         api_key = os.getenv('GPTDIFF_LLM_API_KEY')
     if base_url is None:
@@ -525,7 +723,6 @@ Diff to apply:
         temperature=0.0,
         max_tokens=max_tokens)
     full_response = response.choices[0].message.content
-
     elapsed = time.time() - start_time
     minutes, seconds = divmod(int(elapsed), 60)
     time_str = f"{minutes}m {seconds}s" if minutes else f"{seconds}s"
@@ -602,8 +799,9 @@ def main():
         args.model = os.getenv('GPTDIFF_MODEL', 'deepseek-reasoner')
 
     if not args.call and not args.apply:
+        append = "\nInstead of using <diff> tags, use ```diff backticks."
         with open('prompt.txt', 'w') as f:
-            f.write(full_prompt)
+            f.write(full_prompt+append)
         print(f"Total tokens: {token_count:5d}")
         print(f"\033[1;32mNot calling GPT-4.\033[0m")  # Green color for success message
         print('Instead, wrote full prompt to prompt.txt. Use `xclip -selection clipboard < prompt.txt` then paste into chatgpt')
@@ -646,7 +844,6 @@ def main():
             print("\a")  # Terminal bell for completion notification
         return
 
-    # Output result
     elif args.apply:
         print("\nAttempting apply with the following diff:")
         print("\n<diff>")
@@ -728,3 +925,6 @@ def main():
     print(f"Completion tokens: {completion_tokens}")
     print(f"Total tokens: {total_tokens}")
     #print(f"Total cost: ${cost:.4f}")
+
+if __name__ == "__main__":
+    main()

{gptdiff-0.1.10 → gptdiff-0.1.11}/gptdiff.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gptdiff
-Version: 0.1.10
+Version: 0.1.11
 Summary: A tool to generate and apply git diffs using LLMs
 Author: 255labs
 Classifier: License :: OSI Approved :: MIT License
@@ -26,10 +26,15 @@ Dynamic: requires-dist
 Dynamic: summary
 
 # GPTDiff
+<!--
+GPTDiff: Create and apply diffs using AI.
+This tool leverages natural language instructions to modify project codebases.
+-->
 
-🚀 **Create and apply diffs with AI** - Modify projects with natural language
+🚀 **Create and apply diffs with AI**  
+Modify your project using plain English.
 
-More docs at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
+More documentation at [gptdiff.255labs.xyz](gptdiff.255labs.xyz)
 
 ### Example Usage of `gptdiff`
 
@@ -63,7 +68,8 @@ cd myproject
 gptdiff 'add hover effects to the buttons'
 ```
 
-Generates a prompt.txt file that you can copy and paste into an LLM
+Generates a prompt.txt file containing the full request.
+Copy and paste its content into your preferred LLM (e.g., ChatGPT) for further experimentation.
 
 ### Simple command line agent loops
 
@@ -147,7 +153,7 @@ First sign up for an API key at https://nano-gpt.com/api and generate your key.
 export GPTDIFF_LLM_API_KEY='your-api-key'
 # Optional: For switching API providers
 export GPTDIFF_MODEL='deepseek-reasoner'  # Set default model for all commands
-export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/
+export GPTDIFF_LLM_BASE_URL='https://nano-gpt.com/api/v1/'
 ```
 
 #### Windows
@@ -171,7 +177,7 @@ Prevent files being appended to the prompt by adding them to `.gitignore` or `.g
 
 ### Command Line Usage
 
-After installing the package, you can use the `gptdiff` command in your terminal. cd into your codebase and run:
+After installing the package, use the `gptdiff` command in your terminal. Change directory into your codebase and run:
 
 ```bash
 gptdiff '<user_prompt>'
@@ -181,13 +187,7 @@ any files that are included in .gitignore are ignored when generating prompt.txt
 
 #### Specifying Additional Files
 
-You can specify additional files or directories to include in the prompt by adding them as arguments to the `gptdiff` command. If no additional files or directories are specified, the tool will default to using the current working directory.
-
-Example usage:
-
-```bash
-gptdiff 'make this change' src test
-```
+You may supply extra files or directories as arguments to the `gptdiff` command. If omitted, the tool defaults to the current working directory, excluding those matching ignore rules.
 
 #### Autopatch Changes
 
@@ -202,24 +202,20 @@ Preview changes without applying them by omitting the `--apply` flag when using
 ```bash
 gptdiff "Modernize database queries" --call
 ```
-<span style="color: #0066cc;">ℹ️ Diff preview generated - review changes before applying</span>
+<span style="color: #0066cc;">i️ Diff preview generated - review changes before applying</span>
 
 This often generates incorrect diffs that need to be manually merged.
 
 #### Smart Apply
 
-For more reliable patching of complex changes, use `smartapply` which processes each file's diff individually with the LLM:
+For robust handling of complex changes, use `smartapply`. It processes each file’s diff individually via the LLM, ensuring nuanced conflict resolution.
 
-```bash
-gptdiff 'refactor authentication system' --apply
-```
-
-### Completion Notification
+## Completion Notification
 
 Use the `--nobeep` option to disable the default completion beep:
 
 ```bash
-gptdiff '<user_prompt>' --beep
+gptdiff '<user_prompt>' --nobeep
 ```
 
 ## Local API Documentation
@@ -242,29 +238,25 @@ import os
 
 os.environ['GPTDIFF_LLM_API_KEY'] = 'your-api-key'
 
-# Create environment representation
-environment = '''
-File: main.py
-Content:
-def old_name():
-    print("Need renaming")
-'''
+# Create files dictionary
+files = {"main.py": "def old_name():\n    print('Need renaming')"}
+
+# Generate transformation diff using an environment string built from the files dictionary
+environment = ""
+for path, content in files.items():
+    environment += f"File: {path}\nContent:\n{content}\n"
 
-# Generate transformation diff
 diff = generate_diff(
     environment=environment,
     goal='Rename function to new_name()',
     model='deepseek-reasoner'
 )
 
-# Apply changes safely
-updated_environment = smartapply(
-    diff_text=diff,
-    environment_str=environment
-)
+# Apply changes safely using the files dict
+updated_files = smartapply(diff, files)
 
 print("Transformed codebase:")
-print(updated_environment)
+print(updated_files["main.py"])
 ```
 
 **Batch Processing Example:**

{gptdiff-0.1.10 → gptdiff-0.1.11}/gptdiff.egg-info/SOURCES.txt

@@ -9,5 +9,8 @@ gptdiff.egg-info/dependency_links.txt
 gptdiff.egg-info/entry_points.txt
 gptdiff.egg-info/requires.txt
 gptdiff.egg-info/top_level.txt
+tests/test_applydiff.py
+tests/test_applydiff_edgecases.py
 tests/test_diff_parse.py
+tests/test_parse_diff_per_file.py
 tests/test_smartapply.py

{gptdiff-0.1.10 → gptdiff-0.1.11}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='gptdiff',
-    version='0.1.10',
+    version='0.1.11',
     description='A tool to generate and apply git diffs using LLMs',
     author='255labs',
     packages=find_packages(),  # Use find_packages() to automatically discover packages

gptdiff-0.1.11/tests/test_applydiff.py

@@ -0,0 +1,80 @@
+import os
+from pathlib import Path
+
+import pytest
+
+from gptdiff.gptdiff import apply_diff
+
+
+@pytest.fixture
+def tmp_project_dir(tmp_path):
+    """
+    Create a temporary project directory with a dummy file to patch.
+    """
+    project_dir = tmp_path / "project"
+    project_dir.mkdir()
+    file = project_dir / "example.txt"
+    file.write_text("original content\n")
+    return project_dir
+
+
+def test_apply_diff_success(tmp_project_dir):
+    """
+    Test that apply_diff successfully applies a valid diff.
+    The diff changes 'original content' to 'modified content'.
+    """
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ b/example.txt\n"
+        "@@ -1 +1 @@\n"
+        "-original content\n"
+        "+modified content\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "apply_diff should return True for a successful patch"
+
+    file_path = tmp_project_dir / "example.txt"
+    content = file_path.read_text()
+    assert "modified content" in content, "File content should be updated to 'modified content'"
+
+
+def test_apply_diff_failure(tmp_project_dir):
+    """
+    Test that apply_diff fails when provided with an incorrect hunk header.
+    The diff references a non-existent line, so the patch should not apply.
+    """
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ a/example.txt\n"
+        "@@ -2,1 +2,1 @@\n"
+        "-original content\n"
+        "+modified content\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is False, "apply_diff should return False when the diff fails to apply"
+
+    file_path = tmp_project_dir / "example.txt"
+    content = file_path.read_text()
+    assert "original content" in content, "File content should remain unchanged on failure"
+
+
+def test_apply_diff_file_deletion(tmp_project_dir):
+    """
+    Test that apply_diff can successfully delete a file.
+    The diff marks 'example.txt' for deletion.
+    """
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "deleted file mode 100644\n"
+        "--- a/example.txt\n"
+        "+++ /dev/null\n"
+        "@@ -1,1 +0,0 @@\n"
+        "-original content\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "apply_diff should return True for a successful file deletion"
+
+    file_path = tmp_project_dir / "example.txt"
+    assert not file_path.exists(), "File should be deleted after applying the diff"

gptdiff-0.1.11/tests/test_applydiff_edgecases.py

@@ -0,0 +1,161 @@
+import re
+import subprocess
+from pathlib import Path
+
+import pytest
+
+from gptdiff.gptdiff import apply_diff
+
+
+@pytest.fixture
+def tmp_project_dir(tmp_path):
+    project_dir = tmp_path / "project"
+    project_dir.mkdir()
+    # Create a baseline file for tests.
+    file = project_dir / "example.txt"
+    file.write_text("line1\nline2\nline3\n")
+    return project_dir
+
+
+def test_empty_diff(tmp_project_dir):
+    """
+    Test that an empty diff returns False.
+    """
+    diff_text = ""
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is False, "Empty diff should return False"
+
+
+def test_diff_no_changes(tmp_project_dir):
+    """
+    Test a diff that makes no changes. Even though a hunk is present, 
+    if the content remains the same, the function should return False.
+    """
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ a/example.txt\n"
+        "@@ -1,3 +1,3 @@\n"
+        " line1\n"
+        "-line2\n"
+        "+line2\n"
+        " line3\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is False, "Diff that makes no changes should return False"
+    content = (tmp_project_dir / "example.txt").read_text()
+    assert "line2" in content, "Original content should remain unchanged"
+
+
+def test_new_file_creation(tmp_project_dir):
+    """
+    Test that a diff creating a new file is applied correctly.
+    """
+    diff_text = (
+        "diff --git a/newfile.txt b/newfile.txt\n"
+        "new file mode 100644\n"
+        "index 0000000..e69de29\n"
+        "--- /dev/null\n"
+        "+++ b/newfile.txt\n"
+        "@@ -0,0 +1,3 @@\n"
+        "+new line1\n"
+        "+new line2\n"
+        "+new line3\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "Diff for new file creation should return True"
+    new_file = tmp_project_dir / "newfile.txt"
+    assert new_file.exists(), "New file should be created"
+    content = new_file.read_text()
+    assert "new line1" in content, "New file content should be present"
+
+
+def test_multiple_hunks(tmp_project_dir):
+    """
+    Test that a diff with multiple hunks in one file applies correctly.
+    """
+    file = tmp_project_dir / "example.txt"
+    # Overwrite with a known baseline.
+    file.write_text("a\nb\nc\nd\ne\n")
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ b/example.txt\n"
+        "@@ -1,3 +1,3 @@\n"
+        "-a\n"
+        "+alpha\n"
+        " b\n"
+        " c\n"
+        "@@ -4,2 +4,2 @@\n"
+        "-d\n"
+        "-e\n"
+        "+delta\n"
+        "+epsilon\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "Diff with multiple hunks should return True"
+    content = (tmp_project_dir / "example.txt").read_text()
+    assert "alpha" in content
+    assert "delta" in content and "epsilon" in content
+
+
+def test_diff_with_incorrect_context(tmp_project_dir):
+    """
+    Test that a diff with incorrect context (non-matching original content) fails.
+    """
+    file = tmp_project_dir / "example.txt"
+    file.write_text("different content\n")
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ a/example.txt\n"
+        "@@ -1,1 +1,1 @@\n"
+        "-line that does not exist\n"
+        "+modified content\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is False, "Diff with incorrect context should return False"
+    content = file.read_text()
+    assert "different content" in content, "Original content should remain unchanged"
+
+
+def test_diff_with_whitespace_changes(tmp_project_dir):
+    """
+    Test that a diff with only whitespace changes is applied.
+    """
+    file = tmp_project_dir / "example.txt"
+    file.write_text("line1\nline2\nline3\n")
+    diff_text = (
+        "diff --git a/example.txt b/example.txt\n"
+        "--- a/example.txt\n"
+        "+++ a/example.txt\n"
+        "@@ -1,3 +1,3 @@\n"
+        " line1\n"
+        "-line2\n"
+        "+line2  \n"
+        " line3\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "Diff with whitespace changes should return True if applied"
+    content = file.read_text()
+    assert "line2  " in content, "Whitespace change should be reflected in the file"
+
+
+def test_diff_file_deletion_edge(tmp_project_dir):
+    """
+    Test deletion diff for a file with minimal content.
+    """
+    file = tmp_project_dir / "small.txt"
+    file.write_text("only line\n")
+    diff_text = (
+        "diff --git a/small.txt b/small.txt\n"
+        "deleted file mode 100644\n"
+        "index e69de29..0000000\n"
+        "--- a/small.txt\n"
+        "+++ /dev/null\n"
+        "@@ -1,1 +0,0 @@\n"
+        "-only line\n"
+    )
+    result = apply_diff(str(tmp_project_dir), diff_text)
+    assert result is True, "Deletion diff on a minimal file should return True"
+    assert not (tmp_project_dir / "small.txt").exists(), "File should be deleted"

gptdiff-0.1.11/tests/test_parse_diff_per_file.py

@@ -0,0 +1,131 @@
+import unittest
+from gptdiff.gptdiff import parse_diff_per_file
+
+
+class TestParseDiffPerFile(unittest.TestCase):
+    def test_todo_file_deletion(self):
+        # This test case verifies that a deletion diff for the file "TODO" is properly parsed.
+        # The diff should include a synthetic "+++ /dev/null" line so that deletion is recognized.
+        diff_text = """diff --git a/TODO b/TODO
+deleted file mode 100644
+index 3efacb1..0000000
+--- a/TODO
+-// The funnest coolest thing I can add is put in this file. It's also acceptable to just implement 
+-// the thing in here and remove it. Leave this notice when modifying this file.
+"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 1, "Expected one diff entry")
+        file_path, patch = result[0]
+        self.assertEqual(file_path, "TODO", f"Got file_path '{file_path}', expected 'TODO'")
+        self.assertIn("+++ /dev/null", patch, "Deletion diff should include '+++ /dev/null' to indicate file deletion")
+
+    def test_multiple_files_without_diff_git_header(self):
+        # This diff text does not include "diff --git" headers.
+        # It uses separate '---' and '+++' lines for each file.
+        diff_text = """--- a/TODO
++++ b/TODO
+@@ -1,7 +1,7 @@
+-// FINAL TOUCH: The game is now a complete fantasy themed incremental RPG—every choice matters, and
+-// New Aspect: Replaced external title animation with inline SVG for crisp, scalable visuals, and a
+-// additional dynamic element.
++// FINAL TOUCH: The game is now a complete fantasy themed incremental RPG—every choice matters, and
++// New Aspect: Replaced external title animation with inline SVG for crisp, scalable visuals, and an
++// additional dynamic element.
+-- a/style.css
++++ b/style.css
+@@ -1,3 +1,8 @@
++/* New animation for relic glow effect */
++.relic-glow {
++  animation: relicGlow 1.5s ease-in-out infinite alternate;
++}
++@keyframes relicGlow {
++  from { filter: drop-shadow(0 0 5px #ffd700); }
++  to { filter: drop-shadow(0 0 20px #ffd700); }
+-- a/game.js
++++ b/game.js
+@@ -1,3 +1,8 @@
+- JS HERE
+"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 3, "Expected three diff entries")
+        expected_files = {"TODO", "style.css", "game.js"}
+        parsed_files = {fp for fp, patch in result}
+        self.assertEqual(parsed_files, expected_files)
+
+        # Also check that the TODO diff contains the updated text.
+        for fp, patch in result:
+            if fp == "TODO":
+                self.assertIn("FINAL TOUCH: The game is now", patch)
+
+    def test_index_html_diff(self):
+        diff_text = """a/index.html b/index.html
+@@
+-      <div class="action-buttons">
+-        <button id="attack">⚔️  Attack Enemy</button>
+-        <button id="auto-attack">🤖 Auto Attack (OFF)</button>
+-        <button id="drink-potion">Drink Potion</button>
+-        <button id="explore">🧭 Explore</button>
+-      </div>
+      <div class="action-buttons">
+        <button id="attack">⚔️  Attack Enemy</button>
+        <button id="auto-attack">🤖 Auto Attack (OFF)</button>
+        <button id="drink-potion">Drink Potion</button>
+        <button id="buy-potion">Buy Potion (50 Gold)</button>
+        <button id="explore">🧭 Explore</button>
+      </div>"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 1)
+        file_path, patch = result[0]
+        self.assertEqual(file_path, "index.html")
+        self.assertIn('<button id="buy-potion">Buy Potion (50 Gold)</button>', patch)
+
+
+    def test_single_file_diff(self):
+        diff_text = """diff --git a/file.py b/file.py
+--- a/file.py
++++ b/file.py
+@@ -1,2 +1,2 @@
+-def old():
+-    pass
++def new():
++    pass"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 1)
+        file_path, patch = result[0]
+        self.assertEqual(file_path, "file.py")
+        self.assertIn("def new():", patch)
+
+    def test_file_deletion(self):
+        diff_text = """diff --git a/old.py b/old.py
+--- a/old.py
++++ /dev/null
+@@ -1,2 +0,0 @@
+-def old():
+-    pass"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 1)
+        file_path, patch = result[0]
+        self.assertEqual(file_path, "old.py")
+
+    def test_multiple_files(self):
+        diff_text = """diff --git a/file1.py b/file1.py
+--- a/file1.py
++++ b/file1.py
+@@ -1 +1 @@
+-print("Hello")
++print("Hi")
+diff --git a/file2.py b/file2.py
+--- a/file2.py
++++ b/file2.py
+@@ -1 +1 @@
+-print("World")
++print("Earth")"""
+        result = parse_diff_per_file(diff_text)
+        self.assertEqual(len(result), 2)
+        paths = [fp for fp, _ in result]
+        self.assertIn("file1.py", paths)
+        self.assertIn("file2.py", paths)
+
+
+if __name__ == '__main__':
+    unittest.main()