exhash 0.3.2__tar.gz → 0.3.4__tar.gz

{exhash-0.3.2 → exhash-0.3.4}/Cargo.lock

@@ -13,9 +13,9 @@ dependencies = [
 
 [[package]]
 name = "autocfg"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
 
 [[package]]
 name = "cfg-if"
@@ -25,7 +25,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "exhash"
-version = "0.3.2"
+version = "0.3.4"
 dependencies = [
  "pyo3",
  "regex",
@@ -48,15 +48,15 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.185"
+version = "0.2.186"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "52ff2c0fe9bc6cb6b14a0592c2ff4fa9ceb83eea9db979b0487cd054946a2b8f"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
 
 [[package]]
 name = "memchr"
-version = "2.8.0"
+version = "2.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+checksum = "6b947ae49db0d222b1dbc6b113ce7248a3fc3a6ca21b696717bfc000ba4484d8"
 
 [[package]]
 name = "memoffset"
@@ -162,9 +162,9 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.12.3"
+version = "1.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e10754a14b9137dd7b1e3e5b0493cc9171fdd105e0ab477f51b72e7f3ac0e276"
+checksum = "f1292b7759ae1cb9ec195452d1390a074f0cd8541ab7a5a8c31cd6db45d4a6ba"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -185,9 +185,9 @@ dependencies = [
 
 [[package]]
 name = "regex-syntax"
-version = "0.8.10"
+version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
 [[package]]
 name = "rustversion"

{exhash-0.3.2 → exhash-0.3.4}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "exhash"
-version = "0.3.2"
+version = "0.3.4"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 description = "Verified line-addressed file editor using lnhash addresses"

{exhash-0.3.2 → exhash-0.3.4}/DEV.md

@@ -18,7 +18,8 @@ src/
   bin/exhash.rs   CLI editor (atomic in-place edit, dry-run, stdin mode)
   bin/lnhashview.rs  CLI viewer
 python/exhash/
-  __init__.py     Python wrapper functions with typed/docstring API (+ exhash_result helper)
+  __init__.py     Python wrapper functions plus file-aware exhash_file orchestration
+  skill.py        pyskills entry point exposing exhash APIs for LLM tools
 python/exhash.data/scripts/
   exhash          native binary (built, not checked in)
   lnhashview      native binary (built, not checked in)
@@ -50,6 +51,9 @@ cargo test && pytest -q
 `edit_text` verifies lnhashes command-by-command against the current in-memory buffer, immediately before each command executes (not all upfront). If an earlier command shifts or rewrites a later target line, that later command will fail with a stale-hash error unless you recompute addresses.
 The `$` (last line) and `%` (whole file) address forms are resolved against the current buffer and do not require hashes.
 `edit_text_with_sw` exposes configurable shift width for `<` and `>`; `edit_text` defaults to `sw=4`.
+In CLI and Python file-helper flows, a missing file is treated as empty input only when the parsed command set is valid against an empty buffer (for example `0|0000|a`); otherwise the original file-not-found error is preserved.
+Python `exhash_file` adds the file-qualified orchestration layer. It parses optional `path:` prefixes, applies each command to the current in-memory buffer for that file, rejects cross-file source ranges, and writes changed files only after every command succeeds.
+`lnhashview` range requests clamp `end` past EOF to the last available line, while invalid `start` values still error.
 
 ## Release
 
@@ -86,9 +90,11 @@ Maturin's `data` option in `pyproject.toml` points to `python/exhash.data/`. Fil
 
 The Rust core has three parsing functions:
 
-- `parse_commands_from_strs(&[&str])` — for the Python API; each string is one command, text blocks are the remaining lines (no `.` terminator; a trailing `.` line is literal text and the Python binding warns about this common mistake)
+- `parse_commands_from_strs(&[&str])` — for the Python API; each string is one command, and multiline `a/i/c` text blocks must be in that same string using newlines, e.g. `["12|abcd|c\nnew line 1\nnew line 2"]`. Do not use `.` terminators or split the inserted text into separate command entries; a trailing `.` line is literal text and the Python binding warns about this common mistake.
 - `parse_commands_from_script(&str)` — for script strings; commands separated by newlines, text blocks terminated by `.`
 - `parse_commands_from_args(&[String], &mut BufRead)` — for the CLI; each arg is a command, text blocks read from stdin terminated by `.`
 
+File-qualified addresses are parsed by the Python `exhash_file` wrapper; the Rust parser and CLI remain single-buffer.
+
 Substitute parsing keeps Rust regex escapes intact (`\d`, `\w`, etc.) while still allowing escaped command delimiters (`\/`) in pattern and replacement.
 Transliteration uses `y/src/dst/` and validates equal character counts at parse time.

{exhash-0.3.2 → exhash-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exhash
-Version: 0.3.2
+Version: 0.3.4
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Summary: Verified line-addressed file editor using lnhash addresses
@@ -52,6 +52,8 @@ lnhashview path/to/file.txt
 lnhashview path/to/file.txt 10 20
 ```
 
+If `end` is past EOF, `lnhashview` returns through the last available line instead of failing.
+
 ### Edit
 
 ```bash
@@ -80,6 +82,12 @@ exhash file.txt '%j'
 
 # Move a line to EOF using $ as the destination
 exhash file.txt '12|abcd|m$'
+
+# Create a missing file by treating it as empty input
+exhash new.txt '0|0000|a' <<'EOF'
+first line
+.
+EOF
 ```
 
 Substitute uses Rust regex syntax:
@@ -99,6 +107,8 @@ For `a/i/c` commands, provide the text block on stdin:
 printf "new line 1\nnew line 2\n.\n" | exhash file.txt "2|beef|a"
 ```
 
+If the file does not exist and the command set is valid on empty input, exhash treats it as an empty file and writes the result. For example, `0|0000|a` can create a new file.
+
 ### Stdin filter mode
 
 ```bash
@@ -117,13 +127,13 @@ from exhash import exhash, exhash_file, lnhash, lnhashview, lnhashview_file, lin
 
 ```py
 text = "foo\nbar\n"
-view = lnhashview(text)       # ["1|a1b2|  foo", "2|c3d4|  bar"]
-view = lnhashview_file("f.py") # same but reads from file
+view = lnhashview(text)                        # ["1|a1b2|  foo", "2|c3d4|  bar"]
+view = lnhashview_file("f.py", start=1, end=260) # end past EOF is clamped
 ```
 
 ### Editing
 
-`exhash(text, cmds, sw=4)` takes the text and a required iterable of command strings (use `[]` for no-op). `sw` controls how far `<` and `>` shift. For `a`/`i`/`c` commands, lines after the command are the text block. Do not include an ex-style trailing `.` line here: unlike CLI/script mode, `exhash(text, cmds)` does not use one, and a final `.` line is inserted literally.
+`exhash(text, cmds, sw=4)` takes the text and a required iterable of command strings (use `[]` for no-op). `sw` controls how far `<` and `>` shift. For multiline `a`/`i`/`c` commands, include the inserted text in the same command string using newline characters, e.g. `["12|abcd|c\nnew line 1\nnew line 2"]`. Do not use `.` terminators, and do not split the text block into separate `cmds` entries. If you include a final `.` line, it is inserted literally and exhash emits a warning.
 
 ```py
 addr = lnhash(1, "foo")  # "1|a1b2|"
@@ -138,12 +148,15 @@ res = exhash(text, [f"{a1}s/foo/FOO/", f"{a2}s/bar/BAR/"])
 # Hashes are checked just-in-time per command.
 # If earlier commands change/shift a later target line, recompute lnhash first.
 
-# Append multiline text (no dot terminator)
+# Append multiline text in the same command string (no dot terminator)
 res = exhash(text, [f"{addr}a\nnew line 1\nnew line 2"])
 
 # Wrong for the Python API: the trailing "." would be inserted literally
 # res = exhash(text, [f"{addr}a\nnew line 1\nnew line 2\n."])
 
+# Also wrong: do not split the inserted text into separate cmds entries
+# res = exhash(text, [f"{addr}a", "new line 1", "new line 2"])
+
 # Change shift width for < and >
 res = exhash(text, [f"{addr}>1"], sw=2)
 
@@ -157,18 +170,46 @@ res = exhash("foo\nbar\n", [f"{a1},{a2}s/foo\nbar/replaced/"])
 
 ### File helpers
 
-`exhash_file` and `lnhashview_file` read directly from a file path:
+`lnhashview_file` reads directly from one file path. `exhash_file(path, cmds, sw=4, inplace=False)` uses `path` as the default file context for unqualified addresses, and also accepts file-qualified source and `m`/`t` destination addresses:
 
 ```py
 view = lnhashview_file("file.py")
 
-# Returns EditResult, file unchanged
+# Returns FileSetEditResult, files unchanged
 res = exhash_file("file.py", [f"{addr}s/foo/bar/"])
+print(res.changed)          # ["file.py"]
+print(res["file.py"].lines)
+print(res.format_diff())    # includes --- file.py / +++ file.py headers
 
-# With inplace=True, writes back on success and returns diff string
+# With inplace=True, writes changed files after every command succeeds
+# and returns the combined diff string.
 diff = exhash_file("file.py", [f"{addr}s/foo/bar/"], inplace=True)
+
+# Missing files are treated as empty only when the command is valid on empty input.
+diff = exhash_file("new.py", ["0|0000|a\nprint('hi')"], inplace=True)
+
+# File-qualified addresses can edit or transfer lines across files.
+cmds = [
+    "src/a.py:24|8f12|,38|c0de|m src/b.py:$",
+    r"src/a.py:5|91aa|s/from \.b import old/from \.b import helper/",
+]
+diff = exhash_file("src/a.py", cmds, inplace=True)
 ```
 
+A file prefix is separated from the address with `:`. Escape literal colons in filenames as `\:` and literal backslashes as `\\`.
+
+`exhash_file(..., inplace=False)` returns a `FileSetEditResult`:
+
+- `res.files` — dict of path to `FileEditResult`
+- `res.changed` — changed paths, in first-touch order
+- `res.default_path` — the default path passed to `exhash_file`
+- `res[path]` — shorthand for `res.files[path]`
+- `res.format_diff(context=1)` — combined diff with `--- path` / `+++ path` headers
+
+### Pyskill
+
+The package registers `exhash.skill` as a pyskill exposing the primary Python APIs with LLM-oriented workflow docs. Use `doc(exhash.skill)` after importing it through a pyskills host.
+
 ### EditResult
 
 `exhash()` returns an `EditResult` with attributes (also accessible via `res["key"]`):
@@ -184,6 +225,8 @@ diff = exhash_file("file.py", [f"{addr}s/foo/bar/"], inplace=True)
 ```py
 res = exhash(text, [f"{addr}s/foo/baz/"])
 print(res.format_diff())
+# --- original
+# +++ modified
 # -1|a1b2|  foo
 # +1|c3d4|  baz
 #  2|e5f6|  bar

{exhash-0.3.2 → exhash-0.3.4}/README.md

@@ -37,6 +37,8 @@ lnhashview path/to/file.txt
 lnhashview path/to/file.txt 10 20
 ```
 
+If `end` is past EOF, `lnhashview` returns through the last available line instead of failing.
+
 ### Edit
 
 ```bash
@@ -65,6 +67,12 @@ exhash file.txt '%j'
 
 # Move a line to EOF using $ as the destination
 exhash file.txt '12|abcd|m$'
+
+# Create a missing file by treating it as empty input
+exhash new.txt '0|0000|a' <<'EOF'
+first line
+.
+EOF
 ```
 
 Substitute uses Rust regex syntax:
@@ -84,6 +92,8 @@ For `a/i/c` commands, provide the text block on stdin:
 printf "new line 1\nnew line 2\n.\n" | exhash file.txt "2|beef|a"
 ```
 
+If the file does not exist and the command set is valid on empty input, exhash treats it as an empty file and writes the result. For example, `0|0000|a` can create a new file.
+
 ### Stdin filter mode
 
 ```bash
@@ -102,13 +112,13 @@ from exhash import exhash, exhash_file, lnhash, lnhashview, lnhashview_file, lin
 
 ```py
 text = "foo\nbar\n"
-view = lnhashview(text)       # ["1|a1b2|  foo", "2|c3d4|  bar"]
-view = lnhashview_file("f.py") # same but reads from file
+view = lnhashview(text)                        # ["1|a1b2|  foo", "2|c3d4|  bar"]
+view = lnhashview_file("f.py", start=1, end=260) # end past EOF is clamped
 ```
 
 ### Editing
 
-`exhash(text, cmds, sw=4)` takes the text and a required iterable of command strings (use `[]` for no-op). `sw` controls how far `<` and `>` shift. For `a`/`i`/`c` commands, lines after the command are the text block. Do not include an ex-style trailing `.` line here: unlike CLI/script mode, `exhash(text, cmds)` does not use one, and a final `.` line is inserted literally.
+`exhash(text, cmds, sw=4)` takes the text and a required iterable of command strings (use `[]` for no-op). `sw` controls how far `<` and `>` shift. For multiline `a`/`i`/`c` commands, include the inserted text in the same command string using newline characters, e.g. `["12|abcd|c\nnew line 1\nnew line 2"]`. Do not use `.` terminators, and do not split the text block into separate `cmds` entries. If you include a final `.` line, it is inserted literally and exhash emits a warning.
 
 ```py
 addr = lnhash(1, "foo")  # "1|a1b2|"
@@ -123,12 +133,15 @@ res = exhash(text, [f"{a1}s/foo/FOO/", f"{a2}s/bar/BAR/"])
 # Hashes are checked just-in-time per command.
 # If earlier commands change/shift a later target line, recompute lnhash first.
 
-# Append multiline text (no dot terminator)
+# Append multiline text in the same command string (no dot terminator)
 res = exhash(text, [f"{addr}a\nnew line 1\nnew line 2"])
 
 # Wrong for the Python API: the trailing "." would be inserted literally
 # res = exhash(text, [f"{addr}a\nnew line 1\nnew line 2\n."])
 
+# Also wrong: do not split the inserted text into separate cmds entries
+# res = exhash(text, [f"{addr}a", "new line 1", "new line 2"])
+
 # Change shift width for < and >
 res = exhash(text, [f"{addr}>1"], sw=2)
 
@@ -142,18 +155,46 @@ res = exhash("foo\nbar\n", [f"{a1},{a2}s/foo\nbar/replaced/"])
 
 ### File helpers
 
-`exhash_file` and `lnhashview_file` read directly from a file path:
+`lnhashview_file` reads directly from one file path. `exhash_file(path, cmds, sw=4, inplace=False)` uses `path` as the default file context for unqualified addresses, and also accepts file-qualified source and `m`/`t` destination addresses:
 
 ```py
 view = lnhashview_file("file.py")
 
-# Returns EditResult, file unchanged
+# Returns FileSetEditResult, files unchanged
 res = exhash_file("file.py", [f"{addr}s/foo/bar/"])
+print(res.changed)          # ["file.py"]
+print(res["file.py"].lines)
+print(res.format_diff())    # includes --- file.py / +++ file.py headers
 
-# With inplace=True, writes back on success and returns diff string
+# With inplace=True, writes changed files after every command succeeds
+# and returns the combined diff string.
 diff = exhash_file("file.py", [f"{addr}s/foo/bar/"], inplace=True)
+
+# Missing files are treated as empty only when the command is valid on empty input.
+diff = exhash_file("new.py", ["0|0000|a\nprint('hi')"], inplace=True)
+
+# File-qualified addresses can edit or transfer lines across files.
+cmds = [
+    "src/a.py:24|8f12|,38|c0de|m src/b.py:$",
+    r"src/a.py:5|91aa|s/from \.b import old/from \.b import helper/",
+]
+diff = exhash_file("src/a.py", cmds, inplace=True)
 ```
 
+A file prefix is separated from the address with `:`. Escape literal colons in filenames as `\:` and literal backslashes as `\\`.
+
+`exhash_file(..., inplace=False)` returns a `FileSetEditResult`:
+
+- `res.files` — dict of path to `FileEditResult`
+- `res.changed` — changed paths, in first-touch order
+- `res.default_path` — the default path passed to `exhash_file`
+- `res[path]` — shorthand for `res.files[path]`
+- `res.format_diff(context=1)` — combined diff with `--- path` / `+++ path` headers
+
+### Pyskill
+
+The package registers `exhash.skill` as a pyskill exposing the primary Python APIs with LLM-oriented workflow docs. Use `doc(exhash.skill)` after importing it through a pyskills host.
+
 ### EditResult
 
 `exhash()` returns an `EditResult` with attributes (also accessible via `res["key"]`):
@@ -169,6 +210,8 @@ diff = exhash_file("file.py", [f"{addr}s/foo/bar/"], inplace=True)
 ```py
 res = exhash(text, [f"{addr}s/foo/baz/"])
 print(res.format_diff())
+# --- original
+# +++ modified
 # -1|a1b2|  foo
 # +1|c3d4|  baz
 #  2|e5f6|  bar

{exhash-0.3.2 → exhash-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "exhash"
-version = "0.3.2"
+version = "0.3.4"
 description = "Verified line-addressed file editor using lnhash addresses"
 license = {text = "MIT OR Apache-2.0"}
 requires-python = ">=3.10"
@@ -19,6 +19,8 @@ classifiers = [
 Homepage = "https://github.com/AnswerDotAI/exhash"
 Repository = "https://github.com/AnswerDotAI/exhash"
 Issues = "https://github.com/AnswerDotAI/exhash/issues"
+[project.entry-points.pyskills]
+exhash = "exhash.skill"
 
 [tool.maturin]
 features = ["extension-module"]