A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
import textwrap
import xml.etree.ElementTree as etree
from typing import Any, Dict, List, Union, cast
import lzstring
from pymdownx.blocks import BlocksExtension # type: ignore
from pymdownx.blocks.block import (
Block,
type_boolean,
type_string,
type_string_in,
) # type: ignore
class BaseMarimoBlock(Block):
"""Base class for marimo embed blocks"""
OPTIONS: Dict[str, List[Union[str, Any]]] = {
"size": [
"medium",
type_string_in(["small", "medium", "large", "xlarge", "xxlarge"]),
],
"mode": ["edit", type_string_in(["read", "edit"])],
"show-chrome": [False, type_boolean],
}
def on_create(self, parent: etree.Element) -> etree.Element:
container = etree.SubElement(parent, "div")
container.set("class", "marimo-embed-container")
return container
def on_add(self, block: etree.Element) -> etree.Element:
return block
def _create_iframe(self, block: etree.Element, url: str) -> None:
# Clear existing content
block.text = None
for child in block:
block.remove(child)
# Add iframe
size: str = cast(str, self.options["size"])
iframe = etree.SubElement(block, "iframe")
iframe.set("class", f"demo {size}")
iframe.set("src", url)
iframe.set(
"allow",
"camera; geolocation; microphone; fullscreen; autoplay; encrypted-media; picture-in-picture; clipboard-read; clipboard-write",
)
iframe.set("width", "100%")
iframe.set("height", "400px")
iframe.set("frameborder", "0")
iframe.set("style", "display: block; margin: 0 auto;")
def on_markdown(self) -> str:
return "raw"
class MarimoEmbedBlock(BaseMarimoBlock):
NAME: str = "marimo-embed"
OPTIONS: Dict[str, List[Union[str, Any]]] = {
**BaseMarimoBlock.OPTIONS,
"app_width": ["medium", type_string_in(["medium", "full", "compact"])],
}
def on_end(self, block: etree.Element) -> None:
code = block.text.strip() if block.text else ""
if code.startswith("```python"):
code = code[9:]
code = code[:-3]
code = textwrap.dedent(code)
app_width: str = cast(str, self.options["app_width"])
mode: str = cast(str, self.options["mode"])
show_chrome: bool = cast(bool, self.options["show-chrome"])
url = create_marimo_wasm_url(
code=create_marimo_wasm_code(code=code, app_width=app_width),
mode=mode,
show_chrome=show_chrome,
)
self._create_iframe(block, url)
class MarimoEmbedFileBlock(BaseMarimoBlock):
NAME: str = "marimo-embed-file"
OPTIONS: Dict[str, List[Union[str, Any]]] = {
**BaseMarimoBlock.OPTIONS,
"filepath": ["", type_string],
"show_source": ["true", type_string_in(["true", "false"])],
}
def on_end(self, block: etree.Element) -> None:
filepath = cast(str, self.options["filepath"])
if not filepath:
raise ValueError("File path must be provided")
# Read from project root
try:
with open(filepath, "r", encoding="utf-8") as f:
code = f.read()
except FileNotFoundError:
raise ValueError(f"File not found: {filepath}")
mode: str = cast(str, self.options["mode"])
show_chrome: bool = cast(bool, self.options["show-chrome"])
url = create_marimo_wasm_url(
code=code, mode=mode, show_chrome=show_chrome
)
self._create_iframe(block, url)
# Add source code section if enabled
show_source: str = cast(str, self.options.get("show_source", "true"))
if show_source == "true":
details = etree.SubElement(block, "details")
summary = etree.SubElement(details, "summary")
summary.text = f"Source code for `{filepath}`"
# TODO: figure out syntax highlighting
# md_text = f"\n\n```python\n{code}\n```\n\n"
# result = self.md.htmlStash.store(self.md.convert(md_text))
# container.text = result
copy_paste_container = etree.SubElement(details, "p")
copy_paste_container.text = "Tip: paste this code into an empty cell, and the marimo editor will create cells for you"
code_container = etree.SubElement(details, "pre")
code_container.set("class", "marimo-source-code")
code_block = etree.SubElement(code_container, "code")
code_block.set("class", "language-python")
code_block.text = code
_lz = lzstring.LZString()
def create_marimo_wasm_code(
*,
code: str,
app_width: str = "medium",
) -> str:
header = "\n".join(
[
"import marimo",
f'app = marimo.App(width="{app_width}")',
"",
]
)
mo_cell = "\n".join(
[
"",
"@app.cell",
"def __():",
" import marimo as mo",
" return",
]
)
mo_at_bottom = "with app.setup:" in code
if mo_at_bottom:
return header + code + mo_cell
return header + mo_cell + code
def create_marimo_wasm_url(
code: str, mode: str = "edit", show_chrome: bool = False
) -> str:
compressed = _lz.compressToEncodedURIComponent(code)
return f"https://marimo.app/?embed=true&mode={mode}&show-chrome={'true' if show_chrome else 'false'}#code/{compressed}"
class MarimoBlocksExtension(BlocksExtension):
def extendMarkdownBlocks(self, md: Any, block_mgr: Any) -> None:
block_mgr.register(MarimoEmbedBlock, self.getConfigs())
block_mgr.register(MarimoEmbedFileBlock, self.getConfigs())
def makeExtension(*args: Any, **kwargs: Any) -> MarimoBlocksExtension:
return MarimoBlocksExtension(*args, **kwargs)