moutils 0.3.12

No project description provided

moutils

Utility functions used in marimo.

[!NOTE] This is a community led effort and not actively prioritized by the core marimo team.

Installation

pip install moutils

or with uv:

uv add moutils

Included

URLHash

Widget for interacting with URL hash. Allows you to get and set the hash portion of the URL.

URLPath

Widget for interacting with URL path. Allows you to get and set the current URL path.

DOMQuery

Widget for querying DOM elements. Use CSS selectors to find and interact with elements on the page.

CookieManager

Widget for managing browser cookies. Get, set, and monitor browser cookies.

StorageItem

Widget for interacting with browser storage (local/session). Access and manipulate data in browser's localStorage or sessionStorage.

Slot

Widget for creating a slot that can contain HTML and handle DOM events. Supports a wide range of events:

• Mouse events (click, hover, etc.)
• Keyboard events
• Form events
• Drag and drop
• Touch events
• Pointer events
• Scroll events
• Clipboard events
• Animation and transition events

CopyToClipboard

Widget for copying text to clipboard. Provides a button to copy text and shows success feedback.

ShellWidget

Interactive shell command widget for running terminal commands in notebooks. Features:

• Real-time output streaming
• Cross-platform support (Windows, macOS, Linux)
• Working directory specification
• Asynchronous execution
• Error handling and status reporting

Use the convenience function shell() or the ShellWidget class directly:

from moutils import shell

# Simple command
shell("ls -la")

# With working directory
shell("npm install", working_directory="./frontend")

Development

We use uv for development.

Specific notebook

uv run marimo edit notebooks/example.py

Workspace

uv run --active marimo edit --port 2718

Installing pre-commit

uv tool install pre-commit
pre-commit

Testing

To run all tests (including environment detection and OAuth device flow):

pytest -v tests/