basic-open-agent-tools 0.4.0__tar.gz → 0.4.2__tar.gz

{basic_open_agent_tools-0.4.0/src/basic_open_agent_tools.egg-info → basic_open_agent_tools-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-open-agent-tools
-Version: 0.4.0
+Version: 0.4.2
 Summary: An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
 Home-page: https://github.com/open-agent-tools/basic-open-agent-tools
 Author: Open Agent Tools

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta:__legacy__"
 
 [project]
 name = "basic-open-agent-tools"
-version = "0.4.0"  # Advanced data processing modules complete
+version = "0.4.2"  # Add targeted file editing functions for safer agent operations
 description = "An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions."
 readme = "README.md"
 requires-python = ">=3.8"

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2}/src/basic_open_agent_tools/file_system/__init__.py

@@ -27,9 +27,11 @@ from .operations import (
     create_directory,
     delete_directory,
     delete_file,
+    insert_at_line,
     list_directory_contents,
     move_file,
     read_file_to_string,
+    replace_in_file,
     write_file_from_string,
 )
 from .tree import (
@@ -47,6 +49,8 @@ __all__ = [
     "read_file_to_string",
     "write_file_from_string",
     "append_to_file",
+    "replace_in_file",
+    "insert_at_line",
     # Directory operations
     "list_directory_contents",
     "create_directory",

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2}/src/basic_open_agent_tools/file_system/operations.py

@@ -233,3 +233,98 @@ def copy_file(source_path: str, destination_path: str) -> bool:
         return True
     except OSError as e:
         raise FileSystemError(f"Failed to copy {src_path} to {dst_path}: {e}")
+
+
+def replace_in_file(
+    file_path: str, old_text: str, new_text: str, count: int = -1
+) -> bool:
+    """Replace occurrences of text within a file without rewriting the entire content.
+
+    This function performs targeted text replacement, making it safer for agents
+    to make small changes without accidentally removing other content.
+
+    Args:
+        file_path: Path to the file to modify
+        old_text: Text to search for and replace
+        new_text: Text to replace the old text with
+        count: Maximum number of replacements to make (-1 for all occurrences)
+
+    Returns:
+        True if successful (even if no replacements were made)
+
+    Raises:
+        FileSystemError: If file doesn't exist, can't be read, or write fails
+        ValueError: If old_text is empty
+    """
+    if not old_text:
+        raise ValueError("old_text cannot be empty")
+
+    validate_file_content(new_text, "replace")
+    path = validate_path(file_path, "replace")
+
+    if not path.is_file():
+        raise FileSystemError(f"File not found: {path}")
+
+    try:
+        # Read current content
+        content = path.read_text(encoding="utf-8")
+
+        # Perform replacement
+        updated_content = content.replace(old_text, new_text, count)
+
+        # Write back to file
+        path.write_text(updated_content, encoding="utf-8")
+        return True
+    except (OSError, UnicodeDecodeError) as e:
+        raise FileSystemError(f"Failed to replace text in file {path}: {e}")
+
+
+def insert_at_line(file_path: str, line_number: int, content: str) -> bool:
+    """Insert content at a specific line number in a file.
+
+    This function allows precise insertion of text at a specific line,
+    making it safer for agents to add content without overwriting files.
+
+    Args:
+        file_path: Path to the file to modify
+        line_number: Line number to insert at (1-based indexing)
+        content: Content to insert (will be added as a new line)
+
+    Returns:
+        True if successful
+
+    Raises:
+        FileSystemError: If file doesn't exist, can't be read, or write fails
+        ValueError: If line_number is less than 1
+    """
+    if line_number < 1:
+        raise ValueError("line_number must be 1 or greater")
+
+    validate_file_content(content, "insert")
+    path = validate_path(file_path, "insert")
+
+    if not path.is_file():
+        raise FileSystemError(f"File not found: {path}")
+
+    try:
+        # Read current lines
+        lines = path.read_text(encoding="utf-8").splitlines(keepends=True)
+
+        # Ensure content ends with newline if it doesn't already
+        if content and not content.endswith("\n"):
+            content += "\n"
+
+        # Insert at specified line (convert to 0-based index)
+        insert_index = line_number - 1
+
+        # If line number is beyond file length, append to end
+        if insert_index >= len(lines):
+            lines.append(content)
+        else:
+            lines.insert(insert_index, content)
+
+        # Write back to file
+        path.write_text("".join(lines), encoding="utf-8")
+        return True
+    except (OSError, UnicodeDecodeError) as e:
+        raise FileSystemError(f"Failed to insert content in file {path}: {e}")

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2/src/basic_open_agent_tools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-open-agent-tools
-Version: 0.4.0
+Version: 0.4.2
 Summary: An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
 Home-page: https://github.com/open-agent-tools/basic-open-agent-tools
 Author: Open Agent Tools

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2}/tests/test_data_transform.py

