nucli 0.2.0__py3-none-any.whl

nu/_cli/__init__.py

@@ -0,0 +1,6 @@
+"""The `nu` command — entrypoint package."""
+
+from nu._cli.main import cli, main
+
+
+__all__ = ["cli", "main"]

nu/_cli/__main__.py

@@ -0,0 +1,7 @@
+"""Enables `python -m nu._cli`."""
+
+from nu._cli.main import main
+
+
+if __name__ == "__main__":
+    main()

nu/_cli/_meta.py

@@ -0,0 +1,26 @@
+"""Shared helpers for CLI commands."""
+
+from __future__ import annotations
+
+import importlib.resources as resources
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+
+def nu_version() -> str:
+    try:
+        return version("nucore")
+    except PackageNotFoundError:
+        return "0.0.0+dev"
+
+
+def demos_root() -> Path:
+    """Locate packaged demo scripts (ships as nu._cli.demos)."""
+    return Path(str(resources.files("nu._cli").joinpath("demos")))
+
+
+def demos() -> dict[str, Path]:
+    root = demos_root()
+    if not root.is_dir():
+        return {}
+    return {p.stem: p for p in sorted(root.glob("*.py")) if not p.stem.startswith("_")}

nu/_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Individual click commands wired into the `nu` group."""

nu/_cli/commands/demo.py

@@ -0,0 +1,72 @@
+"""`nu demo` — list bundled demos, or run one by name."""
+
+from __future__ import annotations
+
+import ast
+import runpy
+import sys
+from typing import TYPE_CHECKING
+
+import rich_click as click
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+
+from nu._cli._meta import demos
+from nu._config.branding import BLUE, PURPLE
+
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+_console = Console()
+
+
+def _description(path: Path) -> str:
+    """Return the first line of the module docstring, or empty string."""
+    try:
+        tree = ast.parse(path.read_text(), filename=str(path))
+    except (OSError, SyntaxError):
+        return ""
+    doc = ast.get_docstring(tree) or ""
+    return doc.strip().splitlines()[0] if doc else ""
+
+
+def _list(found: dict[str, Path]) -> None:
+    if not found:
+        _console.print("[yellow]no demos found[/yellow]")
+        sys.exit(1)
+    table = Table(show_header=False, box=None, padding=(0, 2))
+    table.add_column(style=f"bold {BLUE}")
+    table.add_column(style="dim")
+    for name, path in found.items():
+        table.add_row(name, _description(path))
+    _console.print(Text("demos", style=f"bold {PURPLE}"))
+    _console.print(table)
+    _console.print(Text.assemble(("run with: ", "dim"), ("nu demo <name>", f"bold {BLUE}")))
+
+
+@click.command(help="List bundled demos, or run one by name (nu demo <name>).")
+@click.argument("name", required=False)
+def demo(name: str | None) -> None:
+    """No arg -> list; name -> run that demo."""
+    found = demos()
+    if name is None:
+        _list(found)
+        return
+    if name not in found:
+        _console.print(f"[red]unknown demo:[/red] [bold]{name}[/bold]", highlight=False)
+        _console.print(
+            Text.assemble(
+                ("available: ", "dim"),
+                (", ".join(found) or "(none)", BLUE),
+            ),
+        )
+        sys.exit(2)
+    try:
+        runpy.run_path(str(found[name]), run_name="__main__")
+    except KeyboardInterrupt:
+        # Ctrl+C during a demo: nudle already printed its stopped banner;
+        # don't let click surface its default "Aborted!" line on top of it.
+        pass

nu/_cli/commands/doctor.py

@@ -0,0 +1,57 @@
+"""`nu doctor` — report python + which fabric extras resolve."""
+
+from __future__ import annotations
+
+import importlib.util
+import sys
+
+import rich_click as click
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+
+from nu._cli._meta import nu_version
+from nu._config.branding import BLUE, PURPLE
+
+
+# Fabric extras (as declared in packages/nustd/pyproject.toml) and the import
+# that proves they resolve. The backends live in the `nustd` distribution;
+# this kernel-side command only probes for them, it never imports the fabric.
+_FABRICS: dict[str, str] = {
+    "kv": "virtuals",
+    "mem": "janus",
+    "ui": "nudle",
+    "cluster": "ray",
+    "proxy": "invisibles",
+    "http": "httpx",
+    "llm": "httpx",
+    "cc": "claude_agent_sdk",
+}
+
+
+@click.command(help="Report installed fabrics and versions.")
+def doctor() -> None:
+    """Report installed fabrics and versions."""
+    console = Console()
+    header = Text.assemble(
+        ("nu ", f"bold {PURPLE}"),
+        (nu_version(), f"bold {BLUE}"),
+        ("  ·  python ", "dim"),
+        (sys.version.split()[0], BLUE),
+    )
+    console.print(header)
+    console.print()
+    table = Table(show_header=True, header_style=f"bold {PURPLE}", box=None, padding=(0, 2))
+    table.add_column("fabric", style="bold")
+    table.add_column("status")
+    table.add_column("install", style="dim")
+    for name, probe in _FABRICS.items():
+        if importlib.util.find_spec(probe) is not None:
+            table.add_row(name, Text("● ok", style="green"), "")
+        else:
+            table.add_row(
+                name,
+                Text("○ missing", style="yellow"),
+                f"pip install 'nustd[{name}]'",
+            )
+    console.print(table)

nu/_cli/commands/telemetry.py

@@ -0,0 +1,53 @@
+"""`nu telemetry` — inspect and toggle the anonymous usage ping."""
+
+from __future__ import annotations
+
+import rich_click as click
+from rich.console import Console
+from rich.text import Text
+
+from nu._config import config as _config
+from nu._config.branding import BLUE
+
+
+_console = Console()
+
+
+def _state_line(on: bool) -> Text:
+    label = Text("telemetry: ", style="dim")
+    label.append("on" if on else "off", style="bold green" if on else "bold yellow")
+    return label
+
+
+@click.group(invoke_without_command=True, help="Anonymous usage telemetry.")
+@click.pass_context
+def telemetry(ctx: click.Context) -> None:
+    """`nu telemetry` — default action shows current status."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(status)
+
+
+@telemetry.command("status", help="Show current telemetry state.")
+def status() -> None:
+    """Print on/off, distinct_id, and config path."""
+    on = _config.telemetry_enabled()
+    dev = _config.is_dev_install()
+    _console.print(_state_line(on))
+    if dev:
+        _console.print("[dim]dev install detected — no events sent regardless[/dim]")
+    _console.print(Text.assemble(("distinct_id: ", "dim"), (_config.distinct_id(), BLUE)))
+    _console.print(Text.assemble(("config:      ", "dim"), (str(_config.CONFIG_PATH), BLUE)))
+
+
+@telemetry.command("enable", help="Turn telemetry on.")
+def enable() -> None:
+    """Set the config flag to on."""
+    _config.set_telemetry(True)
+    _console.print(_state_line(True))
+
+
+@telemetry.command("disable", help="Turn telemetry off.")
+def disable() -> None:
+    """Set the config flag to off."""
+    _config.set_telemetry(False)
+    _console.print(_state_line(False))

