moops 0.13.2__tar.gz → 0.13.4__tar.gz

{moops-0.13.2 → moops-0.13.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moops
-Version: 0.13.2
+Version: 0.13.4
 Summary: Write Marimo notebooks that also work as CLI scripts, with unified UI controls
 Keywords: marimo,notebooks,cli,testing
 Author: Yair Chuchem
@@ -13,12 +13,15 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: marimo>=0.23.1
+Requires-Dist: tqdm>=4.67.1 ; extra == 'status'
 Requires-Dist: tabulate>=0.10.0 ; extra == 'table'
 Requires-Dist: hypothesis ; extra == 'test'
 Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/yairchu/moops
 Project-URL: Repository, https://github.com/yairchu/moops
 Project-URL: Issues, https://github.com/yairchu/moops/issues
+Project-URL: Agent skill, https://github.com/yairchu/moops/tree/main/skills/migrate-marimo-to-moops
+Provides-Extra: status
 Provides-Extra: table
 Provides-Extra: test
 Description-Content-Type: text/markdown
@@ -47,6 +50,14 @@ Using `moops`, both implementations are merged into one.
 
 Now your notebook doubles as a CLI script
 
+## Agent-assisted migrations
+
+If you use a coding agent, moops includes an agent skill for migrating existing
+marimo notebooks: [`migrate-marimo-to-moops`](skills/migrate-marimo-to-moops/SKILL.md).
+
+Install or point your agent at that skill, then ask it to migrate a notebook to
+moops while preserving the notebook's behavior.
+
 ## Running notebooks from Python
 
 Notebooks can also be called from Python with `moops.run`.
@@ -196,7 +207,7 @@ def test_name_casing_preserves_alphanumeric_count(kwargs):
 
 The `examples/` directory is grouped by topic:
 
-* `basics/` — small notebooks covering options, flags, and file inputs
+* `basics/` — small notebooks covering options, flags, file inputs, and status output
 * `custom_controls/` — `args.custom()` and mirroring it via `controls_from`
 * `composition/` — embedding and varying notebooks (`embed`, `variant_embed`)
 * `game_of_life/` — a worked multi-notebook example

{moops-0.13.2 → moops-0.13.4}/README.md

@@ -22,6 +22,14 @@ Using `moops`, both implementations are merged into one.
 
 Now your notebook doubles as a CLI script
 
+## Agent-assisted migrations
+
+If you use a coding agent, moops includes an agent skill for migrating existing
+marimo notebooks: [`migrate-marimo-to-moops`](skills/migrate-marimo-to-moops/SKILL.md).
+
+Install or point your agent at that skill, then ask it to migrate a notebook to
+moops while preserving the notebook's behavior.
+
 ## Running notebooks from Python
 
 Notebooks can also be called from Python with `moops.run`.
@@ -171,7 +179,7 @@ def test_name_casing_preserves_alphanumeric_count(kwargs):
 
 The `examples/` directory is grouped by topic:
 
-* `basics/` — small notebooks covering options, flags, and file inputs
+* `basics/` — small notebooks covering options, flags, file inputs, and status output
 * `custom_controls/` — `args.custom()` and mirroring it via `controls_from`
 * `composition/` — embedding and varying notebooks (`embed`, `variant_embed`)
 * `game_of_life/` — a worked multi-notebook example

{moops-0.13.2 → moops-0.13.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "moops"
-version = "0.13.2"
+version = "0.13.4"
 description = "Write Marimo notebooks that also work as CLI scripts, with unified UI controls"
 license = "MIT"
 readme = "README.md"
@@ -31,11 +31,14 @@ dependencies = [
 test = ["hypothesis"]
 # Group.table() uses pandas.to_markdown(), which requires tabulate for CLI output.
 table = ["tabulate>=0.10.0"]
+# Group.progress_bar() and Group.spinner() use tqdm on the CLI when installed.
+status = ["tqdm>=4.67.1"]
 
 [project.urls]
 Homepage = "https://github.com/yairchu/moops"
 Repository = "https://github.com/yairchu/moops"
 Issues = "https://github.com/yairchu/moops/issues"
+"Agent skill" = "https://github.com/yairchu/moops/tree/main/skills/migrate-marimo-to-moops"
 
 [dependency-groups]
 dev = [
@@ -47,6 +50,7 @@ dev = [
     "pylint>=3.0",
     "pymarkdownlnt>=0.9.37",
     "matplotlib>=3.10.9",
+    "tqdm>=4.67.1",
     "xarray>=2025.6.1",
 ]
 

{moops-0.13.2 → moops-0.13.4}/src/moops/_list_options.py

@@ -81,6 +81,13 @@ def _build_list_ui(
         if 0 <= idx < len(current):
             set_items([*current[:idx], *current[idx + 1 :]])
 
+    def duplicate_at(idx: int) -> None:
+        current = current_items()
+        if 0 <= idx < len(current):
+            set_items(
+                [*current[: idx + 1], copy.deepcopy(current[idx]), *current[idx + 1 :]]
+            )
+
     def move(idx: int, delta: int) -> None:
         current = current_items()
         target = idx + delta
@@ -97,6 +104,11 @@ def _build_list_ui(
             tooltip="Insert an item here",
             on_click=lambda _, idx=i: insert_at(idx),
         )
+        duplicate_btn = mo.ui.button(
+            label="⧉",
+            tooltip="Duplicate this item",
+            on_click=lambda _, idx=i: duplicate_at(idx),
+        )
         up_btn = mo.ui.button(
             label="↑",
             tooltip="Move up",
@@ -116,7 +128,7 @@ def _build_list_ui(
             on_click=lambda _, idx=i: remove_at(idx),
         )
         controls = mo.hstack(
-            [insert_btn, up_btn, down_btn, item_remove_btn],
+            [insert_btn, duplicate_btn, up_btn, down_btn, item_remove_btn],
             justify="start",
         )
         rows.append(mo.vstack([controls, element]))

{moops-0.13.2 → moops-0.13.4}/src/moops/_options.py

@@ -425,6 +425,24 @@ def _missing_path_error(value: str) -> ParseError | None:
     return None
 
 
+def _file_browser_paths(value: typing.Any) -> list[str]:
+    if not value:
+        return []
+    if isinstance(value, str):
+        return [value]
+    if isinstance(value, pathlib.Path):
+        return [str(value)]
+    if isinstance(value, typing.Sequence):
+        items = typing.cast(typing.Sequence[object], value)
+        return [
+            str(item.path)
+            if isinstance(item, _ui_workarounds.FileBrowserFileInfo)
+            else str(item)
+            for item in items
+        ]
+    return [str(value)]
+
+
 @dataclasses.dataclass
 class FileControl(TextControl):
     def create_marimo_element(
@@ -474,6 +492,14 @@ class FileControl(TextControl):
                 continue
             return result
 
+    def format_value(self, value: typing.Any) -> list[str]:
+        paths = _file_browser_paths(value)
+        return super().format_value(paths[0] if paths else "")
+
+    def format_query_value(self, value: typing.Any) -> str | None:
+        paths = _file_browser_paths(value)
+        return super().format_query_value(paths[0] if paths else "")
+
 
 @dataclasses.dataclass
 class MultiFileControl(ValueControl):
@@ -554,13 +580,13 @@ class MultiFileControl(ValueControl):
         return [line]
 
     def format_value(self, value: typing.Any) -> list[str]:
-        values = list(value)
+        values = _file_browser_paths(value)
         if values == self.default:
             return []
         return [option_value_token(self.option, v) for v in values]
 
     def format_query_value(self, value: typing.Any) -> str | None:
-        values = list(value)
+        values = _file_browser_paths(value)
         return None if values == self.default else json.dumps(values)
 
     def prompt_interactive(self, effective_default: typing.Any = _UNSET) -> list[str]:

moops-0.13.4/src/moops/_status.py

@@ -0,0 +1,265 @@
+from __future__ import annotations
+
+import collections.abc
+import itertools
+import sys
+import threading
+import typing
+
+try:
+    from tqdm.auto import tqdm
+except ImportError:
+    tqdm = None  # type: ignore[assignment]
+
+S = typing.TypeVar("S")
+
+
+class DisabledSpinner:
+    def __enter__(self) -> DisabledSpinner:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: typing.Any,
+    ) -> None:
+        del exc_type, exc_value, traceback
+
+    def update(
+        self,
+        *,
+        title: str | None = None,
+        subtitle: str | None = None,
+    ) -> None:
+        del title, subtitle
+
+    def close(self) -> None:
+        pass
+
+
+class ProgressBar(typing.Generic[S]):
+    def __init__(
+        self,
+        collection: (
+            collections.abc.Collection[S]
+            | collections.abc.Iterator[S]
+            | collections.abc.AsyncIterable[S]
+            | None
+        ) = None,
+        *,
+        title: str | None = None,
+        subtitle: str | None = None,
+        completion_title: str | None = None,
+        completion_subtitle: str | None = None,
+        total: int | None = None,
+        remove_on_exit: bool = False,
+        disabled: bool = False,
+        **kwargs: typing.Any,
+    ) -> None:
+        explicit_total = total is not None
+        if collection is not None and total is None:
+            if not isinstance(collection, collections.abc.Sized):
+                raise TypeError("Cannot determine length; pass total")
+            total = len(collection)
+        if total is None:
+            raise ValueError("total is required")
+        self._collection = collection
+        self._title = title
+        self._subtitle = subtitle
+        self._completion_title = completion_title
+        self._completion_subtitle = completion_subtitle
+        self._total = total
+        self._current = 0
+        self._step = (
+            collection.step if explicit_total and isinstance(collection, range) else 1
+        )
+        self._disabled = disabled
+        self._closed = False
+        self._bar = (
+            None
+            if tqdm is None
+            else tqdm(
+                total=total,
+                desc=self._desc(),
+                disable=disabled,
+                leave=not remove_on_exit,
+            )
+        )
+        if self._bar is None:
+            self._emit()
+
+    def __iter__(self) -> collections.abc.Iterator[S]:
+        if self._collection is None:
+            raise RuntimeError("progress_bar needs a collection to iterate")
+        if isinstance(self._collection, collections.abc.AsyncIterable):
+            raise RuntimeError("Use async for with async collections")
+        try:
+            for item in self._collection:
+                yield item
+                self.update(increment=self._step)
+        finally:
+            self.close()
+
+    async def __aiter__(self) -> collections.abc.AsyncIterator[S]:
+        if self._collection is None:
+            raise RuntimeError("progress_bar needs a collection to iterate")
+        if not isinstance(self._collection, collections.abc.AsyncIterable):
+            raise RuntimeError("Use for with sync collections")
+        try:
+            async for item in self._collection:
+                yield item
+                self.update()
+        finally:
+            self.close()
+
+    def __enter__(self) -> ProgressBar[S]:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: typing.Any,
+    ) -> None:
+        del exc_type, exc_value, traceback
+        self.close()
+
+    def update(
+        self,
+        *,
+        increment: int = 1,
+        title: str | None = None,
+        subtitle: str | None = None,
+    ) -> None:
+        self._current += increment
+        self._title = self._title if title is None else title
+        self._subtitle = self._subtitle if subtitle is None else subtitle
+        if self._bar is not None:
+            self._bar.set_description_str(self._desc(), refresh=False)
+            self._bar.update(increment)
+        else:
+            self._emit()
+
+    def close(self) -> None:
+        if self._closed:
+            return
+        self._closed = True
+        if self._completion_title is not None or self._completion_subtitle is not None:
+            self.update(
+                increment=0,
+                title=self._completion_title,
+                subtitle=self._completion_subtitle,
+            )
+        if self._bar is not None:
+            self._bar.close()
+
+    def _desc(self) -> str:
+        label = self._title or "Progress"
+        detail = f" - {self._subtitle}" if self._subtitle else ""
+        return f"{label}{detail}"
+
+    def _emit(self) -> None:
+        if not self._disabled:
+            print(f"{self._desc()}: {self._current}/{self._total}")
+
+
+class Spinner:
+    def __init__(
+        self,
+        title: str | None = None,
+        subtitle: str | None = None,
+        remove_on_exit: bool = True,
+        *,
+        disabled: bool = False,
+    ) -> None:
+        self._title = title
+        self._subtitle = subtitle
+        self._remove_on_exit = remove_on_exit
+        self._disabled = disabled
+        self._stream = sys.stderr
+        self._closed = False
+        self._rendered_len = 0
+        self._frames = itertools.cycle("-\\|/")
+        self._stop = threading.Event()
+        self._thread: threading.Thread | None = None
+        if self._can_animate():
+            self._render_frame(next(self._frames))
+            self._thread = threading.Thread(target=self._animate, daemon=True)
+            self._thread.start()
+        else:
+            self._emit()
+
+    def __enter__(self) -> Spinner:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: typing.Any,
+    ) -> None:
+        del exc_type, exc_value, traceback
+        self.close()
+
+    def close(self) -> None:
+        if self._closed:
+            return
+        self._closed = True
+        if self._thread is not None:
+            self._stop.set()
+            self._thread.join(timeout=0.5)
+            if self._remove_on_exit:
+                self._clear_line()
+            else:
+                self._write_line(self._desc(), newline=True)
+            return
+        if not self._remove_on_exit:
+            print("Done")
+
+    def update(
+        self,
+        *,
+        title: str | None = None,
+        subtitle: str | None = None,
+    ) -> None:
+        self._title = self._title if title is None else title
+        self._subtitle = self._subtitle if subtitle is None else subtitle
+        if self._thread is not None:
+            self._render_frame(next(self._frames))
+        else:
+            self._emit()
+
+    def _desc(self) -> str:
+        label = self._title or "Working"
+        detail = f" - {self._subtitle}" if self._subtitle else ""
+        return f"{label}{detail}"
+
+    def _emit(self) -> None:
+        if not self._disabled:
+            print(self._desc())
+
+    def _can_animate(self) -> bool:
+        return (
+            not self._disabled
+            and hasattr(self._stream, "isatty")
+            and self._stream.isatty()
+        )
+
+    def _animate(self) -> None:
+        while not self._stop.wait(0.1):
+            self._render_frame(next(self._frames))
+
+    def _render_frame(self, frame: str) -> None:
+        self._write_line(f"{frame} {self._desc()}")
+
+    def _write_line(self, text: str, *, newline: bool = False) -> None:
+        padded = text.ljust(self._rendered_len)
+        self._stream.write("\r" + padded + ("\n" if newline else ""))
+        self._stream.flush()
+        self._rendered_len = max(self._rendered_len, len(text))
+
+    def _clear_line(self) -> None:
+        if self._rendered_len:
+            self._stream.write("\r" + (" " * self._rendered_len) + "\r")
+            self._stream.flush()

{moops-0.13.2 → moops-0.13.4}/src/moops/_text_wrap.py

@@ -44,14 +44,16 @@ def wrap_help_line(line: str, width: int = 88) -> list[str]:
     return result
 
 
-def wrap_command(name: str, groups: list[str], width: int = 72) -> str:
+def wrap_command(
+    name: str, groups: list[str], width: int = 72, *, quote_name: bool = True
+) -> str:
     """Render a script command, wrapping long lines with shell continuations.
 
     Short commands stay on one line. When the single-line form exceeds ``width``,
     each option group goes on its own line joined by `` \\`` continuations, which
     remains valid copy-pasteable shell.
     """
-    quoted_name = shlex.quote(name)
+    quoted_name = shlex.quote(name) if quote_name else name
     single_line = " ".join([quoted_name, *groups])
     if not groups or len(single_line) <= width:
         return single_line

{moops-0.13.2 → moops-0.13.4}/src/moops/group.py

@@ -21,6 +21,7 @@ from . import (
     _parse,
     _preset_state,
     _query_params,
+    _status,
     _terminal_graphics,
     _value_resolution,
     _variant,
@@ -33,6 +34,7 @@ from ._ui_workarounds import FileBrowserWithInitialSelection
 from .presets import Presets
 
 Numeric = int | float
+S = typing.TypeVar("S")
 
 
 class OutputMode(enum.Enum):
@@ -410,6 +412,47 @@ class Group:
         print()
         return None
 
+    def progress_bar(
+        self,
+        collection: typing.Collection[S]
+        | typing.Iterator[S]
+        | typing.AsyncIterable[S]
+        | None = None,
+        *,
+        disabled: bool = False,
+        **kwargs: typing.Any,
+    ) -> typing.Any:
+        """Show progress in notebooks or plain status lines on the CLI."""
+        return typing.cast(
+            typing.Any,
+            mo.status.progress_bar
+            if self.output_mode is OutputMode.NOTEBOOK
+            else _status.ProgressBar,
+        )(
+            collection,
+            disabled=disabled or self.is_interface_query or self.output_mode is None,
+            **kwargs,
+        )
+
+    def spinner(
+        self,
+        title: str | None = None,
+        subtitle: str | None = None,
+        remove_on_exit: bool = True,
+    ) -> typing.Any:
+        """Show a spinner in notebooks or a plain status line on the CLI."""
+        if self.is_interface_query or self.output_mode is None:
+            return _status.DisabledSpinner()
+        return (
+            mo.status.spinner
+            if self.output_mode is OutputMode.NOTEBOOK
+            else _status.Spinner
+        )(
+            title=title,
+            subtitle=subtitle,
+            remove_on_exit=remove_on_exit,
+        )
+
     def _bool_control(
         self,
         widget: typing.Literal["switch", "checkbox"],

{moops-0.13.2 → moops-0.13.4}/src/moops/interface.py

@@ -436,19 +436,22 @@ class Interface:
         if not self.notebook_name:
             return mo.md("Input bundle with no notebook name")
         notebook_name = html.escape(self.notebook_name)
-        href = html.escape(self._standalone_url(), quote=True)
-        link = mo.md(
-            f'<a href="{href}" target="_blank" rel="noopener">'
-            f"An embedded instance of `{notebook_name}`</a>"
-        )
+        label = f"An embedded instance of `{notebook_name}`"
+        if _running_in_edit_mode():
+            href = html.escape(self._standalone_url(), quote=True)
+            heading: mo.Html = mo.md(
+                f'<a href="{href}" target="_blank" rel="noopener">{label}</a>'
+            )
+        else:
+            heading = mo.md(label)
         if self.embedded_extra_overrides != frozenset():
             # None: embedded outside moops.embed, so overrides are unknown.
             # Non-empty: the parent injected defs beyond args, so no CLI
             # command can reproduce this setup.
-            return link
+            return heading
         command = _wrap_command(self.notebook_file, self._standalone_arg_groups())
         return mo.vstack(
-            [link, mo.md(f"To run as a standalone script:\n```\n{command}\n```")]
+            [heading, mo.md(f"To run as a standalone script:\n```\n{command}\n```")]
         )
 
     def _standalone_url(self) -> str:
@@ -633,7 +636,9 @@ def attached_interface(ctrl: typing.Any) -> Interface | None:
 
 def _wrap_command(command: str, groups: list[str]) -> str:
     if _should_use_uv_run(command):
-        return _text_wrap.wrap_command("uv", [f"run {shlex.quote(command)}", *groups])
+        return _text_wrap.wrap_command(
+            f"uv run {shlex.quote(command)}", groups, quote_name=False
+        )
     return _text_wrap.wrap_command(command, groups)
 
 
@@ -716,3 +721,25 @@ def _collect_usage_placeholders(
     for ctrl in iface.controls:
         if sub_iface := attached_interface(ctrl):
             _collect_usage_placeholders(sub_iface, result)
+
+
+def _running_in_edit_mode() -> bool:
+    """Return True only when running inside a marimo *edit* session.
+
+    ``mo.running_in_notebook()`` is True for both ``marimo edit`` and
+    ``marimo run``, but links to ``/?file=...`` only work in edit sessions.
+    """
+    if not mo.running_in_notebook():
+        return False
+    try:
+        from marimo._runtime.context import get_context
+        from marimo._runtime.context.kernel_context import KernelRuntimeContext
+        from marimo._session.model import SessionMode
+
+        ctx = get_context()
+        return (
+            isinstance(ctx, KernelRuntimeContext)
+            and ctx.session_mode == SessionMode.EDIT
+        )
+    except Exception:
+        return False