deploy: 7e636c8

Author: github-actions[bot]

.nojekyll

@@ -0,0 +1,169 @@
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+The quick brown fox jumps over the lazy dog. Jackdaws love my big sphinx
+of quartz. Pack my box with five dozen liquor jugs. How vexingly quick
+daft zebras jump! The five boxing wizards jump quickly. Sphinx of black
+quartz, judge my vow. Two driven jocks help fax my big quiz. Bright
+vixens jump; dozy fowl quack.
+
+``` python
+msg = await read_msg()
+id_ = msg.id
+cts = msg.content
+```
+
+<div class="prose" markdown="1">
+
+------------------------------------------------------------------------
+
+<a
+href="https://github.com/AnswerDotAI/dialoghelper/blob/main/dialoghelper/exhash.py#L12"
+target="_blank" style="float:right; font-size:smaller">source</a>
+
+### msg_lnhashview
+
+``` python
+
+async def msg_lnhashview(
+    id:str, # id of message to view
+    dname:str='', # Dialog containing message; defaults to current dialog
+):
+
+```
+
+*Show lnhash-addressed lines of a message*
+
+</div>
+
+<div class="prose" markdown="1">
+
+------------------------------------------------------------------------
+
+<a
+href="https://github.com/AnswerDotAI/dialoghelper/blob/main/dialoghelper/exhash.py#L22"
+target="_blank" style="float:right; font-size:smaller">source</a>
+
+### msg_exhash
+
+``` python
+
+async def msg_exhash(
+    id:str, # id of message to edit
+    cmds:list, # List of exhash command strings to apply
+    dname:str='', # Dialog containing message; defaults to current dialog
+):
+
+```
+
+*Verified line-addressed editor. Apply commands to msg `id` contents,
+return lnhash diff.* **NB**: *all* exhash commands *must* start with an
+address. The *only* allowed addresses are a single lnhash, or a pair
+separated by `,`. (I.e no `%`, `.`, etc.) **NB**: hashes are checked
+before each command is run. So be sure to have commands go last-\>first
+order to avoid changing earlier lines.
+
+Commands are like `ex`, but use lnhash addresses instead of bare line
+numbers: `lineno|hash|cmd` where hash is a 4-char hex content hash. Use
+`msg_lnhashview(text)` to get addresses before first use.
+
+Addressing: Single: `12|a3f2|cmd` Range: `12|a3f2|,15|b1c3|cmd` Special:
+`0|0000|` targets before line 1 (only with a or i)
+
+Commands: s/pat/rep/\[flags\] Substitute (regex). Flags: g=all,
+i=case-insensitive d Delete line(s) a Append text after line i Insert
+text before line c Change/replace line(s) j Join with next line; with
+range, joins all m dest Move line(s) after dest address t dest Copy
+line(s) after dest address \>\[n\] Indent n levels (default 1, 4 spaces
+each) \<\[n\] Dedent n levels (default 1) sort Sort lines alphabetically
+p Print (include in output without changing) g/pat/cmd Global: run cmd
+on matching lines g!/pat/cmd Inverted global (also v/pat/cmd)
+
+`cmds` is a required list of command strings. For `a`/`i`/`c`, include
+the text block in the same command string after a newline. Unlike `ex`,
+do NOT add a trailing `.` line — the string boundary ends the block. A
+trailing `.` will be inserted literally (with a warning).
+
+</div>
+
+<div class="prose" markdown="1">
+
+------------------------------------------------------------------------
+
+<a
+href="https://github.com/AnswerDotAI/dialoghelper/blob/main/dialoghelper/exhash.py#L68"
+target="_blank" style="float:right; font-size:smaller">source</a>
+
+### file_lnhashview
+
+``` python
+
+def file_lnhashview(
+    path:str
+):
+
+```
+
+*Show lnhash-addressed lines of a file*
+
+</div>
+
+<div class="prose" markdown="1">
+
+------------------------------------------------------------------------
+
+<a
+href="https://github.com/AnswerDotAI/dialoghelper/blob/main/dialoghelper/exhash.py#L73"
+target="_blank" style="float:right; font-size:smaller">source</a>
+
+### file_exhash
+
+``` python
+
+def file_exhash(
+    path:str, cmds:list
+):
+
+```
+
+*Verified line-addressed editor for files. Apply commands to file at
+`path`, return lnhash diff.* See `doc(msg_exhash)` for details
+
+</div>
+
+``` python
+tp = Path('tmp.txt')
+tp.write_text(cts)
+```
+
+    313
+
+``` python
+file_lnhashview("tmp.txt")
+```
+
+    '1|da2a|  The quick brown fox jumps over the lazy dog.\n2|32e4|  Jackdaws love my big sphinx of quartz.\n3|04e4|  Pack my box with five dozen liquor jugs.\n4|025f|  How vexingly quick daft zebras jump!\n5|c720|  The five boxing wizards jump quickly.\n6|0666|  Sphinx of black quartz, judge my vow.\n7|d61c|  Two driven jocks help fax my big quiz.\n8|bc1b|  Bright vixens jump; dozy fowl quack.'
+
+``` python
+file_exhash("tmp.txt", cmds=['1|da2a|,3|04e4|>'])
+```
+
+    '--- tmp.txt\n+++ tmp.txt\n-1|da2a|  The quick brown fox jumps over the lazy dog.\n-2|32e4|  Jackdaws love my big sphinx of quartz.\n-3|04e4|  Pack my box with five dozen liquor jugs.\n+1|dfab|      The quick brown fox jumps over the lazy dog.\n+2|e110|      Jackdaws love my big sphinx of quartz.\n+3|a4ce|      Pack my box with five dozen liquor jugs.\n 4|025f|  How vexingly quick daft zebras jump!\n'
+
+``` python
+print(tp.read_text())
+```
+
+        The quick brown fox jumps over the lazy dog.
+        Jackdaws love my big sphinx of quartz.
+        Pack my box with five dozen liquor jugs.
+    How vexingly quick daft zebras jump!
+    The five boxing wizards jump quickly.
+    Sphinx of black quartz, judge my vow.
+    Two driven jocks help fax my big quiz.
+    Bright vixens jump; dozy fowl quack.
+
+``` python
+tp.unlink()
+```