moops 0.12.2__tar.gz → 0.13.0__tar.gz

{moops-0.12.2 → moops-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moops
-Version: 0.12.2
+Version: 0.13.0
 Summary: Write Marimo notebooks that also work as CLI scripts, with unified UI controls
 Keywords: marimo,notebooks,cli,testing
 Author: Yair Chuchem
@@ -13,11 +13,13 @@ 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: 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
+Provides-Extra: table
 Provides-Extra: test
 Description-Content-Type: text/markdown
 

{moops-0.12.2 → moops-0.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "moops"
-version = "0.12.2"
+version = "0.13.0"
 description = "Write Marimo notebooks that also work as CLI scripts, with unified UI controls"
 license = "MIT"
 readme = "README.md"
@@ -29,6 +29,8 @@ dependencies = [
 [project.optional-dependencies]
 # Interface.strategy() builds a Hypothesis strategy; only needed for testing.
 test = ["hypothesis"]
+# Group.table() uses pandas.to_markdown(), which requires tabulate for CLI output.
+table = ["tabulate>=0.10.0"]
 
 [project.urls]
 Homepage = "https://github.com/yairchu/moops"

{moops-0.12.2 → moops-0.13.0}/src/moops/group.py

@@ -371,6 +371,45 @@ class Group:
         _terminal_graphics.emit(_terminal_graphics.to_png(fig, dpi=dpi))
         return None
 
+    def table(
+        self,
+        data: typing.Any,
+        **kwargs: typing.Any,
+    ) -> typing.Any | None:
+        """Display tabular data in notebooks or plain text in CLI."""
+
+        if self.is_interface_query or self.output_mode is None:
+            return None
+        if self.output_mode is OutputMode.NOTEBOOK:
+            return mo.ui.table(data, **kwargs)
+        format_mapping = kwargs.get("format_mapping", {})
+        if format_mapping:
+            if not hasattr(data, "copy"):
+                raise NotImplementedError(
+                    "format_mapping is only supported for data types "
+                    "with a copy() method, such as pandas DataFrames"
+                )
+            data = data.copy()
+            for column, format_value in format_mapping.items():
+                if column in data:
+                    fn = format_value if callable(format_value) else format_value.format
+                    data[column] = data[column].map(fn)
+        if hasattr(data, "to_markdown"):
+            try:
+                print(data.to_markdown(index=False))
+            except ImportError:
+                import warnings
+
+                warnings.warn(
+                    "Install tabulate for formatted table output: pip install tabulate",
+                    stacklevel=2,
+                )
+                print(data)
+        else:
+            print(data)
+        print()
+        return None
+
     def _bool_control(
         self,
         widget: typing.Literal["switch", "checkbox"],

{moops-0.12.2 → moops-0.13.0}/src/moops/interface.py

@@ -520,12 +520,19 @@ class Interface:
             if missing_options
             else ""
         )
-        body_items.append(
-            mo.md(
-                f"<details><summary>Usage</summary>\n\n```\n{self.help()}\n```\n</details>\n"
-                f"{missing_options_msg}"
+        if any(self._input_controls(active_only=True)):
+            help_text = self.help()
+            usage = (
+                f"```\n{help_text}\n```\n"
+                if len(help_text.splitlines()) <= 3
+                else (
+                    f"<details><summary>Usage</summary>\n\n"
+                    f"```\n{help_text}\n```\n</details>\n"
+                )
             )
-        )
+            body_items.append(mo.md(f"{usage}{missing_options_msg}"))
+        elif missing_options_msg:
+            body_items.append(mo.md(missing_options_msg))
         items: list[typing.Any] = [mo.callout(mo.vstack(body_items), kind)]
         if self._presets_ui is not None:
             items.append(self._presets_ui.layout(args))