termrender 3.0.0__tar.gz → 3.0.1__tar.gz

{termrender-3.0.0 → termrender-3.0.1}/CHANGELOG.md

@@ -1,6 +1,19 @@
 # CHANGELOG
 
 
+## v3.0.1 (2026-06-10)
+
+### Bug Fixes
+
+- Spawn tmux render pane via absolute termrender path, not bare PATH name
+  ([`993c646`](https://github.com/crouton-labs/termrender/commit/993c6463afc64b94b6dbbdbe6e69f7652feac500))
+
+The tmux pane command baked a bare `termrender` token into split-window/ respawn-pane, so the
+  spawned pane resolved it via $PATH. A venv-only install (invoked by absolute path, not on PATH)
+  produced a pane that died instantly and silently. Build the pane command from termrender's own
+  absolute invocation (argv[0] when executable, else `python -m termrender`).
+
+
 ## v3.0.0 (2026-05-18)
 
 ### Chores

{termrender-3.0.0 → termrender-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termrender
-Version: 3.0.0
+Version: 3.0.1
 Summary: Rich terminal rendering of directive-flavored markdown
 Project-URL: Homepage, https://github.com/CaptainCrouton89/termrender
 Project-URL: Repository, https://github.com/CaptainCrouton89/termrender

{termrender-3.0.0 → termrender-3.0.1}/src/termrender/__main__.py

@@ -4,6 +4,7 @@ import argparse
 import json
 import os
 import sys
+from pathlib import Path
 from typing import Any, NoReturn
 
 from termrender import render, TerminalError, DirectiveError
@@ -59,6 +60,23 @@ Branches
   render  render markdown to ANSI and print to stdout   | use when producing output for display
   check   validate directive syntax without rendering    | use when validating before rendering
   watch   live-render a file, updating on every save     | use when monitoring a file interactively
+
+Document format
+  Directive-flavored markdown. Triple-colon blocks carry attributes in {} and
+  nest arbitrarily; every block closes with a bare `:::`. Plain markdown
+  (headings, **bold**, *italic*, `code`, bullet/numbered lists) works
+  everywhere, including inside directives. Write structure, not box-drawing —
+  layout, padding, and guide lines are computed.
+
+  :::panel{title="" color=""}            bordered box; color e.g. green|cyan|red
+  :::columns / :::col{width="N%"}        side-by-side; col widths sum to 100%
+  :::tree{color=""}                      indentation → Unicode guide lines;
+                                         [x]=done [!]=warning status markers
+  :::callout{type=""}                     admonition; type success|warning|error|info
+  :::divider{label=""}                    labeled horizontal rule
+  :::code{lang=""}                        syntax-highlighted block (``` fences also work)
+  :::quote{author=""}                     attributed block quote
+  :::mermaid                             flowchart → ASCII (NOT ```mermaid fences)
 """
 
 _DOC_RENDER_HELP = """\
@@ -325,6 +343,27 @@ def _cmd_doc_watch(args: argparse.Namespace) -> None:
     sys.exit(EXIT_OK)
 
 
+def _termrender_invocation() -> str:
+    """Shell-quoted command prefix that invokes *this* termrender.
+
+    A tmux pane spawned via split-window/respawn-pane resolves a bare
+    ``termrender`` token through ``$PATH``. When termrender lives only inside a
+    managed venv (e.g. invoked by absolute path), that bare name is not on PATH
+    and the spawned pane dies instantly and silently. Prefer the absolute path
+    of the running entrypoint (argv[0]) so the pane invokes the same binary;
+    fall back to ``python -m termrender`` when argv[0] is not a usable
+    executable.
+    """
+    import shlex
+
+    argv0 = sys.argv[0] if sys.argv else ""
+    if argv0:
+        entry = Path(argv0).resolve()
+        if entry.is_file() and os.access(entry, os.X_OK):
+            return shlex.quote(str(entry))
+    return f"{shlex.quote(sys.executable)} -m termrender"
+
+
 def _build_pane_cmd(
     *,
     watch: bool,
@@ -337,17 +376,18 @@ def _build_pane_cmd(
     import shlex
 
     cjk_flag = " --cjk" if cjk else ""
+    termrender = _termrender_invocation()
 
     if watch:
         # doc watch reads path as positional; use -- to guard against flag-looking paths
-        cmd = f"termrender doc watch --color on{cjk_flag} -- {shlex.quote(path)}"
+        cmd = f"{termrender} doc watch --color on{cjk_flag} -- {shlex.quote(path)}"
     else:
         effective_path = tmpfile if tmpfile else path
         width_flag = f" --width {pane_width}" if pane_width is not None else ""
         # doc render reads stdin — cat the file into it
         cmd = (
             f"cat {shlex.quote(effective_path)}"
-            f" | termrender doc render --color on{width_flag}{cjk_flag}"
+            f" | {termrender} doc render --color on{width_flag}{cjk_flag}"
             f" | less -R; rm -f {shlex.quote(effective_path)}"
         )
     return cmd

{termrender-3.0.0 → termrender-3.0.1}/tests/test_cli_contract.py

@@ -332,3 +332,39 @@ def test_doc_render_rejects_unknown_flag():
     assert r.returncode == 1
     out = json.loads(r.stdout)
     assert out["error"] == "bad_invocation"
+
+
+# ---------------------------------------------------------------------------
+# Pane command construction — must use an absolute termrender invocation, not a
+# bare PATH-resolved name (a venv-only install is not on a spawned pane's PATH).
+# ---------------------------------------------------------------------------
+
+def test_build_pane_cmd_uses_absolute_invocation(monkeypatch, tmp_path):
+    import termrender.__main__ as m
+
+    fake = tmp_path / "termrender"
+    fake.write_text("#!/bin/sh\n")
+    fake.chmod(0o755)
+    monkeypatch.setattr(sys, "argv", [str(fake)])
+
+    watch_cmd = m._build_pane_cmd(
+        watch=True, path="/docs/a.md", cjk=False, pane_width=None, tmpfile=None,
+    )
+    assert str(fake.resolve()) in watch_cmd
+    assert watch_cmd.startswith(str(fake.resolve()) + " ")  # absolute, not bare
+    assert " doc watch " in watch_cmd
+
+    render_cmd = m._build_pane_cmd(
+        watch=False, path="/docs/a.md", cjk=False, pane_width=80, tmpfile="/tmp/x.md",
+    )
+    assert str(fake.resolve()) in render_cmd
+    assert " doc render " in render_cmd
+
+
+def test_termrender_invocation_falls_back_to_python_m(monkeypatch):
+    import termrender.__main__ as m
+
+    monkeypatch.setattr(sys, "argv", [""])
+    inv = m._termrender_invocation()
+    assert "-m termrender" in inv
+    assert sys.executable in inv