nu/_cli/demos/__init__.py

@@ -0,0 +1 @@
+"""Bundled runnable demos, discoverable via `nu demo`."""

nu/_cli/demos/counter.py

@@ -0,0 +1,89 @@
+"""Counter: rocksdb-backed counter ticking every second, live in the browser."""
+
+from pathlib import Path
+
+import nu
+
+
+_DB = Path.home() / ".nu" / "demos" / "counter"
+_DB.parent.mkdir(parents=True, exist_ok=True)
+
+
+class Counter(nu.Shape):
+    """Persistent counter state."""
+
+    value: nu.kv.IntRef
+
+
+class Links(nu.ui.Row):
+    docs = nu.ui.LinkRef.slot(
+        label="Read the docs", href="https://nustack.dev/docs", target="_blank"
+    )
+    github = nu.ui.LinkRef.slot(
+        label="Star on GitHub", href="https://github.com/nustackdev/nu", target="_blank"
+    )
+    examples = nu.ui.LinkRef.slot(
+        label="Browse more demos",
+        href="https://github.com/nustackdev/nu/tree/main/examples",
+        target="_blank",
+    )
+
+
+class Dashboard(nu.ui.Page):
+    """Live counter page with description and source."""
+
+    heading = nu.ui.HeadingRef.slot(label="Persistent counter, live")
+    count = nu.ui.StatRef.slot(label="Count")
+    about_heading = nu.ui.HeadingRef.slot(label="How it works")
+    about = nu.ui.MarkdownRef.slot(
+        value=(
+            "- Stores counter value in rocksdb.\n"
+            "- App increments the counter once a second.\n"
+            "- `ReactForever` pushes every change to the browser.\n"
+            "- Same Ref system used for rocksdb and UI.\n"
+            "- Same Interactions used to orchestrate storage and UI update.\n"
+        ),
+    )
+    links_heading = nu.ui.HeadingRef.slot(label="Try Nu yourself")
+    links_intro = nu.ui.TextRef.slot(
+        value="Persistent state, live browser, no glue. See how far the primitive goes.",
+    )
+    links = Links.slot(gap=4, align="center", wrap=True)
+    source_heading = nu.ui.HeadingRef.slot(label="Source")
+    source_intro = nu.ui.TextRef.slot(
+        value="The whole app, one file. Storage, UI, and the wires between them.",
+    )
+    source = nu.ui.CodeBlockRef.slot(
+        code=Path(__file__).read_text(),
+        language="python",
+    )
+
+
+class App(nu.ui.Index):
+    """UI index with one page."""
+
+    pages = nu.ui.Pages({"/": Dashboard})
+
+
+app = nu.With(
+    nu.kv.rocksdb_navigator(str(_DB)),
+    nu.ui.server(
+        nu.kv.auto_flow_atomic(
+            nu.ReactForever(
+                Counter.value.on_change(),
+                Dashboard.count.set_value(nu.str(Counter.value)),
+            ),
+        ),
+    ),
+    body=nu.kv.auto_flow_atomic(
+        nu.IfDo(Counter.value.missing(), Counter.value.set(0))
+        >> nu.ForeverDo(
+            Counter.value.inc() >> nu.Delay(1.0),
+        )
+    ),
+)
+
+if __name__ == "__main__":
+    import asyncio
+
+    asyncio.run(nu.arun(app))

