moutils 0.1.0__tar.gz

moutils-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,34 @@
+name: Build package
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      id-token: write
+      contents: write
+    env:
+      UV_PYTHON: 3.12
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: |
+          uv build
+
+      - name: Publish package
+        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+        run: |
+          uv publish

moutils-0.1.0/.github/workflows/pages.yml

@@ -0,0 +1,71 @@
+name: GitHub Pages
+
+on:
+  # Weekly
+  schedule:
+    - cron: '0 0 * * 0' # Run at midnight UTC on Sunday
+
+  # Run on pushes to main that affect notebooks or workflow
+  push:
+    branches: [main]
+    paths:
+      - 'notebooks/**'
+      - 'src/**'
+      - '.github/workflows/pages.yml'
+
+  # Allow manual trigger
+  workflow_dispatch: {}
+
+# Prevent concurrent deployments
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+env:
+  UV_SYSTEM_PYTHON: 1
+  PYTHON_VERSION: '3.12'
+
+jobs:
+  export-notebooks:
+    runs-on: ubuntu-latest
+
+    permissions:
+      pull-requests: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: 🐍 Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: 📄 Export notebooks
+        run: |
+          uvx marimo export html-wasm notebooks/example.py -o _site --mode edit
+
+      - name: 📦 Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+          retention-days: 7
+
+  deploy:
+    needs: export-notebooks
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    permissions:
+      pages: write
+      id-token: write
+
+    steps:
+      - name: 🌐 Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+        with:
+          artifact_name: github-pages

moutils-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+node_modules
+.venv
+dist
+.DS_Store
+
+# Python
+__pycache__
+.ipynb_checkpoints
+
+_site

moutils-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+fail_fast: false
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-yaml
+
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.7
+    hooks:
+      - id: actionlint
+        args: [-ignore, SC]
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.44.0
+    hooks:
+      - id: markdownlint-fix
+        args: [-c, configs/.markdownlint.yaml, --fix, --disable, MD028]
+
+  - repo: https://github.com/crate-ci/typos
+    rev: typos-dict-v0.12.4
+    hooks:
+      - id: typos
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.6
+    hooks:
+      - id: ruff
+      # Run the formatter
+      - id: ruff-format

moutils-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 marimo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

