rhylthyme-cli-runner 0.2.4a0__tar.gz → 0.2.5a0__tar.gz

{rhylthyme_cli_runner-0.2.4a0/src/rhylthyme_cli_runner.egg-info → rhylthyme_cli_runner-0.2.5a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rhylthyme-cli-runner
-Version: 0.2.4a0
+Version: 0.2.5a0
 Summary: CLI runner for Rhylthyme real-time program schedules
 Home-page: https://github.com/rhylthyme/rhylthyme-cli-runner
 Author: Rhylthyme Team
@@ -64,7 +64,7 @@ Command-line interface for validating and running Rhylthyme real-time program sc
 and for turning a plain-language request into one through the hosted Rhylthyme MCP server.
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 rhylthyme login
 rhylthyme generate "roast chicken, potatoes and green beans for 6" -e kitchen --by 19:00 --with "one oven"
 ```
@@ -76,7 +76,7 @@ the oven, when do the balloons go up, and do the pizzas and the cake ever want
 the oven at the same time?
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 
 # 1. a program: the party, the kitchen and the setup crew, 13 steps
 curl -sO https://raw.githubusercontent.com/rhylthyme/rhylthyme-cli-runner/main/examples/recipe/birthday-party.json
@@ -117,8 +117,8 @@ Start Sat 12:50, finish Sat 16:00 (local time)
 # 4. a live timeline for the fridge door (or a phone): timers, cues, and you end the piñata when it breaks
 rhylthyme publish birthday-party.json --open --image party-preview.png
 
-# 5. a picture for the group chat, on the wall clock (needs Node; nothing to install)
-npx -y github:rhylthyme/rhylthyme-timeline birthday-party.json -o birthday-party.png \
+# 5. a picture for the group chat, on the wall clock (needs Node.js)
+rhylthyme render birthday-party.json -o birthday-party.png \
   --style web --palette vivid --label-overflow outside --start-at "$(date +%F)T12:50:00"
 ```
 
@@ -141,7 +141,7 @@ is the **server an AI assistant talks to**.
 |---|---|---|
 | What it is | The MCP **server**: the tools an AI assistant calls | A command-line **program**: the `rhylthyme` command |
 | Who uses it | Claude, ChatGPT, Cursor or any MCP client, on a person's behalf | A person at a terminal, a script, or CI |
-| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme-cli-runner` |
+| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme` |
 | Language | JavaScript (Node 20+) | Python 3.12+ |
 | Input | A program the assistant builds in conversation | A program file on disk (JSON or YAML) |
 | Validate a program | `validate_program` | `rhylthyme validate` (works offline) |
@@ -189,7 +189,8 @@ pip install -e ".[dev]"
 ### From PyPI
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme            # this package, the importers and the renderer
+pip install rhylthyme-cli-runner   # this package alone
 ```
 
 ## Getting the Examples
@@ -553,7 +554,7 @@ writes `<programId>.json`. Needs `rhylthyme-importers` (included in
 rhylthyme import https://www.seriouseats.com/the-best-chili-recipe   # any of ~580 recipe sites
 rhylthyme import 52772 -i themealdb --publish                        # a TheMealDB id, straight to a live timeline
 rhylthyme import https://www.protocols.io/view/western-blot-...      # needs PROTOCOLS_IO_TOKEN
-rhylthyme import protocol.py -o protocol.json                        # an Opentrons file
+rhylthyme import https://raw.githubusercontent.com/Opentrons/Protocols/develop/protocols/007992/rna_isolation.ot2.apiv2.py   # an Opentrons protocol
 rhylthyme import "Neapolitan Pizza.cook" -i cooklang
 rhylthyme importers                                                  # what is installed
 rhylthyme search "pad thai" -i spoonacular                           # then import a hit's URL
@@ -563,6 +564,17 @@ rhylthyme search "pad thai" -i spoonacular                           # then impo
 `--stdout`, `--publish` (and `--open`), `--no-validate`. `-` reads pasted
 source from stdin (with `-i`).
 
+### `rhylthyme render`
+
+Draws a program as an SVG, PNG or PDF figure through the `rhylthyme-timeline`
+package (included in `pip install rhylthyme`; needs Node.js 18+). Every
+option of `rhylthyme-render` is accepted: `rhylthyme render --help`.
+
+```bash
+rhylthyme render dinner.json -o dinner.png --style web --palette vivid --color-by task
+rhylthyme render blot.json -o figure.pdf --style publication --legend right
+```
+
 ### `rhylthyme plan`
 
 An older stagger heuristic. It reads the pre-0.2 program format and leaves

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/README.md

@@ -4,7 +4,7 @@ Command-line interface for validating and running Rhylthyme real-time program sc
 and for turning a plain-language request into one through the hosted Rhylthyme MCP server.
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 rhylthyme login
 rhylthyme generate "roast chicken, potatoes and green beans for 6" -e kitchen --by 19:00 --with "one oven"
 ```
@@ -16,7 +16,7 @@ the oven, when do the balloons go up, and do the pizzas and the cake ever want
 the oven at the same time?
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 
 # 1. a program: the party, the kitchen and the setup crew, 13 steps
 curl -sO https://raw.githubusercontent.com/rhylthyme/rhylthyme-cli-runner/main/examples/recipe/birthday-party.json
@@ -57,8 +57,8 @@ Start Sat 12:50, finish Sat 16:00 (local time)
 # 4. a live timeline for the fridge door (or a phone): timers, cues, and you end the piñata when it breaks
 rhylthyme publish birthday-party.json --open --image party-preview.png
 
-# 5. a picture for the group chat, on the wall clock (needs Node; nothing to install)
-npx -y github:rhylthyme/rhylthyme-timeline birthday-party.json -o birthday-party.png \
+# 5. a picture for the group chat, on the wall clock (needs Node.js)
+rhylthyme render birthday-party.json -o birthday-party.png \
   --style web --palette vivid --label-overflow outside --start-at "$(date +%F)T12:50:00"
 ```
 
@@ -81,7 +81,7 @@ is the **server an AI assistant talks to**.
 |---|---|---|
 | What it is | The MCP **server**: the tools an AI assistant calls | A command-line **program**: the `rhylthyme` command |
 | Who uses it | Claude, ChatGPT, Cursor or any MCP client, on a person's behalf | A person at a terminal, a script, or CI |
-| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme-cli-runner` |
+| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme` |
 | Language | JavaScript (Node 20+) | Python 3.12+ |
 | Input | A program the assistant builds in conversation | A program file on disk (JSON or YAML) |
 | Validate a program | `validate_program` | `rhylthyme validate` (works offline) |
@@ -129,7 +129,8 @@ pip install -e ".[dev]"
 ### From PyPI
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme            # this package, the importers and the renderer
+pip install rhylthyme-cli-runner   # this package alone
 ```
 
 ## Getting the Examples
@@ -493,7 +494,7 @@ writes `<programId>.json`. Needs `rhylthyme-importers` (included in
 rhylthyme import https://www.seriouseats.com/the-best-chili-recipe   # any of ~580 recipe sites
 rhylthyme import 52772 -i themealdb --publish                        # a TheMealDB id, straight to a live timeline
 rhylthyme import https://www.protocols.io/view/western-blot-...      # needs PROTOCOLS_IO_TOKEN
-rhylthyme import protocol.py -o protocol.json                        # an Opentrons file
+rhylthyme import https://raw.githubusercontent.com/Opentrons/Protocols/develop/protocols/007992/rna_isolation.ot2.apiv2.py   # an Opentrons protocol
 rhylthyme import "Neapolitan Pizza.cook" -i cooklang
 rhylthyme importers                                                  # what is installed
 rhylthyme search "pad thai" -i spoonacular                           # then import a hit's URL
@@ -503,6 +504,17 @@ rhylthyme search "pad thai" -i spoonacular                           # then impo
 `--stdout`, `--publish` (and `--open`), `--no-validate`. `-` reads pasted
 source from stdin (with `-i`).
 
+### `rhylthyme render`
+
+Draws a program as an SVG, PNG or PDF figure through the `rhylthyme-timeline`
+package (included in `pip install rhylthyme`; needs Node.js 18+). Every
+option of `rhylthyme-render` is accepted: `rhylthyme render --help`.
+
+```bash
+rhylthyme render dinner.json -o dinner.png --style web --palette vivid --color-by task
+rhylthyme render blot.json -o figure.pdf --style publication --legend right
+```
+
 ### `rhylthyme plan`
 
 An older stagger heuristic. It reads the pre-0.2 program format and leaves

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/setup.py

@@ -19,7 +19,7 @@ def read_readme():
 
 setup(
     name="rhylthyme-cli-runner",
-    version="0.2.4a0",
+    version="0.2.5a0",
     description="CLI runner for Rhylthyme real-time program schedules",
     long_description=read_readme(),
     long_description_content_type="text/markdown",

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/src/rhylthyme_cli_runner/__init__.py

@@ -6,7 +6,7 @@ This package provides the command-line interface for running and validating
 Rhylthyme real-time program schedules.
 """
 
-__version__ = "0.2.4a0"
+__version__ = "0.2.5a0"
 __author__ = "Rhylthyme Team"
 __description__ = "CLI runner for Rhylthyme real-time program schedules"
 

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/src/rhylthyme_cli_runner/cli.py

@@ -554,6 +554,16 @@ def _register_import_commands():
 _register_import_commands()
 
 
+def _register_render_command():
+    """Attach `render` (rhylthyme_cli_runner.render_cli)."""
+    from .render_cli import register as register_render
+
+    register_render(cli)
+
+
+_register_render_command()
+
+
 def main():
     """Entry point for the CLI."""
     cli()

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/src/rhylthyme_cli_runner/import_cli.py

@@ -49,6 +49,18 @@ def _pick(registry, source: str, importer_name: Optional[str]):
 
 
 def _import_one(importer, source: str, text: Optional[str]):
+    # An importer that works on text (Opentrons) gets a URL's body fetched
+    # for it; the URL-native importers fetch for themselves.
+    url_native = bool(getattr(importer, "supported_domains", None))
+    if (
+        text is None
+        and source.startswith(("http://", "https://"))
+        and hasattr(importer, "import_from_source")
+        and not url_native
+    ):
+        from .remote.cli import _fetch_bytes
+
+        text = _fetch_bytes(source).decode("utf-8")
     if text is not None and hasattr(importer, "import_from_source"):
         return importer.import_from_source(text)
     if text is not None and hasattr(importer, "import_from_content"):
@@ -129,7 +141,7 @@ def import_command(
     .cook or .pptx file. `-` reads the source text from stdin (with -i).
       rhylthyme import https://www.seriouseats.com/the-best-chili-recipe
       rhylthyme import 52772 -i themealdb --publish
-      rhylthyme import protocol.py -o protocol.json
+      rhylthyme import https://raw.githubusercontent.com/Opentrons/Protocols/develop/protocols/007992/rna_isolation.ot2.apiv2.py
       rhylthyme importers          # what is installed
     """
     registry = _registry()

rhylthyme_cli_runner-0.2.5a0/src/rhylthyme_cli_runner/render_cli.py

@@ -0,0 +1,41 @@
+"""``rhylthyme render``: the timeline renderer from rhylthyme-timeline,
+reached from the one command people already have. Every option of the
+``rhylthyme-render`` command is accepted unchanged."""
+
+from __future__ import annotations
+
+import click
+
+INSTALL_HINT = (
+    "The renderer is a separate package: pip install rhylthyme-timeline "
+    "(or pip install rhylthyme, which includes it). It runs on Node.js 18 or newer."
+)
+
+
+@click.command(
+    "render",
+    context_settings={
+        "ignore_unknown_options": True,
+        "allow_extra_args": True,
+        "help_option_names": [],
+    },
+)
+@click.argument("args", nargs=-1, type=click.UNPROCESSED)
+@click.pass_context
+def render_command(ctx, args):
+    """Draw a program as an SVG, PNG or PDF figure (needs Node.js).
+
+    \b
+      rhylthyme render dinner.json -o dinner.png --style web --palette vivid
+      rhylthyme render blot.json -o figure.pdf --style publication --legend right
+      rhylthyme render --help          # every option
+    """
+    try:
+        from rhylthyme_timeline import main as render_main
+    except ImportError:
+        raise click.ClickException(INSTALL_HINT)
+    ctx.exit(render_main(list(args)))
+
+
+def register(cli_group: click.Group) -> None:
+    cli_group.add_command(render_command)

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0/src/rhylthyme_cli_runner.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rhylthyme-cli-runner
-Version: 0.2.4a0
+Version: 0.2.5a0
 Summary: CLI runner for Rhylthyme real-time program schedules
 Home-page: https://github.com/rhylthyme/rhylthyme-cli-runner
 Author: Rhylthyme Team
@@ -64,7 +64,7 @@ Command-line interface for validating and running Rhylthyme real-time program sc
 and for turning a plain-language request into one through the hosted Rhylthyme MCP server.
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 rhylthyme login
 rhylthyme generate "roast chicken, potatoes and green beans for 6" -e kitchen --by 19:00 --with "one oven"
 ```
@@ -76,7 +76,7 @@ the oven, when do the balloons go up, and do the pizzas and the cake ever want
 the oven at the same time?
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme
 
 # 1. a program: the party, the kitchen and the setup crew, 13 steps
 curl -sO https://raw.githubusercontent.com/rhylthyme/rhylthyme-cli-runner/main/examples/recipe/birthday-party.json
@@ -117,8 +117,8 @@ Start Sat 12:50, finish Sat 16:00 (local time)
 # 4. a live timeline for the fridge door (or a phone): timers, cues, and you end the piñata when it breaks
 rhylthyme publish birthday-party.json --open --image party-preview.png
 
-# 5. a picture for the group chat, on the wall clock (needs Node; nothing to install)
-npx -y github:rhylthyme/rhylthyme-timeline birthday-party.json -o birthday-party.png \
+# 5. a picture for the group chat, on the wall clock (needs Node.js)
+rhylthyme render birthday-party.json -o birthday-party.png \
   --style web --palette vivid --label-overflow outside --start-at "$(date +%F)T12:50:00"
 ```
 
@@ -141,7 +141,7 @@ is the **server an AI assistant talks to**.
 |---|---|---|
 | What it is | The MCP **server**: the tools an AI assistant calls | A command-line **program**: the `rhylthyme` command |
 | Who uses it | Claude, ChatGPT, Cursor or any MCP client, on a person's behalf | A person at a terminal, a script, or CI |
-| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme-cli-runner` |
+| Where it runs | Hosted at `mcp.rhylthyme.com`; nothing to install | On your machine: `pip install rhylthyme` |
 | Language | JavaScript (Node 20+) | Python 3.12+ |
 | Input | A program the assistant builds in conversation | A program file on disk (JSON or YAML) |
 | Validate a program | `validate_program` | `rhylthyme validate` (works offline) |
@@ -189,7 +189,8 @@ pip install -e ".[dev]"
 ### From PyPI
 
 ```bash
-pip install rhylthyme-cli-runner
+pip install rhylthyme            # this package, the importers and the renderer
+pip install rhylthyme-cli-runner   # this package alone
 ```
 
 ## Getting the Examples
@@ -553,7 +554,7 @@ writes `<programId>.json`. Needs `rhylthyme-importers` (included in
 rhylthyme import https://www.seriouseats.com/the-best-chili-recipe   # any of ~580 recipe sites
 rhylthyme import 52772 -i themealdb --publish                        # a TheMealDB id, straight to a live timeline
 rhylthyme import https://www.protocols.io/view/western-blot-...      # needs PROTOCOLS_IO_TOKEN
-rhylthyme import protocol.py -o protocol.json                        # an Opentrons file
+rhylthyme import https://raw.githubusercontent.com/Opentrons/Protocols/develop/protocols/007992/rna_isolation.ot2.apiv2.py   # an Opentrons protocol
 rhylthyme import "Neapolitan Pizza.cook" -i cooklang
 rhylthyme importers                                                  # what is installed
 rhylthyme search "pad thai" -i spoonacular                           # then import a hit's URL
@@ -563,6 +564,17 @@ rhylthyme search "pad thai" -i spoonacular                           # then impo
 `--stdout`, `--publish` (and `--open`), `--no-validate`. `-` reads pasted
 source from stdin (with `-i`).
 
+### `rhylthyme render`
+
+Draws a program as an SVG, PNG or PDF figure through the `rhylthyme-timeline`
+package (included in `pip install rhylthyme`; needs Node.js 18+). Every
+option of `rhylthyme-render` is accepted: `rhylthyme render --help`.
+
+```bash
+rhylthyme render dinner.json -o dinner.png --style web --palette vivid --color-by task
+rhylthyme render blot.json -o figure.pdf --style publication --legend right
+```
+
 ### `rhylthyme plan`
 
 An older stagger heuristic. It reads the pre-0.2 program format and leaves

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/src/rhylthyme_cli_runner.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ src/rhylthyme_cli_runner/import_cli.py
 src/rhylthyme_cli_runner/instance_checks.py
 src/rhylthyme_cli_runner/program_planner.py
 src/rhylthyme_cli_runner/program_runner.py
+src/rhylthyme_cli_runner/render_cli.py
 src/rhylthyme_cli_runner/validate_program.py
 src/rhylthyme_cli_runner.egg-info/PKG-INFO
 src/rhylthyme_cli_runner.egg-info/SOURCES.txt
@@ -74,6 +75,7 @@ tests/test_planner_time_strings.py
 tests/test_predict.py
 tests/test_program_runner.py
 tests/test_remote.py
+tests/test_render_cli.py
 tests/test_replay.py
 tests/test_run_recorder.py
 tests/test_skill.py

{rhylthyme_cli_runner-0.2.4a0 → rhylthyme_cli_runner-0.2.5a0}/tests/test_import_cli.py

@@ -226,3 +226,17 @@ def test_without_the_importers_package_the_message_says_how_to_get_it(monkeypatc
     monkeypatch.setitem(sys.modules, "rhylthyme_importers", None)
     r = CliRunner().invoke(cli, ["import", "https://fake.example/dinner"])
     assert r.exit_code != 0 and "pip install rhylthyme-importers" in r.output
+
+
+def test_a_text_importer_gets_a_urls_body(fake, monkeypatch):
+    from rhylthyme_cli_runner.remote import cli as remote
+
+    monkeypatch.setattr(
+        remote, "_fetch_bytes", lambda url, limit=0: b"def run(protocol): pass\n"
+    )
+    fake.supported_domains = []  # a file/text importer, like Opentrons
+    r = CliRunner().invoke(
+        cli, ["import", "https://fake.example/protocol.py", "-i", "fake", "--stdout"]
+    )
+    assert r.exit_code == 0, r.output
+    assert fake.calls[-1] == ("text", "def run(protocol): pass\n", None)

rhylthyme_cli_runner-0.2.5a0/tests/test_render_cli.py

@@ -0,0 +1,33 @@
+"""`rhylthyme render` hands its arguments to the rhylthyme-timeline package."""
+
+import sys
+import types
+
+from click.testing import CliRunner
+
+from rhylthyme_cli_runner.cli import cli
+
+
+def test_arguments_pass_through_unchanged(monkeypatch):
+    seen = {}
+    module = types.ModuleType("rhylthyme_timeline")
+    module.main = lambda argv: seen.setdefault("argv", argv) and 0
+    monkeypatch.setitem(sys.modules, "rhylthyme_timeline", module)
+    r = CliRunner().invoke(
+        cli, ["render", "p.json", "-o", "p.png", "--style", "web", "--help"]
+    )
+    assert r.exit_code == 0, r.output
+    assert seen["argv"] == ["p.json", "-o", "p.png", "--style", "web", "--help"]
+
+
+def test_exit_code_is_the_renderers(monkeypatch):
+    module = types.ModuleType("rhylthyme_timeline")
+    module.main = lambda argv: 2
+    monkeypatch.setitem(sys.modules, "rhylthyme_timeline", module)
+    assert CliRunner().invoke(cli, ["render", "p.json"]).exit_code == 2
+
+
+def test_without_the_package_the_message_says_how_to_get_it(monkeypatch):
+    monkeypatch.setitem(sys.modules, "rhylthyme_timeline", None)
+    r = CliRunner().invoke(cli, ["render", "p.json"])
+    assert r.exit_code != 0 and "pip install rhylthyme-timeline" in r.output