marimo-toml-editor 0.1.0__tar.gz

marimo_toml_editor-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/marimo-toml-editor
+    permissions:
+      id-token: write  # IMPORTANT for Trusted Publishing (OIDC)
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+        
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

marimo_toml_editor-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# uv
+.uv/
+
+# Distribution
+*.whl
+*.tar.gz
+
+# Editors
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Marimo cache
+.marimo/
+
+# Docs
+docs/_build/
+
+*.agent

marimo_toml_editor-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to `marimo-toml-editor` are documented here.
+
+## [0.1.0] — 2026-02-21
+
+### Added
+- Initial release
+- `TomlConfigEditor` anywidget with full TOML load/save
+- Tab-per-table navigation
+- Type-aware scalar editors (string, number, boolean, color)
+- Rich list editor with per-item reorder and delete
+- Inline dict editor for shallow nested objects
+- Type badges for each key
+- Key search / filter
+- Undo / Redo history
+- Dirty indicator on the Save button
+- Keyboard shortcuts (Ctrl/Cmd+S save, Ctrl/Cmd+Z undo)
+- Raw JSON preview tab with copy-to-clipboard
+- Light and dark mode support

marimo_toml_editor-0.1.0/CONTRIBUTING_ANYWIDGET.md

@@ -0,0 +1,68 @@
+# Contributing to the anywidget gallery
+
+This document contains everything needed to submit `marimo-toml-editor` to the
+[anywidget community gallery](https://anywidget.dev/en/community/).
+
+## PR Target
+
+**Repo:** https://github.com/manzt/built-with-anywidget  
+**File to edit:** `assets/manifest.json`
+
+## Manifest entry to add
+
+Add this JSON object to the array in `assets/manifest.json`:
+
+```json
+{
+  "repo": "javirm3/marimo-toml-editor",
+  "description": "Interactive TOML config editor for Jupyter and marimo notebooks. Type-aware inputs, rich list/dict editors, tabs, undo/redo, search, and dark mode.",
+  "sourceUrl": "https://raw.githubusercontent.com/javirm3/marimo-toml-editor/main/docs/demo.gif"
+}
+```
+
+> **Note:** You need to create and upload `docs/demo.gif` (a screen recording of
+> the widget in action) before the PR will show a preview image in the gallery.
+
+## Suggested PR title
+
+```
+feat: add marimo-toml-editor to gallery
+```
+
+## Suggested PR description
+
+```markdown
+Hi! I'd like to add **marimo-toml-editor** to the anywidget community gallery.
+
+### What it does
+
+An interactive TOML config editor widget for Jupyter and marimo notebooks.
+
+### Features
+- Tab-per-table navigation (each top-level TOML `[table]` is its own tab)
+- Type-aware editors: strings, numbers, booleans, hex color picker
+- Rich list editor: per-item rows with reorder (↑↓) and delete buttons
+- Inline dict editor for shallow nested objects
+- Type badges (`str`, `int`, `bool`, `[]`, `{}`) next to each key
+- Key search / filter
+- Undo / redo history
+- Dirty indicator + keyboard shortcuts (Ctrl/Cmd+S save, Ctrl/Cmd+Z undo)
+- Raw JSON preview with clipboard copy
+- Light + dark mode (follows system preference)
+
+### Install
+
+pip install marimo-toml-editor
+
+### PyPI / GitHub
+
+- GitHub: https://github.com/javirm3/marimo-toml-editor
+- PyPI: https://pypi.org/project/marimo-toml-editor
+```
+
+## Before submitting
+
+- [ ] Package published to PyPI (`uv build && uv publish`)
+- [ ] `docs/demo.gif` created and committed (screen recording of the widget)
+- [ ] GitHub repo is public
+- [ ] `README.md` has a screenshot / gif at the top

marimo_toml_editor-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+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.

marimo_toml_editor-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: marimo-toml-editor
+Version: 0.1.0
+Summary: Interactive TOML config editor widget for Jupyter and marimo notebooks
+Project-URL: Homepage, https://github.com/javirm3/marimo-toml-editor
+Project-URL: Repository, https://github.com/javirm3/marimo-toml-editor
+Project-URL: Issues, https://github.com/javirm3/marimo-toml-editor/issues
+Author: Javier Rodríguez Martínez
+License: MIT
+License-File: LICENSE
+Keywords: anywidget,config,editor,jupyter,marimo,toml
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Requires-Dist: anywidget>=0.9
+Requires-Dist: tomli>=1.2; python_version < '3.11'
+Requires-Dist: traitlets>=5.0
+Provides-Extra: dev
+Requires-Dist: hatch; extra == 'dev'
+Requires-Dist: marimo; extra == 'dev'
+Requires-Dist: tomli-w; extra == 'dev'
+Provides-Extra: save
+Requires-Dist: tomli-w>=1.0; extra == 'save'
+Description-Content-Type: text/markdown
+
+# marimo-toml-editor
+
+> An interactive TOML config editor widget for **Jupyter** and **marimo** notebooks — built with [anywidget](https://anywidget.dev).
+
+![demo](docs/demo.png)
+
+## Features
+
+- 🗂 **Tab-per-table navigation** — each top-level TOML table is a tab
+- ✏️ **Type-aware editors** — strings, numbers, booleans (toggle), colors (color picker + hex field)
+- 📋 **Rich list editor** — per-item rows with reorder (↑↓) and delete
+- 🪆 **Inline dict editor** — shallow nested tables rendered as compact key-value rows
+- 🏷 **Type badges** — each key shows its type at a glance (`str`, `int`, `bool`, `[]`, `{}`)
+- 🔍 **Search / filter** — filter keys within a tab
+- ↩ **Undo / Redo** — full history
+- 💾 **Save to disk** — requires `tomli-w`
+- 🌗 **Light + dark mode** — follows system preference
+
+## Install
+
+```bash
+pip install marimo-toml-editor          # read-only
+pip install "marimo-toml-editor[save]"  # with save support (tomli-w)
+```
+
+## Usage
+
+### In marimo
+
+```python
+import marimo as mo
+from marimo_toml_editor import TomlConfigEditor
+
+editor = mo.ui.anywidget(TomlConfigEditor("config.toml"))
+editor
+```
+
+Access the current data reactively:
+
+```python
+editor.value["data"]   # dict with the current TOML contents
+```
+
+### In Jupyter
+
+```python
+from marimo_toml_editor import TomlConfigEditor
+
+w = TomlConfigEditor("config.toml")
+w
+```
+
+### Start from a dict (no file)
+
+```python
+from marimo_toml_editor import TomlConfigEditor
+
+w = TomlConfigEditor()
+w.data = {
+    "title": "My App",
+    "debug": False,
+    "server": {"host": "0.0.0.0", "port": 8080},
+    "tags": ["web", "api"],
+}
+```
+
+## API
+
+| Attribute | Type | Description |
+|-----------|------|-------------|
+| `data` | `dict` | Current TOML data (synced) |
+| `path` | `str` | File path (synced) |
+| `name` | `str` | Display name (synced) |
+| `status` | `str` | Last operation status message |
+
+| Method | Description |
+|--------|-------------|
+| `load(path)` | Load a TOML file |
+| `save(path?)` | Save to disk (requires `tomli-w`) |
+
+## Development
+
+```bash
+git clone https://github.com/javirm3/marimo-toml-editor
+cd marimo-toml-editor
+uv run marimo edit examples/demo.py
+```
+
+## License
+
+MIT

marimo_toml_editor-0.1.0/README.md

@@ -0,0 +1,91 @@
+# marimo-toml-editor
+
+> An interactive TOML config editor widget for **Jupyter** and **marimo** notebooks — built with [anywidget](https://anywidget.dev).
+
+![demo](docs/demo.png)
+
+## Features
+
+- 🗂 **Tab-per-table navigation** — each top-level TOML table is a tab
+- ✏️ **Type-aware editors** — strings, numbers, booleans (toggle), colors (color picker + hex field)
+- 📋 **Rich list editor** — per-item rows with reorder (↑↓) and delete
+- 🪆 **Inline dict editor** — shallow nested tables rendered as compact key-value rows
+- 🏷 **Type badges** — each key shows its type at a glance (`str`, `int`, `bool`, `[]`, `{}`)
+- 🔍 **Search / filter** — filter keys within a tab
+- ↩ **Undo / Redo** — full history
+- 💾 **Save to disk** — requires `tomli-w`
+- 🌗 **Light + dark mode** — follows system preference
+
+## Install
+
+```bash
+pip install marimo-toml-editor          # read-only
+pip install "marimo-toml-editor[save]"  # with save support (tomli-w)
+```
+
+## Usage
+
+### In marimo
+
+```python
+import marimo as mo
+from marimo_toml_editor import TomlConfigEditor
+
+editor = mo.ui.anywidget(TomlConfigEditor("config.toml"))
+editor
+```
+
+Access the current data reactively:
+
+```python
+editor.value["data"]   # dict with the current TOML contents
+```
+
+### In Jupyter
+
+```python
+from marimo_toml_editor import TomlConfigEditor
+
+w = TomlConfigEditor("config.toml")
+w
+```
+
+### Start from a dict (no file)
+
+```python
+from marimo_toml_editor import TomlConfigEditor
+
+w = TomlConfigEditor()
+w.data = {
+    "title": "My App",
+    "debug": False,
+    "server": {"host": "0.0.0.0", "port": 8080},
+    "tags": ["web", "api"],
+}
+```
+
+## API
+
+| Attribute | Type | Description |
+|-----------|------|-------------|
+| `data` | `dict` | Current TOML data (synced) |
+| `path` | `str` | File path (synced) |
+| `name` | `str` | Display name (synced) |
+| `status` | `str` | Last operation status message |
+
+| Method | Description |
+|--------|-------------|
+| `load(path)` | Load a TOML file |
+| `save(path?)` | Save to disk (requires `tomli-w`) |
+
+## Development
+
+```bash
+git clone https://github.com/javirm3/marimo-toml-editor
+cd marimo-toml-editor
+uv run marimo edit examples/demo.py
+```
+
+## License
+
+MIT

marimo_toml_editor-0.1.0/examples/__marimo__/session/demo.py.json

@@ -0,0 +1,73 @@
+{
+  "version": "1",
+  "metadata": {
+    "marimo_version": "0.19.11"
+  },
+  "cells": [
+    {
+      "id": "MJUe",
+      "code_hash": "9bac4ebf9b43839df654aedbad122c16",
+      "outputs": [
+        {
+          "type": "data",
+          "data": {
+            "text/markdown": "<span class=\"markdown prose dark:prose-invert contents\"><h1 id=\"marimo-toml-editor-demo\">\ud83d\udcdd marimo-toml-editor demo</h1>\n<span class=\"paragraph\">An interactive TOML config editor widget built with <a href=\"https://anywidget.dev\" rel=\"noopener noreferrer\" target=\"_blank\">anywidget</a>.</span>\n<span class=\"paragraph\"><strong>Features:</strong> tab-per-table, type-aware inputs, rich list/dict editors,\ntype badges, search, undo/redo, dirty indicator, keyboard shortcuts.</span></span>"
+          }
+        }
+      ],
+      "console": []
+    },
+    {
+      "id": "Hbol",
+      "code_hash": "077d526e89f1189124e29c3537608cbf",
+      "outputs": [
+        {
+          "type": "data",
+          "data": {
+            "text/plain": ""
+          }
+        }
+      ],
+      "console": []
+    },
+    {
+      "id": "vblA",
+      "code_hash": "76740d289b9c334b6a01bda376c5e696",
+      "outputs": [
+        {
+          "type": "data",
+          "data": {
+            "text/plain": ""
+          }
+        }
+      ],
+      "console": []
+    },
+    {
+      "id": "bkHC",
+      "code_hash": "417e21a025eddbf41687b5f3b46a71d1",
+      "outputs": [
+        {
+          "type": "data",
+          "data": {
+            "text/html": "<marimo-ui-element object-id='bkHC-0' random-id='bb4ab082-2cec-fbb5-be89-b6797ce7f543'><marimo-anywidget data-initial-value='{&quot;model_id&quot;:&quot;96705e4251554b689d7a322bd3e65d0a&quot;}' data-label='null' data-js-url='&quot;./@file/39078-2594138-UFiKyG5Y.js&quot;' data-js-hash='&quot;7798eab70a4d201909e8458307516180&quot;'></marimo-anywidget></marimo-ui-element>"
+          }
+        }
+      ],
+      "console": []
+    },
+    {
+      "id": "lEQa",
+      "code_hash": "96dadf106cbe1cb6085e8c63fe8c0f50",
+      "outputs": [
+        {
+          "type": "data",
+          "data": {
+            "text/markdown": "<span class=\"markdown prose dark:prose-invert contents\"><h3 id=\"current-state\">Current state</h3>\n<ul>\n<li><strong>Title:</strong> <code>My Application</code></li>\n<li><strong>Debug:</strong> <code>False</code></li>\n<li><strong>Tags:</strong> <code>['web', 'api', 'production']</code></li>\n<li><strong>Server port:</strong> <code>8080</code></li>\n</ul></span>"
+          }
+        }
+      ],
+      "console": []
+    }
+  ]
+}

marimo_toml_editor-0.1.0/examples/demo.py

@@ -0,0 +1,100 @@
+import marimo
+
+__generated_with = "0.19.11"
+app = marimo.App(width="medium")
+
+
+@app.cell
+def _():
+    # /// script
+    # requires-python = ">=3.9"
+    # dependencies = [
+    #     "marimo",
+    #     "anywidget>=0.9",
+    #     "traitlets>=5.0",
+    #     "tomli-w>=1.0",
+    # ]
+    # ///
+    import marimo as mo
+
+    return (mo,)
+
+
+@app.cell
+def _(mo):
+    mo.md(r"""
+    # 📝 marimo-toml-editor demo
+
+    An interactive TOML config editor widget built with [anywidget](https://anywidget.dev).
+
+    **Features:** tab-per-table, type-aware inputs, rich list/dict editors,
+    type badges, search, undo/redo, dirty indicator, keyboard shortcuts.
+    """)
+    return
+
+
+@app.cell
+def _():
+    import sys
+    sys.path.insert(0, "../src")  # dev: load from source
+    from marimo_toml_editor import TomlConfigEditor
+
+    return (TomlConfigEditor,)
+
+
+@app.cell
+def _(TomlConfigEditor, mo):
+    # Instantiate with a sample file path.
+    # The widget will create / load the file when you click Open or Save.
+    editor = mo.ui.anywidget(TomlConfigEditor(name="demo"))
+
+    # Pre-populate with example data (no file required for the demo)
+    editor.widget.data = {
+        "title": "My Application",
+        "debug": False,
+        "version": "1.0.0",
+        "primary_color": "#3b82f6",
+        "max_retries": 3,
+        "tags": ["web", "api", "production"],
+        "server": {
+            "host": "0.0.0.0",
+            "port": 8080,
+            "workers": 4,
+        },
+        "database": {
+            "url": "postgresql://localhost/mydb",
+            "pool_size": 10,
+            "echo": False,
+            "options": {
+                "timeout": 30,
+                "retries": 3,
+            },
+        },
+        "logging": {
+            "level": "INFO",
+            "format": "json",
+            "outputs": ["stdout", "file"],
+        },
+    }
+
+    editor
+    return (editor,)
+
+
+@app.cell
+def _(editor, mo):
+    # Reactively display the current data as the user edits
+    _data = editor.value.get("data", {})
+    mo.md(f"""
+    ### Current state
+
+    - **Title:** `{_data.get('title', '—')}`
+    - **Debug:** `{_data.get('debug', '—')}`
+    - **Tags:** `{_data.get('tags', [])}`
+    - **Server port:** `{(_data.get('server') or {}).get('port', '—')}`
+    """)
+    return
+
+
+if __name__ == "__main__":
+    app.run()

marimo_toml_editor-0.1.0/examples/demo.toml

@@ -0,0 +1,32 @@
+title = "My Application"
+debug = false
+version = "1.0.0"
+primary_color = "#3b82f6"
+max_retries = 3
+tags = [
+    "web",
+    "api",
+    "production",
+]
+
+[server]
+host = "0.0.0.0"
+port = 8080
+workers = 4
+
+[database]
+url = "postgresql://localhost/mydb"
+pool_size = 10
+echo = false
+
+[database.options]
+timeout = 30
+retries = 3
+
+[logging]
+level = "INFO"
+format = "json"
+outputs = [
+    "stdout",
+    "file",
+]

marimo_toml_editor-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "marimo-toml-editor"
+version = "0.1.0"
+description = "Interactive TOML config editor widget for Jupyter and marimo notebooks"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Javier Rodríguez Martínez" }]
+keywords = ["marimo", "jupyter", "anywidget", "toml", "config", "editor"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Visualization",
+  "Framework :: Jupyter",
+]
+requires-python = ">=3.9"
+dependencies = [
+  "anywidget>=0.9",
+  "traitlets>=5.0",
+  "tomli>=1.2; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+save = ["tomli-w>=1.0"]
+dev  = ["marimo", "tomli-w", "hatch"]
+
+[project.urls]
+Homepage   = "https://github.com/javirm3/marimo-toml-editor"
+Repository = "https://github.com/javirm3/marimo-toml-editor"
+Issues     = "https://github.com/javirm3/marimo-toml-editor/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/marimo_toml_editor"]

marimo_toml_editor-0.1.0/src/marimo_toml_editor/__init__.py

@@ -0,0 +1,6 @@
+"""marimo-toml-editor public API."""
+
+from marimo_toml_editor._widget import TomlConfigEditor
+
+__all__ = ["TomlConfigEditor"]
+__version__ = "0.1.0"