nu/_cli/demos/movies.py

@@ -0,0 +1,476 @@
+"""Movies: personal tracker. Form, filterable table, detail pages, all persisted."""
+
+from pathlib import Path
+
+import nu
+
+
+_DB = Path.home() / ".nu" / "demos" / "movies"
+_DB.parent.mkdir(parents=True, exist_ok=True)
+
+
+_GENRES = [
+    {"value": "action", "label": "Action"},
+    {"value": "drama", "label": "Drama"},
+    {"value": "scifi", "label": "Sci-fi"},
+    {"value": "doc", "label": "Documentary"},
+    {"value": "anim", "label": "Animation"},
+]
+
+_GENRES_WITH_ANY = [{"value": "", "label": "Any genre"}, *_GENRES]
+
+
+# ---- UI ---------------------------------------------------------------------
+
+
+class TitleField(nu.ui.Field):
+    input = nu.ui.InputRef.slot(placeholder="e.g. Arrival")
+
+
+class TextAreaField(nu.ui.Field):
+    input = nu.ui.TextAreaRef.slot(placeholder="Quick thoughts...", rows=2)
+
+
+class YearField(nu.ui.Field):
+    input = nu.ui.NumberInputRef.slot(
+        min=1900.0,
+        max=2100.0,
+        step=1.0,
+        default=2020.0,
+    )
+
+
+class RatingField(nu.ui.Field):
+    input = nu.ui.NumberInputRef.slot(
+        min=1.0,
+        max=10.0,
+        step=0.5,
+        default=7.0,
+    )
+
+
+class GenreField(nu.ui.Field):
+    input = nu.ui.SelectRef.slot(options=_GENRES, selected="drama")
+
+
+class SwitchField(nu.ui.Field):
+    input = nu.ui.SwitchRef.slot(default=True)
+
+
+class DetailsFieldset(nu.ui.Fieldset):
+    title = TitleField.slot(label="Title", help="Movie title", required=True)
+    year = YearField.slot(label="Year")
+    genre = GenreField.slot(label="Genre")
+
+
+class ScoreFieldset(nu.ui.Fieldset):
+    rating = RatingField.slot(label="Rating", help="How much you liked it")
+    watched = SwitchField.slot(label="Watched?", help="Off means still on the pile")
+    notes = TextAreaField.slot(label="Notes")
+
+
+class AddMovieForm(nu.ui.Form):
+    details = DetailsFieldset.slot(legend="Movie", gap="md")
+    score = ScoreFieldset.slot(legend="Your take", gap="md")
+    submit = nu.ui.ButtonRef.slot(label="Log it", variant="primary")
+    feedback = nu.ui.AlertRef.slot(variant="ok", dismissible=True)
+
+
+class MinRatingField(nu.ui.Field):
+    input = nu.ui.NumberInputRef.slot(min=1.0, max=10.0, step=0.5, default=1.0)
+
+
+class FilterGenreField(nu.ui.Field):
+    input = nu.ui.SelectRef.slot(options=_GENRES_WITH_ANY, selected="")
+
+
+class WatchedOnlyField(nu.ui.Field):
+    input = nu.ui.SwitchRef.slot(default=False)
+
+
+class FilterRow(nu.ui.Row):
+    min_rating = MinRatingField.slot(label="Min rating")
+    genre = FilterGenreField.slot(label="Genre")
+    watched_only = WatchedOnlyField.slot(label="Already watched")
+    apply = nu.ui.ButtonRef.slot(label="Apply", variant="secondary")
+    clear = nu.ui.ButtonRef.slot(label="Clear", variant="ghost")
+
+
+class FilterCard(nu.ui.Card):
+    body = FilterRow.slot(gap=3, align="center", wrap=True)
+
+
+class StatsRow(nu.ui.Row):
+    total = nu.ui.StatRef.slot(label="Total")
+    watched = nu.ui.StatRef.slot(label="Watched")
+    unseen = nu.ui.StatRef.slot(label="Unseen")
+    latest = nu.ui.TextRef.slot()
+    health = nu.ui.BadgeRef.slot(label="Fresh", variant="ok")
+
+
+class StatsCard(nu.ui.Card):
+    body = StatsRow.slot(gap=6, align="center", wrap=True)
+
+
+class TableBody(nu.ui.Column):
+    table = nu.ui.TableRef.slot(
+        columns=["title", "year", "genre", "rating", "watched", "notes"],
+        striped=True,
+        dense=True,
+        clickable_rows=True,
+        max_rows=200,
+    )
+    empty = nu.ui.AlertRef.slot(
+        variant="info",
+        body="No movies match",
+        dismissible=False,
+    )
+
+
+class TableCard(nu.ui.Card):
+    body = TableBody.slot(gap=3)
+
+
+class Links(nu.ui.Row):
+    docs = nu.ui.LinkRef.slot(
+        label="Read the docs", href="https://nustack.dev/docs", target="_blank"
+    )
+    github = nu.ui.LinkRef.slot(
+        label="Star on GitHub", href="https://github.com/nustackdev/nu", target="_blank"
+    )
+    examples = nu.ui.LinkRef.slot(
+        label="Browse more demos",
+        href="https://github.com/nustackdev/nu/tree/main/examples",
+        target="_blank",
+    )
+
+
+# ---- Pages ------------------------------------------------------------------
+
+
+class TopBar(nu.ui.Row):
+    about = nu.ui.ButtonRef.slot(label="About this demo", variant="ghost")
+
+
+class Movies(nu.ui.Page):
+    heading = nu.ui.HeadingRef.slot(label="Your movies")
+    intro = nu.ui.TextRef.slot(
+        value="Log what you watch. Filter the shelf, click a row for details.",
+    )
+    topbar = TopBar.slot(gap=3, align="center")
+
+    stats = StatsCard.slot(title="Your shelf")
+    form = AddMovieForm.slot(title="Log a movie", gap=4, padding=4)
+    filters = FilterCard.slot(title="Filter")
+    shelf = TableCard.slot(title="Movies")
+
+
+class AboutActions(nu.ui.Row):
+    back = nu.ui.ButtonRef.slot(label="Back to app", variant="ghost")
+
+
+class About(nu.ui.Page):
+    heading = nu.ui.HeadingRef.slot(label="How it works")
+    about = nu.ui.MarkdownRef.slot(
+        value=(
+            "- Real app: form, filterable table, stats row, per-item detail page.\n"
+            "- Every row lives in rocksdb. Restart, everything is still there.\n"
+            "- Same Ref system used for storage, form inputs, table, and navigation.\n"
+            "- Same Interactions handle add, delete, filter, and page routing.\n"
+        ),
+    )
+    links_heading = nu.ui.HeadingRef.slot(label="Try Nu yourself")
+    links_intro = nu.ui.TextRef.slot(
+        value="Full apps, forms, routing, no glue. See how far the primitive goes.",
+    )
+    links = Links.slot(gap=4, align="center", wrap=True)
+    source_heading = nu.ui.HeadingRef.slot(label="Source")
+    source_intro = nu.ui.TextRef.slot(
+        value="The whole app, one file. Storage, UI, and the wires between them.",
+    )
+    source = nu.ui.CodeBlockRef.slot(
+        code=Path(__file__).read_text(),
+        language="python",
+    )
+    actions = AboutActions.slot(gap=3, align="center")
+
+
+class DetailRow(nu.ui.Row):
+    year = nu.ui.StatRef.slot(label="Year")
+    genre = nu.ui.StatRef.slot(label="Genre")
+    rating = nu.ui.StatRef.slot(label="Rating")
+    watched = nu.ui.BadgeRef.slot(label="Watched", variant="ok")
+
+
+class MetaCard(nu.ui.Card):
+    meta = DetailRow.slot(gap=6, align="center", wrap=True)
+
+
+class NotesCard(nu.ui.Card):
+    body = nu.ui.MarkdownRef.slot()
+
+
+class DetailActions(nu.ui.Row):
+    back = nu.ui.ButtonRef.slot(label="Back", variant="ghost")
+    remove = nu.ui.ButtonRef.slot(label="Delete", variant="danger")
+
+
+class MovieDetail(nu.ui.Page):
+    heading = nu.ui.HeadingRef.slot()
+    meta = MetaCard.slot(title="Details")
+    notes = NotesCard.slot(title="Notes")
+    actions = DetailActions.slot(gap=3, align="center")
+
+
+class App(nu.ui.Index):
+    title: nu.ui.TitleRef
+    nav: nu.ui.NavRef
+    pages = nu.ui.Pages({"/": Movies, "/detail": MovieDetail, "/about": About})
+
+
+# ---- State ------------------------------------------------------------------
+
+
+class Movie(nu.Shape):
+    title = nu.kv.StrRef.slot()
+    year = nu.kv.IntRef.slot()
+    genre = nu.kv.StrRef.slot()
+    rating = nu.kv.FloatRef.slot()
+    watched = nu.kv.BoolRef.slot()
+    notes = nu.kv.StrRef.slot()
+
+
+class State(nu.Shape):
+    movies = nu.kv.ShapesListRef.slot(Movie)
+    total = nu.kv.IntRef.slot()
+    watched = nu.kv.IntRef.slot()
+    latest_title = nu.kv.StrRef.slot()
+    selected = nu.kv.IntRef.slot()  # index of the movie open in MovieDetail
+
+
+# ---- Seed ------------------------------------------------------------------
+
+_SEED_MOVIES: list[dict] = [
+    {
+        "title": "Arrival",
+        "year": 2016,
+        "genre": "scifi",
+        "rating": 8.5,
+        "watched": True,
+        "notes": "linguists save the world",
+    },
+    {
+        "title": "Dune: Part Two",
+        "year": 2024,
+        "genre": "scifi",
+        "rating": 9.0,
+        "watched": True,
+        "notes": "worm ride > sequel",
+    },
+    {
+        "title": "The Menu",
+        "year": 2022,
+        "genre": "drama",
+        "rating": 7.0,
+        "watched": True,
+        "notes": "eat the rich, literally",
+    },
+    {
+        "title": "Perfect Days",
+        "year": 2023,
+        "genre": "drama",
+        "rating": 8.0,
+        "watched": False,
+        "notes": "tokyo, tapes, toilets",
+    },
+]
+
+
+# ---- Wire -------------------------------------------------------------------
+
+
+_ROW_TRANSFORM = nu.List.of(
+    nu.DictAttrRef("r")["title"],
+    nu.DictAttrRef("r")["year"],
+    nu.DictAttrRef("r")["genre"],
+    nu.DictAttrRef("r")["rating"],
+    nu.If(nu.DictAttrRef("r")["watched"], "yes", "no"),
+    nu.DictAttrRef("r")["notes"],
+)
+
+
+def _rows_form() -> nu.Nu:
+    """Map each stored movie dict into a positional row TableRef expects."""
+    return nu.Dict.of(
+        rows=nu.Collect(
+            nu.Map(nu.Iter(State.movies), transform=_ROW_TRANSFORM, key="r"),
+        ),
+    )
+
+
+def _rows_filtered() -> nu.Nu:
+    """Same shape as _rows_form, but honors the current FilterRow inputs."""
+    min_r = nu.Float(FilterRow.min_rating.input)
+    genre = nu.Str(FilterRow.genre.input)
+    watched_only = nu.Bool(FilterRow.watched_only.input)
+    predicate = nu.And(
+        nu.Ge(nu.DictAttrRef("r")["rating"], min_r),
+        nu.Or(nu.Eq(genre, ""), nu.Eq(nu.DictAttrRef("r")["genre"], genre)),
+        nu.Or(nu.Not(watched_only), nu.DictAttrRef("r")["watched"]),
+    )
+    return nu.Dict.of(
+        rows=nu.Collect(
+            nu.Map(
+                nu.Filter(nu.Iter(State.movies), predicate=predicate, key="r"),
+                transform=_ROW_TRANSFORM,
+                key="r",
+            ),
+        ),
+    )
+
+
+# Seed once, on a store that has never been written. A restart then keeps what
+# the user logged instead of replacing the shelf with the samples again.
+# `selected` stays unconditional: it is a cursor into the detail page, not data.
+init = nu.kv.Transaction(
+    nu.IfDo(
+        State.total.missing(),
+        State.total.set(len(_SEED_MOVIES))
+        | State.watched.set(sum(1 for m in _SEED_MOVIES if m["watched"]))
+        | State.latest_title.set(_SEED_MOVIES[-1]["title"])
+        | State.movies.set(_SEED_MOVIES),
+    )
+    | State.selected.set(0),
+)
+
+
+hydrate = nu.kv.Snapshot(
+    Movies.stats.body.total.set_value(nu.str(State.total))
+    | Movies.stats.body.watched.set_value(nu.str(State.watched))
+    | Movies.stats.body.unseen.set_value(nu.str(State.total - State.watched))
+    | Movies.stats.body.latest.set(State.latest_title)
+    | Movies.shelf.body.table.set(_rows_form())
+)
+
+
+on_add = nu.ReactForever(
+    AddMovieForm.submit.clicked(),
+    nu.kv.Transaction(
+        State.movies.append(
+            nu.Dict.of(
+                title=nu.Str(AddMovieForm.details.title.input),
+                year=nu.Int(AddMovieForm.details.year.input),
+                genre=nu.Str(AddMovieForm.details.genre.input),
+                rating=nu.Float(AddMovieForm.score.rating.input),
+                watched=nu.Bool(AddMovieForm.score.watched.input),
+                notes=nu.Str(AddMovieForm.score.notes.input),
+            ),
+        )
+        | State.total.set(State.total + 1)
+        | State.watched.set(
+            State.watched + nu.If(nu.Bool(AddMovieForm.score.watched.input), 1, 0),
+        )
+        | State.latest_title.set(nu.Str(AddMovieForm.details.title.input)),
+    )
+    >> nu.kv.Snapshot(
+        Movies.shelf.body.table.set(_rows_form())
+        | Movies.stats.body.total.set_value(nu.str(State.total))
+        | Movies.stats.body.watched.set_value(nu.str(State.watched))
+        | Movies.stats.body.unseen.set_value(nu.str(State.total - State.watched))
+        | Movies.stats.body.latest.set(State.latest_title)
+        | Movies.form.feedback.set(
+            title="Logged",
+            body="Added " + nu.Str(AddMovieForm.details.title.input),
+        )
+    ),
+)
+
+
+on_row_click = nu.ReactForever(
+    Movies.shelf.body.table.row_clicked(),
+    nu.IfDo(
+        nu.Contains(nu.DictAttrRef("row_click"), "row_index"),
+        nu.kv.Transaction(State.selected.set(nu.DictAttrRef("row_click")["row_index"]))
+        >> nu.kv.Snapshot(
+            MovieDetail.heading.set(State.movies[State.selected].title)
+            | MovieDetail.meta.meta.year.set_value(nu.str(State.movies[State.selected].year))
+            | MovieDetail.meta.meta.genre.set_value(State.movies[State.selected].genre)
+            | MovieDetail.meta.meta.rating.set_value(nu.str(State.movies[State.selected].rating))
+            | MovieDetail.meta.meta.watched.set(
+                label=nu.If(State.movies[State.selected].watched, "Watched", "Unseen"),
+            )
+            | MovieDetail.notes.body.set(State.movies[State.selected].notes)
+        )
+        >> App.nav.set("/detail"),
+    ),
+    changed_key="row_click",
+)
+
+
+on_delete = nu.ReactForever(
+    MovieDetail.actions.remove.clicked(),
+    nu.kv.Transaction(
+        State.movies.del_at(State.selected) >> State.total.set(nu.Len(State.movies)),
+    )
+    >> nu.kv.Snapshot(
+        Movies.shelf.body.table.set(_rows_form())
+        | Movies.stats.body.total.set_value(nu.str(State.total))
+        | Movies.stats.body.unseen.set_value(nu.str(State.total - State.watched))
+    )
+    >> App.nav.set("/"),
+)
+
+
+on_back = nu.ReactForever(MovieDetail.actions.back.clicked(), App.nav.set("/"))
+
+
+on_about_open = nu.ReactForever(Movies.topbar.about.clicked(), App.nav.set("/about"))
+
+
+on_about_back = nu.ReactForever(About.actions.back.clicked(), App.nav.set("/"))
+
+
+on_filter_apply = nu.ReactForever(
+    FilterRow.apply.clicked(),
+    nu.kv.Snapshot(Movies.shelf.body.table.set(_rows_filtered())),
+)
+
+
+on_filter_clear = nu.ReactForever(
+    FilterRow.clear.clicked(),
+    nu.kv.Snapshot(
+        FilterRow.min_rating.input.set(1.0)
+        | FilterRow.genre.input.set("")
+        | FilterRow.watched_only.input.set(False)
+        | Movies.shelf.body.table.set(_rows_form())
+    ),
+)
+
+
+ui = (
+    App.title.set("Movies")
+    >> hydrate
+    >> (
+        on_add
+        | on_row_click
+        | on_delete
+        | on_back
+        | on_filter_apply
+        | on_filter_clear
+        | on_about_open
+        | on_about_back
+    )
+)
+
+
+app = nu.With(
+    nu.kv.rocksdb_navigator(str(_DB)),
+    nu.ui.server(nu.kv.auto_flow_atomic(ui)),
+    body=nu.kv.auto_flow_atomic(init >> nu.ForeverDo(nu.Delay(3600))),
+)
+
+
+if __name__ == "__main__":
+    import asyncio
+
+    asyncio.run(nu.arun(app))

