marimo-dev 0.2.6__tar.gz → 0.2.8__tar.gz

{marimo_dev-0.2.6 → marimo_dev-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: marimo-dev
-Version: 0.2.6
+Version: 0.2.8
 Summary: Build and publish python packages from marimo notebooks
 Author: Deufel
 Author-email: Deufel <MDeufel13@gmail.com>
@@ -18,7 +18,6 @@ Project-URL: Repository, https://github.com/deufel/m-dev
 Project-URL: PyPI, https://pypi.org/project/marimo-dev/
 Description-Content-Type: text/markdown
 
-
 # marimo-dev
 
 Build Python packages from Marimo notebooks.
@@ -93,8 +92,19 @@ from .core import greet
 
 ## What gets exported
 
- 1. constants in setup cells
- 2. [self-contained functions and classes](https://docs.marimo.io/guides/reusing_functions/)
+1. **Constants in setup cells** — any assignment in a setup cell becomes a constant
+2. **Decorated functions and classes** — [self-contained functions and classes](https://docs.marimo.io/guides/reusing_functions/) with `@app.function` or `@app.class_definition`
+3. **Export-named cells** — name a cell `export` (or `export_something`) to export arbitrary code as a blob:
+
+```python
+@app.cell
+def export_main():
+    if __name__ == "__main__":
+        main()
+    return
+```
+
+This is useful for code that isn't a function or class, like `if __name__ == "__main__"` blocks.
 
 ## Hash pipe directives
 
@@ -150,6 +160,8 @@ skip_prefixes = ["XX_", "test_"]  # ignore these files
 
 ```bash
 md build              # build package from notebooks and make docs
+md bundle             # bundle into single file with PEP 723 dependencies
+md bundle app.py      # bundle to specific filename at project root
 md docs               # build the static docs (beta)
 md publish --test     # publish to Test PyPI
 md publish            # publish to PyPI
@@ -158,6 +170,25 @@ md nuke               # remove all build artifacts (dist, docs, src, temp*)
 ```
 *If you make a temp folder it will be explicitly removed when running `md nuke`*
 
+## Single-file applications
+
+Use `md bundle` to create a standalone Python file with [PEP 723](https://peps.python.org/pep-0723/) inline dependencies:
+
+```bash
+md bundle app.py
+uv run app.py
+```
+
+The generated file includes a dependency header that `uv` reads automatically:
+
+```python
+# /// script
+# dependencies = ["fasthtml", "uvicorn"]
+# ///
+```
+
+This lets you deploy a single `.py` file — anyone with `uv` can run it without manual dependency installation.
+
 ## Dependencies
 
 Marimo manages package dependencies automatically through its package tab. You do not need to manually maintain `pyproject.toml` dependencies during development.

{marimo_dev-0.2.6 → marimo_dev-0.2.8}/README.md

@@ -1,4 +1,3 @@
-
 # marimo-dev
 
 Build Python packages from Marimo notebooks.
@@ -73,8 +72,19 @@ from .core import greet
 
 ## What gets exported
 
- 1. constants in setup cells
- 2. [self-contained functions and classes](https://docs.marimo.io/guides/reusing_functions/)
+1. **Constants in setup cells** — any assignment in a setup cell becomes a constant
+2. **Decorated functions and classes** — [self-contained functions and classes](https://docs.marimo.io/guides/reusing_functions/) with `@app.function` or `@app.class_definition`
+3. **Export-named cells** — name a cell `export` (or `export_something`) to export arbitrary code as a blob:
+
+```python
+@app.cell
+def export_main():
+    if __name__ == "__main__":
+        main()
+    return
+```
+
+This is useful for code that isn't a function or class, like `if __name__ == "__main__"` blocks.
 
 ## Hash pipe directives
 
@@ -130,6 +140,8 @@ skip_prefixes = ["XX_", "test_"]  # ignore these files
 
 ```bash
 md build              # build package from notebooks and make docs
+md bundle             # bundle into single file with PEP 723 dependencies
+md bundle app.py      # bundle to specific filename at project root
 md docs               # build the static docs (beta)
 md publish --test     # publish to Test PyPI
 md publish            # publish to PyPI
@@ -138,6 +150,25 @@ md nuke               # remove all build artifacts (dist, docs, src, temp*)
 ```
 *If you make a temp folder it will be explicitly removed when running `md nuke`*
 
+## Single-file applications
+
+Use `md bundle` to create a standalone Python file with [PEP 723](https://peps.python.org/pep-0723/) inline dependencies:
+
+```bash
+md bundle app.py
+uv run app.py
+```
+
+The generated file includes a dependency header that `uv` reads automatically:
+
+```python
+# /// script
+# dependencies = ["fasthtml", "uvicorn"]
+# ///
+```
+
+This lets you deploy a single `.py` file — anyone with `uv` can run it without manual dependency installation.
+
 ## Dependencies
 
 Marimo manages package dependencies automatically through its package tab. You do not need to manually maintain `pyproject.toml` dependencies during development.

{marimo_dev-0.2.6 → marimo_dev-0.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "marimo-dev"
-version = "0.2.6"
+version = "0.2.8"
 description = "Build and publish python packages from marimo notebooks"
 readme = "README.md"
 requires-python = ">=3.12"

{marimo_dev-0.2.6 → marimo_dev-0.2.8}/src/marimo_dev/__init__.py

@@ -1,5 +1,5 @@
 """Build and publish python packages from marimo notebooks"""
-__version__ = '0.2.6'
+__version__ = '0.2.8'
 __author__ = 'Deufel'
 from .core import Config, read_config, Kind, Param, Node
 from .read import inline_doc, parse_params, parse_hash_pipe, parse_class_params, parse_class_methods, parse_ret, src_with_decs, is_export, parse_import, parse_const, parse_export, parse_node, parse_file, read_meta, nb_name, scan

{marimo_dev-0.2.6 → marimo_dev-0.2.8}/src/marimo_dev/docs.py

@@ -108,7 +108,8 @@ def render_node(
     edit_btn = A(Button(Icon('code', size=16), "Edit", style=btn_style), href=f"{repo_url}/edit/master/{nb}", target="_blank", style=link_style) if repo_url and nb else None
     blame_btn = A(Button(Icon('info', size=16), "Blame", style=btn_style), href=f"{repo_url}/blame/master/{nb}#L{n.lineno}", target="_blank", style=link_style) if repo_url and nb and n.lineno else None
     history_btn = A(Button(Icon('calendar', size=16), "History", style=btn_style), href=f"{repo_url}/commits/master/{nb}", target="_blank", style=link_style) if repo_url and nb else None
-    issue_btn = A(Button(Icon('circle-x', size=16), "Issue", style=btn_style), href=f"{repo_url}/issues/new?title=Issue%20with%20{n.name}&body=Found%20in%20{nb}%23L{n.lineno}", target="_blank", style=link_style) if repo_url and nb else None
+    issue_btn = A(Button(Icon('circle-x', size=16), "Issue", style=btn_style), href=f"{repo_url}/issues/new?title=Issue%20with%20{n.name}&body={repo_url}/blob/master/{nb}%23L{n.lineno}", target="_blank", style=link_style) if repo_url and nb else None
+
     header = Div(
         Div(tag, full_name, style="display: flex; align-items: center;"),
         Div(copy_btn, source_btn, edit_btn, blame_btn, history_btn, issue_btn, style="display: flex; align-items: center; gap: 0.5rem;"),
@@ -165,6 +166,7 @@ def build_docs(
     (docs_path / "index.html").write_text(to_xml(render_index_page(meta, mods)))
     for mod_name, mod_nodes in mods:
         (docs_path / f"{mod_name}.html").write_text(to_xml(render_module_page(mod_name, mod_nodes, mod_names, meta, root)))
+    export_wasm(root)
     return f"Generated index + {len(mods)} module pages in {docs_path}"
 
 def export_wasm(root='.'):