codetool-explore 0.6.0__tar.gz → 0.7.0__tar.gz

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codetool-explore
-Version: 0.6.0
+Version: 0.7.0
 Summary: Fast, dependency-free workspace search, read, and list exploration for coding-agent tools with Rust backend
 Project-URL: Homepage, https://github.com/pbi-agent/codetool-explore
 Project-URL: Repository, https://github.com/pbi-agent/codetool-explore
@@ -114,7 +114,9 @@ than one file is read, each file is prefixed by a compact `path:` header. Use
 `start_line` and `limit` to cap the returned line range; if more lines remain,
 text output starts with `-- more: cursor=N`. CSV files are read as ordinary
 text. Binary-looking, missing, unreadable, or directory paths fail with
-controlled `ExploreError` subclasses.
+controlled `ExploreError` subclasses. If `root` is already a file,
+`target="read"` reads that file directly, so accidental search-like `pattern`
+values from tool calls still produce the requested line range.
 
 `target="list"` treats `pattern` as one file/directory path and returns one
 directory level under each root. Text output uses the same compact tree display

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/README.md

@@ -84,7 +84,9 @@ than one file is read, each file is prefixed by a compact `path:` header. Use
 `start_line` and `limit` to cap the returned line range; if more lines remain,
 text output starts with `-- more: cursor=N`. CSV files are read as ordinary
 text. Binary-looking, missing, unreadable, or directory paths fail with
-controlled `ExploreError` subclasses.
+controlled `ExploreError` subclasses. If `root` is already a file,
+`target="read"` reads that file directly, so accidental search-like `pattern`
+values from tool calls still produce the requested line range.
 
 `target="list"` treats `pattern` as one file/directory path and returns one
 directory level under each root. Text output uses the same compact tree display

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codetool-explore"
-version = "0.6.0"
+version = "0.7.0"
 description = "Fast, dependency-free workspace search, read, and list exploration for coding-agent tools with Rust backend"
 readme = "README.md"
 authors = [

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/src/codetool_explore/explorer.py

@@ -252,7 +252,12 @@ def _resolve_explore_paths(
             raise ExploreArgumentError(f"{target} path must not be empty")
 
     return tuple(
-        _resolve_path_for_search_root(query, search_root=search_root, root_set=root_set)
+        _resolve_path_for_search_root(
+            query,
+            search_root=search_root,
+            root_set=root_set,
+            target=target,
+        )
         for search_root in root_set.roots
     )
 
@@ -262,10 +267,25 @@ def _resolve_path_for_search_root(
     *,
     search_root: SearchRoot,
     root_set: NormalizedRoots,
+    target: str,
 ) -> ResolvedExplorePath:
     root_abs = search_root.abs_path
     root_is_file = os.path.isfile(root_abs)
     root_base = root_abs if os.path.isdir(root_abs) else os.path.dirname(root_abs)
+    if target == "read" and root_is_file:
+        display_base = root_set.rel_base if root_set.has_multiple else root_base
+        display_path = _display_path(root_abs, display_base)
+        return ResolvedExplorePath(
+            query=query,
+            abs_path=root_abs,
+            display_path=display_path,
+            root_display=root_set.display,
+            display_base=display_base,
+            root_base=root_base,
+            search_root_abs=root_abs,
+            root_is_file=True,
+            rel_base_abs=root_set.rel_base,
+        )
     if os.path.isabs(query):
         abs_path = os.path.abspath(query)
         base = root_set.rel_base if root_set.has_multiple else root_base

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/tests/test_api.py

@@ -265,6 +265,41 @@ def test_read_target_defaults_to_plain_text_line_range(tmp_path):
     assert "2:" not in result
 
 
+def test_read_target_accepts_file_root_with_search_hint_pattern(tmp_path):
+    target = tmp_path / "webapp" / "src" / "styles" / "modal.css"
+    write(
+        target,
+        "one\n"
+        "two\n"
+        ".task-form-dialog {\n"
+        "  color: red;\n"
+        "}\n",
+    )
+
+    text = api.explore(
+        "task-form-dialog",
+        root=str(target),
+        target="read",
+        start_line=3,
+        limit=2,
+    )
+    full = api.explore(
+        "task-form-dialog",
+        root=str(target),
+        target="read",
+        start_line=3,
+        limit=2,
+        result_format="full",
+    )
+
+    assert text == "-- more: cursor=5\n.task-form-dialog {\n  color: red;"
+    assert full["pattern"] == "task-form-dialog"
+    assert full["root"] == str(target)
+    assert full["path"] == "modal.css"
+    assert full["returned"] == 2
+    assert full["next_cursor"] == "5"
+
+
 def test_read_target_reports_more_and_supports_csv_as_text(tmp_path):
     write(tmp_path / "data.csv", "name,value\nalpha,1\nbeta,2\n")
 

{codetool_explore-0.6.0 → codetool_explore-0.7.0}/uv.lock

@@ -86,7 +86,7 @@ wheels = [
 
 [[package]]
 name = "codetool-explore"
-version = "0.6.0"
+version = "0.7.0"
 source = { editable = "." }
 
 [package.dev-dependencies]