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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codetool-explore
-Version: 0.6.0
+Version: 0.7.1
 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.1}/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.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codetool-explore"
-version = "0.6.0"
+version = "0.7.1"
 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.1}/src/codetool_explore/api.py

@@ -10,6 +10,7 @@ from .compression import compress_result
 from .errors import ExploreArgumentError, ExploreBackendError, ExplorePatternError
 from .explorer import list_path_target, read_file_target
 from .python_backend import resolve_case, search_python
+from .regex import compile_regex
 from .roots import RootInput
 from .rust_backend import RustBackendUnavailable, find_rust_binary, search_rust
 from .text_output import format_text_result
@@ -68,7 +69,7 @@ def _regex_can_produce_empty_match(pattern: str, *, case: str) -> bool:
     _, case_sensitive = resolve_case(requested_case, pattern)
     flags = 0 if case_sensitive else re.IGNORECASE
     try:
-        compiled = re.compile(pattern, flags)
+        compiled = compile_regex(pattern, flags)
     except re.error as exc:
         raise ExplorePatternError(f"invalid regex: {exc}") from exc
     return any(

{codetool_explore-0.6.0 → codetool_explore-0.7.1}/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.1}/src/codetool_explore/python_backend/matcher.py

@@ -6,6 +6,7 @@ import re
 from dataclasses import dataclass
 from typing import TypeAlias
 
+from ..regex import compile_regex
 from .literal import LiteralMatcher
 from .regex_search import RegexLineMatcher
 
@@ -22,7 +23,7 @@ def build_content_matcher(
 
     if regex:
         flags = 0 if case_sensitive else re.IGNORECASE
-        return RegexLineMatcher(re.compile(pattern, flags))
+        return RegexLineMatcher(compile_regex(pattern, flags))
     needle = pattern.encode("utf-8", errors="surrogatepass")
     return LiteralMatcher(needle=needle, case_sensitive=case_sensitive)
 
@@ -49,7 +50,7 @@ class PathMatcher:
         compiled = None
         if regex:
             flags = 0 if case_sensitive else re.IGNORECASE
-            compiled = re.compile(pattern, flags)
+            compiled = compile_regex(pattern, flags)
         return cls(
             pattern=pattern,
             regex=regex,
@@ -76,4 +77,4 @@ def path_match_subject(rel_path: str, path_scope: str) -> str:
 
     if path_scope == "basename":
         return rel_path.rsplit("/", 1)[-1]
-    return rel_path
+    return rel_path

codetool_explore-0.7.1/src/codetool_explore/regex.py

@@ -0,0 +1,14 @@
+"""Shared regex helpers."""
+
+from __future__ import annotations
+
+import re
+import warnings
+
+
+def compile_regex(pattern: str, flags: int = 0) -> re.Pattern[str]:
+    """Compile a user regex without leaking Python's advisory future warnings."""
+
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", FutureWarning)
+        return re.compile(pattern, flags)

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

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import warnings
 
 import pytest
 
@@ -265,6 +266,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")
 
@@ -788,6 +824,38 @@ def test_auto_regex_empty_match_uses_python_for_counts(monkeypatch, tmp_path):
     assert result["matches"] == [{"path": "a.py", "count": 4, "first_line": 1}]
 
 
+def test_nested_set_regex_warning_is_suppressed_in_auto(monkeypatch, tmp_path):
+    write(tmp_path / "a.py", "[abc]\n")
+    monkeypatch.setattr(api, "find_rust_binary", lambda: "/fake/rust")
+
+    def fake_rust(pattern, **kwargs):
+        return {
+            "pattern": pattern,
+            "backend": "rust",
+            "root": kwargs["root"],
+            "regex": True,
+            "mode": kwargs["mode"],
+            "matches": [],
+            "returned": 0,
+            "total_files": 1,
+            "total_matches": 0,
+            "count": 0,
+            "truncated": False,
+            "next_cursor": None,
+            "offset": 0,
+            "limit": kwargs["limit"],
+        }
+
+    monkeypatch.setattr(api, "search_rust", fake_rust)
+
+    with warnings.catch_warnings(record=True) as caught:
+        warnings.simplefilter("always")
+        api.explore("[[abc]]", root=str(tmp_path), result_format="full")
+        api.explore("[[abc]]", root=str(tmp_path), backend="python")
+
+    assert not [item for item in caught if item.category is FutureWarning]
+
+
 def test_auto_regex_falls_back_to_python_when_rust_rejects_syntax(
     monkeypatch, tmp_path
 ):

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

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