nu/_cli/demos/sampled.py

@@ -0,0 +1,93 @@
+"""Sampled: kh57-backed series grows forever; the chart repaints a live reservoir sample."""
+
+from pathlib import Path
+
+import nu
+
+
+_DB = Path.home() / ".nu" / "demos" / "sampled"
+_DB.parent.mkdir(parents=True, exist_ok=True)
+
+
+class State(nu.Shape):
+    """Persistent series and write cursor."""
+
+    nums = nu.kv.Kh57Ref.slot(int)
+    cursor = nu.kv.IntRef.slot()
+
+
+class Links(nu.ui.Row):
+    docs = nu.ui.LinkRef.slot(
+        label="Read the docs", href="https://nustack.dev/docs", target="_blank"
+    )
+    github = nu.ui.LinkRef.slot(
+        label="Star on GitHub", href="https://github.com/nustackdev/nu", target="_blank"
+    )
+    examples = nu.ui.LinkRef.slot(
+        label="Browse more demos",
+        href="https://github.com/nustackdev/nu/tree/main/examples",
+        target="_blank",
+    )
+
+
+class Dashboard(nu.ui.Page):
+    """Live chart page with description and source."""
+
+    heading = nu.ui.HeadingRef.slot(label="Unbounded series, instant chart")
+    chart = nu.ui.LineChart.slot()
+    about_heading = nu.ui.HeadingRef.slot(label="How it works")
+    about = nu.ui.MarkdownRef.slot(
+        value=(
+            "- Writes 50 numbers a second into a **kh57-backed** series. Grows without limit.\n"
+            "- Chart repaints from a 200-point reservoir sample. Same cost at 1k rows or 1B.\n"
+            "- `ReactForever` triggers the resample on every write.\n"
+            "- Same Ref system used for storage, sampling, and chart.\n"
+            "- Same Interactions used to orchestrate the feed and the redraw.\n"
+        ),
+    )
+    links_heading = nu.ui.HeadingRef.slot(label="Try Nu yourself")
+    links_intro = nu.ui.TextRef.slot(
+        value="Billion-row backends, live UIs, no glue. See how far the primitive goes.",
+    )
+    links = Links.slot(gap=4, align="center", wrap=True)
+    source_heading = nu.ui.HeadingRef.slot(label="Source")
+    source_intro = nu.ui.TextRef.slot(
+        value="The whole app, one file. Storage, UI, and the wires between them.",
+    )
+    source = nu.ui.CodeBlockRef.slot(
+        code=Path(__file__).read_text(),
+        language="python",
+    )
+
+
+class App(nu.ui.Index):
+    """UI index with one page."""
+
+    pages = nu.ui.Pages({"/": Dashboard})
+
+
+# reactive wire: repaint the chart on every write to `nums`
+ui = nu.ReactForever(
+    State.nums.on_change(),
+    Dashboard.chart.set_points(
+        nu.Collect(nu.Sorted(nu.Iter(State.nums.sample(200, 0, State.cursor)))),
+    ),
+)
+
+# feed: append one number to `nums` at 50 Hz, forever
+feed = State.cursor.init(0) >> nu.ForeverDo(
+    State.nums.set_item(State.cursor, State.cursor) >> State.cursor.inc() >> nu.Delay(0.02),
+)
+
+# assemble: rocksdb-backed, served over the browser
+app = nu.With(
+    nu.kv.rocksdb_navigator(str(_DB)),
+    nu.ui.server(nu.kv.auto_flow_atomic(ui)),
+    body=nu.kv.auto_flow_atomic(feed),
+)
+
+
+if __name__ == "__main__":
+    import asyncio
+
+    asyncio.run(nu.arun(app))

