skim-python 0.0.1__tar.gz → 0.0.2__tar.gz

{skim_python-0.0.1 → skim_python-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: skim-python
-Version: 0.0.1
+Version: 0.0.2
 Summary: Language-aware, AST-resilient outline and verbatim code extractor for Python tailored for AI agents
 Project-URL: Homepage, https://github.com/benedictjohannes/programming-helper-utils
 Project-URL: Repository, https://github.com/benedictjohannes/programming-helper-utils
@@ -335,6 +335,7 @@ skim-py glance tests/fixtures/syntax_error.py -s
 ```
 ```text
 === tests/fixtures/syntax_error.py (12 lines) [! 1 syntax error] ===
+# parsed with 1 line masked (L7)
   Syntax Notice: L7: invalid syntax
 
 Outline:
@@ -343,12 +344,13 @@ Outline:
   L11-L12      def valid_after()
 ```
 
-Surrounding valid functions remain fully extractable via `block`:
+Surrounding valid functions remain fully extractable via `block` (masking warnings are surfaced via stderr):
 
 ```bash
 skim-py block tests/fixtures/syntax_error.py valid_after
 ```
 ```text
+tests/fixtures/syntax_error.py: # parsed with 1 line masked (L7)
 === tests/fixtures/syntax_error.py (L11-L12) ===
    11 | def valid_after():
    12 |     return 2
@@ -360,6 +362,7 @@ And if an extracted block contains a syntax error within its line span, the warn
 skim-py block tests/fixtures/syntax_error.py broken_function
 ```
 ```text
+tests/fixtures/syntax_error.py: # parsed with 1 line masked (L7)
 === tests/fixtures/syntax_error.py (L5-L8) [! 1 syntax error] ===
   Syntax Notice: L7: invalid syntax
     5 | def broken_function():
@@ -368,6 +371,34 @@ skim-py block tests/fixtures/syntax_error.py broken_function
     8 |     return x
 ```
 
+For cascade-prone mid-edit states (such as an unclosed `def foo(x,` header or unclosed bracket structure), `skim-py` masks the entire broken block in one step, marks the masked line range in the notice, and salvages the broken declaration in the outline so it remains targetable by `block`:
+
+```bash
+skim-py glance tests/fixtures/syntax_error_cascade.py -s
+```
+```text
+=== tests/fixtures/syntax_error_cascade.py (11 lines) [! 1 syntax error] ===
+# parsed with 3 lines masked (L5, L6, L7)
+  Syntax Notice: L5: '(' was never closed (L5-L7 masked)
+
+Outline:
+  L1-L2        def valid_before()
+  L5-L7        def broken_header [syntax error]
+  L10-L11      def valid_after()
+```
+
+```bash
+skim-py block tests/fixtures/syntax_error_cascade.py broken_header
+```
+```text
+tests/fixtures/syntax_error_cascade.py: # parsed with 3 lines masked (L5, L6, L7)
+=== tests/fixtures/syntax_error_cascade.py (L5-L7) [! 1 syntax error] ===
+  Syntax Notice: L5: '(' was never closed (L5-L7 masked)
+    5 | def broken_header(x,
+    6 |     y = 1
+    7 |     return y
+```
+
 ---
 
 ### 2. `block` Subcommand

{skim_python-0.0.1 → skim_python-0.0.2}/README.md

@@ -310,6 +310,7 @@ skim-py glance tests/fixtures/syntax_error.py -s
 ```
 ```text
 === tests/fixtures/syntax_error.py (12 lines) [! 1 syntax error] ===
+# parsed with 1 line masked (L7)
   Syntax Notice: L7: invalid syntax
 
 Outline:
@@ -318,12 +319,13 @@ Outline:
   L11-L12      def valid_after()
 ```
 
-Surrounding valid functions remain fully extractable via `block`:
+Surrounding valid functions remain fully extractable via `block` (masking warnings are surfaced via stderr):
 
 ```bash
 skim-py block tests/fixtures/syntax_error.py valid_after
 ```
 ```text
+tests/fixtures/syntax_error.py: # parsed with 1 line masked (L7)
 === tests/fixtures/syntax_error.py (L11-L12) ===
    11 | def valid_after():
    12 |     return 2
@@ -335,6 +337,7 @@ And if an extracted block contains a syntax error within its line span, the warn
 skim-py block tests/fixtures/syntax_error.py broken_function
 ```
 ```text
+tests/fixtures/syntax_error.py: # parsed with 1 line masked (L7)
 === tests/fixtures/syntax_error.py (L5-L8) [! 1 syntax error] ===
   Syntax Notice: L7: invalid syntax
     5 | def broken_function():
@@ -343,6 +346,34 @@ skim-py block tests/fixtures/syntax_error.py broken_function
     8 |     return x
 ```
 
+For cascade-prone mid-edit states (such as an unclosed `def foo(x,` header or unclosed bracket structure), `skim-py` masks the entire broken block in one step, marks the masked line range in the notice, and salvages the broken declaration in the outline so it remains targetable by `block`:
+
+```bash
+skim-py glance tests/fixtures/syntax_error_cascade.py -s
+```
+```text
+=== tests/fixtures/syntax_error_cascade.py (11 lines) [! 1 syntax error] ===
+# parsed with 3 lines masked (L5, L6, L7)
+  Syntax Notice: L5: '(' was never closed (L5-L7 masked)
+
+Outline:
+  L1-L2        def valid_before()
+  L5-L7        def broken_header [syntax error]
+  L10-L11      def valid_after()
+```
+
+```bash
+skim-py block tests/fixtures/syntax_error_cascade.py broken_header
+```
+```text
+tests/fixtures/syntax_error_cascade.py: # parsed with 3 lines masked (L5, L6, L7)
+=== tests/fixtures/syntax_error_cascade.py (L5-L7) [! 1 syntax error] ===
+  Syntax Notice: L5: '(' was never closed (L5-L7 masked)
+    5 | def broken_header(x,
+    6 |     y = 1
+    7 |     return y
+```
+
 ---
 
 ### 2. `block` Subcommand

{skim_python-0.0.1 → skim_python-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "skim-python"
-version = "0.0.1"
+version = "0.0.2"
 description = "Language-aware, AST-resilient outline and verbatim code extractor for Python tailored for AI agents"
 readme = "README.md"
 license = "MIT"

{skim_python-0.0.1 → skim_python-0.0.2}/src/skim_py/block.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from typing import List, Optional
 
 from .types import OutlineItem, ParsedFile
-from .parser import parse_source_file
+from .parser import parse_source_file, split_source_lines
 
 
 def collect_all_items(items: List[OutlineItem]) -> List[OutlineItem]:
@@ -38,6 +38,8 @@ def run_block(
         return 1
 
     parsed = parse_source_file(file_path, content, include_tests=include_tests)
+    if parsed.masking_warning:
+        sys.stderr.write(f"{file_path}: {parsed.masking_warning}\n")
     all_items = collect_all_items(parsed.items)
 
     matches: List[OutlineItem] = []
@@ -123,7 +125,7 @@ def run_block(
         return 3
 
     chosen = matches[0]
-    src_lines = content.splitlines()
+    src_lines = split_source_lines(content, keepends=False)
     block_lines = src_lines[chosen.start_line - 1 : chosen.end_line]
 
     # Check for syntax errors within block range

{skim_python-0.0.1 → skim_python-0.0.2}/src/skim_py/glance.py

@@ -8,7 +8,7 @@ from pathlib import Path
 from typing import List, Optional
 
 from .types import OutlineItem, ParsedFile
-from .parser import parse_source_file, is_test_file
+from .parser import parse_source_file, is_test_file, split_source_lines
 
 
 IGNORED_DIRS = {
@@ -121,7 +121,7 @@ def run_glance(
             sys.stderr.write(f"Error reading {file_path}: {err}\n")
             continue
 
-        src_lines = content.splitlines()
+        src_lines = split_source_lines(content, keepends=False)
         parsed = parse_source_file(file_path, content, include_tests=include_tests)
 
         if filters:
@@ -155,6 +155,8 @@ def run_glance(
             rel_path = file_path
 
         print(f"=== {rel_path} ({parsed.total_lines} lines){test_info}{error_tag} ===")
+        if parsed.masking_warning:
+            print(parsed.masking_warning)
 
         for err in parsed.syntax_errors:
             print(f"  Syntax Notice: L{err.line}: {err.message}")