moutils-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: moutils
+Version: 0.1.0
+License-File: LICENSE
+Requires-Dist: anywidget
+Provides-Extra: dev
+Requires-Dist: marimo; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# moutils
+
+Utility functions used in [marimo](https://github.com/marimo-team/marimo).
+
+> [!NOTE]
+> This is a community led effort and not actively prioritized by the core marimo team.
+
+## Installation
+
+```sh
+pip install moutils
+```
+
+or with [uv](https://github.com/astral-sh/uv):
+
+```sh
+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
+
+## Development
+
+We use [uv](https://github.com/astral-sh/uv) for development.
+
+```sh
+uv run marimo notebooks/example.py
+```
+
+### Installing pre-commit
+
+```sh
+uv tool install pre-commit
+pre-commit
+```

moutils-0.1.0/README.md

@@ -0,0 +1,69 @@
+# moutils
+
+Utility functions used in [marimo](https://github.com/marimo-team/marimo).
+
+> [!NOTE]
+> This is a community led effort and not actively prioritized by the core marimo team.
+
+## Installation
+
+```sh
+pip install moutils
+```
+
+or with [uv](https://github.com/astral-sh/uv):
+
+```sh
+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
+
+## Development
+
+We use [uv](https://github.com/astral-sh/uv) for development.
+
+```sh
+uv run marimo notebooks/example.py
+```
+
+### Installing pre-commit
+
+```sh
+uv tool install pre-commit
+pre-commit
+```

moutils-0.1.0/deno.json

@@ -0,0 +1,14 @@
+{
+  "lock": false,
+  "compilerOptions": {
+    "checkJs": true,
+    "allowJs": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"]
+  },
+  "fmt": {
+    "exclude": [".venv"]
+  },
+  "lint": {
+    "exclude": [".venv"]
+  }
+}

moutils-0.1.0/notebooks/example.py

@@ -0,0 +1,141 @@
+import marimo
+
+__generated_with = "0.11.26"
+app = marimo.App(width="medium")
+
+
+@app.cell
+def _():
+    import marimo as mo
+    from moutils import (
+        URLHash,
+        URLPath,
+        StorageItem,
+        CookieManager,
+        DOMQuery,
+        Slot,
+    )
+
+    return CookieManager, DOMQuery, Slot, StorageItem, URLHash, URLPath, mo
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## `URLPath`""")
+    return
+
+
+@app.cell
+def _(URLPath):
+    url_path = URLPath()
+    return (url_path,)
+
+
+@app.cell
+def _(url_path):
+    url_path.path
+    return
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## `URLHash`""")
+    return
+
+
+@app.cell
+def _(URLHash):
+    url_hash = URLHash()
+    return (url_hash,)
+
+
+@app.cell
+def _(url_hash):
+    url_hash.hash
+    return
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## StorageItem""")
+    return
+
+
+@app.cell
+def _(StorageItem):
+    local_state = StorageItem(key="my_state")
+    return (local_state,)
+
+
+@app.cell
+def _(local_state):
+    local_state.data = 100
+    return
+
+
+@app.cell
+def _(local_state):
+    local_state.data
+    return
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## Cookies""")
+    return
+
+
+@app.cell
+def _(CookieManager):
+    cookies = CookieManager()
+    return (cookies,)
+
+
+@app.cell
+def _(cookies):
+    cookies.cookies
+    return
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## DOM Query""")
+    return
+
+
+@app.cell
+def _(DOMQuery):
+    query = DOMQuery(selector="#root")
+    return (query,)
+
+
+@app.cell
+def _(query):
+    query.result
+    return
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""## Slot""")
+    return
+
+
+@app.cell
+def _(Slot):
+    slot = Slot(
+        children="<div>hello</div>",
+        on_mouseover=lambda: print("mouse over"),
+        on_mouseout=lambda: print("mouse out"),
+    )
+    return (slot,)
+
+
+@app.cell
+def _(slot):
+    slot.value
+    return
+
+
+if __name__ == "__main__":
+    app.run()

moutils-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[project]
+dependencies = ["anywidget"]
+name = "moutils"
+readme = "README.md"
+version = "0.1.0"
+
+# For projects not using `uv`, you can install these development dependencies with:
+# `pip install -e ".[dev]"`
+# If you're using `uv` for development, feel free to remove this section.
+[project.optional-dependencies]
+dev = ["marimo"]
+
+# Dependency groups (recognized by `uv`). For more details, visit:
+# https://peps.python.org/pep-0735/
+[dependency-groups]
+dev = ["marimo"]
+
+[tool.marimo.runtime]
+pythonpath = ["src"]

moutils-0.1.0/releasing.md

@@ -0,0 +1,37 @@
+# Release Process
+
+This document outlines the process for creating a new release of moutils.
+
+## Creating a Release
+
+1. Update version in `pyproject.toml`
+2. Commit changes:
+
+   ```sh
+   git add pyproject.toml
+   git commit -m "Bump version to x.y.z"
+   ```
+
+3. Tag the release:
+
+   ```sh
+   git tag -a x.y.z -m "Release version x.y.z"
+   ```
+
+4. Push changes:
+
+   ```sh
+   git push origin main && git push origin x.y.z
+   ```
+
+5. GitHub Actions will automatically build and publish the package to PyPI when the tag is pushed.
+
+```sh
+
+## Version Numbering
+
+We follow [Semantic Versioning](https://semver.org/):
+
+- **MAJOR** version for incompatible API changes
+- **MINOR** version for backwards-compatible functionality additions
+- **PATCH** version for backwards-compatible bug fixes

moutils-0.1.0/renovate.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ]
+}