nu/_cli/main.py

@@ -0,0 +1,49 @@
+"""Root click group for the `nu` CLI (rendered via rich-click)."""
+
+from __future__ import annotations
+
+import rich_click as click
+
+from nu._cli._meta import nu_version
+from nu._cli.commands.demo import demo
+from nu._cli.commands.doctor import doctor
+from nu._cli.commands.telemetry import telemetry
+from nu._config.branding import BLUE, PURPLE, render_header
+
+
+# Rich-click styling: strict brand duo -- purple headers, blue values.
+click.rich_click.USE_RICH_MARKUP = True
+click.rich_click.STYLE_HEADER_TEXT = f"bold {PURPLE}"
+click.rich_click.STYLE_USAGE = f"bold {PURPLE}"
+click.rich_click.STYLE_SWITCH = f"bold {PURPLE}"
+click.rich_click.STYLE_OPTION = f"bold {BLUE}"
+click.rich_click.STYLE_COMMAND = f"bold {BLUE}"
+click.rich_click.STYLE_METAVAR = BLUE
+click.rich_click.STYLE_HELPTEXT_FIRST_LINE = "bold"
+click.rich_click.STYLE_HELPTEXT = ""
+click.rich_click.SHOW_ARGUMENTS = True
+click.rich_click.MAX_WIDTH = 100
+
+
+@click.group(
+    invoke_without_command=True,
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help="Nu: the interaction primitive.",
+)
+@click.version_option(nu_version(), "-V", "--version", prog_name="nu")
+@click.pass_context
+def cli(ctx: click.Context) -> None:
+    """Root `nu` group; individual commands are attached below."""
+    if ctx.invoked_subcommand is None:
+        render_header()
+        click.echo(ctx.get_help())
+
+
+cli.add_command(demo)
+cli.add_command(doctor)
+cli.add_command(telemetry)
+
+
+def main() -> None:
+    """Console-script entrypoint for `nu`."""
+    cli()

