moops 0.13.3__tar.gz → 0.13.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moops
-Version: 0.13.3
+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.3 → 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.3 → moops-0.13.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "moops"
-version = "0.13.3"
+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.3 → 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.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.3 → 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"],