@@ -1,6 +1,5 @@
 """Tests for data transformation functions."""
 
-
 import pytest
 
 from basic_open_agent_tools.data.transform import (

{basic_open_agent_tools-0.4.0 → basic_open_agent_tools-0.4.2}/tests/test_file_system_tools.py

@@ -72,15 +72,96 @@ class TestFileSystemModule:
             assert "subdir1" in shallow_tree
             assert "nested" not in shallow_tree
 
+    def test_replace_in_file(self):
+        """Test targeted text replacement in files."""
+        with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".txt") as f:
+            test_file = f.name
+
+        try:
+            # Create test file with content
+            content = "Hello world!\nThis is a test.\nHello again!"
+            file_system.write_file_from_string(test_file, content)
+
+            # Test replacement
+            result = file_system.replace_in_file(test_file, "Hello", "Hi")
+            assert result is True
+
+            # Verify replacement
+            updated_content = file_system.read_file_to_string(test_file)
+            assert "Hi world!" in updated_content
+            assert "Hi again!" in updated_content
+            assert "This is a test." in updated_content
+
+            # Test limited replacement count
+            file_system.write_file_from_string(test_file, content)
+            result = file_system.replace_in_file(test_file, "Hello", "Hi", count=1)
+            assert result is True
+
+            updated_content = file_system.read_file_to_string(test_file)
+            assert updated_content.count("Hi") == 1
+            assert updated_content.count("Hello") == 1
+
+        finally:
+            if os.path.exists(test_file):
+                os.unlink(test_file)
+
+    def test_insert_at_line(self):
+        """Test inserting content at specific line numbers."""
+        with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".txt") as f:
+            test_file = f.name
+
+        try:
+            # Create test file with multiple lines
+            content = "Line 1\nLine 2\nLine 3"
+            file_system.write_file_from_string(test_file, content)
+
+            # Test inserting at beginning
+            result = file_system.insert_at_line(test_file, 1, "New Line 1")
+            assert result is True
+
+            updated_content = file_system.read_file_to_string(test_file)
+            lines = updated_content.split("\n")
+            assert lines[0] == "New Line 1"
+            assert lines[1] == "Line 1"
+
+            # Test inserting in middle
+            file_system.write_file_from_string(test_file, content)
+            result = file_system.insert_at_line(test_file, 2, "Inserted Line")
+            assert result is True
+
+            updated_content = file_system.read_file_to_string(test_file)
+            lines = updated_content.split("\n")
+            assert lines[0] == "Line 1"
+            assert lines[1] == "Inserted Line"
+            assert lines[2] == "Line 2"
+
+            # Test inserting beyond file length (should append)
+            file_system.write_file_from_string(test_file, content)
+            result = file_system.insert_at_line(test_file, 10, "Appended Line")
+            assert result is True
+
+            updated_content = file_system.read_file_to_string(test_file)
+            assert "Appended Line" in updated_content
+
+        finally:
+            if os.path.exists(test_file):
+                os.unlink(test_file)
+
     def test_submodule_imports(self):
         """Test that individual submodules can be imported."""
         from basic_open_agent_tools.file_system.info import file_exists
-        from basic_open_agent_tools.file_system.operations import read_file_to_string
+        from basic_open_agent_tools.file_system.operations import (
+            insert_at_line,
+            read_file_to_string,
+            replace_in_file,
+        )
         from basic_open_agent_tools.file_system.tree import list_all_directory_contents
         from basic_open_agent_tools.file_system.validation import validate_path
 
         # Just test that imports work
         assert callable(read_file_to_string)
+        assert callable(replace_in_file)
+        assert callable(insert_at_line)
         assert callable(file_exists)
         assert callable(list_all_directory_contents)
         assert callable(validate_path)