nucli-0.2.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.5
+Name: nucli
+Version: 0.2.0
+Summary: The `nu` command line: doctor, demos, telemetry. Ships alongside the nucore kernel and the nustd fabrics.
+Project-URL: Repository, https://github.com/nustackdev/nu
+Author-email: Gor Arakelyan <gorarkln@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE.md
+Keywords: agentic,ai-agents,cli,database,distributed-systems,key-value-store,llm,nu,nustack,observability,python,ray,real-time,rocksdb,state-management,ui
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: nustd>=0.2.0
+Requires-Dist: rich-click>=1.6
+Requires-Dist: rich>=10.7
+Description-Content-Type: text/markdown
+
+# nucli
+
+The `nu` command line for [Nu](https://nustack.dev).
+
+Installing this gives you the `nu` executable:
+
+```bash
+nu --version
+nu doctor          # environment + fabric backend check
+nu demo movies     # run a packaged demo app
+nu telemetry       # see / change telemetry settings
+```
+
+It ships `nu._cli` into the `nu.` namespace and depends on
+[`nustd`](https://pypi.org/project/nustd/) (which pulls the
+[`nucore`](https://pypi.org/project/nucore/) kernel) because the
+packaged demos run on `nu.ui` and `nu.kv` at runtime.
+
+You normally do not install this directly - `pip install "nustd[all]" nucli`
+brings it along. Released in lockstep with the kernel. Docs at
+[nustack.dev](https://nustack.dev).

nucli-0.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+nu/_cli/__init__.py,sha256=FxdfZJiiRLr98joIgkgcaeH5Vp7lZrDxRTzvZ8nA1dE,111
+nu/_cli/__main__.py,sha256=6I6DMcmu-eP3NcwYE9Yz4rOCqbPIBwat4dzcgaXqQ2U,106
+nu/_cli/_meta.py,sha256=AVFflKVac7SYTND5DyfypuL3TxDkKcG03CKPLDeAgSw,681
+nu/_cli/main.py,sha256=JbjDej_3-8BGmcER1mk932OWzs9Wi5RWZV-gOHhdN_w,1520
+nu/_cli/commands/__init__.py,sha256=OLY7moehHM4Eqn6H_ql7cOWGUgHw3mOb5bgtZQYGs_A,59
+nu/_cli/commands/demo.py,sha256=1qR3baLX_F1dCTPsFSHNfEmwY_lbQOgmHIaOJmiANJw,2160
+nu/_cli/commands/doctor.py,sha256=C4rhGSB8yMAmVJ6Fr9h-NJCBOyjsYoo6thYPlXcccW8,1751
+nu/_cli/commands/telemetry.py,sha256=SRaF3kvWPEostc5QGgJMi-ULPozB7wNGN51H3AcRrJ4,1672
+nu/_cli/demos/__init__.py,sha256=CdIVCl-Je_xf3-3t0C10fXg3MS-7tRevKtpSbv3-zmE,58
+nu/_cli/demos/counter.py,sha256=GxaFfE1FBawgK3-LrgZIZ-7LQtqT_RnsQgA7OLyYN6Q,2603
+nu/_cli/demos/movies.py,sha256=ob2wfLB4rJ77w_oFZt-ghQ1sU7keCqq-LgqjPcV_2jQ,14232
+nu/_cli/demos/sampled.py,sha256=R-DaM5TCtAOr8jf8mSRtRTdziaIgIe3jDDUKfgnR4nI,2918
+nucli-0.2.0.dist-info/METADATA,sha256=sCP_dGEd54SbFOXeY6uju6JILcsff_JtxObja_3V4Yc,1723
+nucli-0.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+nucli-0.2.0.dist-info/entry_points.txt,sha256=8YwI05yDK6NTzBFGVitum_iUW6UiYs-X8hvgXPK44OM,36
+nucli-0.2.0.dist-info/licenses/LICENSE.md,sha256=PEpG4wYlyvGfSdM5PUoedv96Dey3luSgiLaQpN_QSF8,11285
+nucli-0.2.0.dist-info/RECORD,,

nucli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

nucli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nu = nu._cli:main

nucli-0.2.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Gor Arakelyan
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing
+   permissions and limitations under the License.