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
/* Copyright 2026 Marimo. All rights reserved. */
import { assertExists } from "@/utils/assertExists";
import { jsonParseWithSpecialChar } from "@/utils/json/json-parser";
import { Objects } from "@/utils/objects";
import { UIElementId } from "../cells/ids";
import { isIslands } from "../islands/utils";
import { PyodideRouter } from "../wasm/router";
import { isWasm } from "../wasm/utils";
import type { UIElementRegistry } from "./uiregistry";
/**
* Parse an attribute value as JSON.
*/
export function parseAttrValue<T>(value: string | undefined): T {
return jsonParseWithSpecialChar(value ?? "");
}
export function parseDataset(element: HTMLElement): Record<string, unknown> {
return Objects.mapValues(element.dataset, (value) =>
typeof value === "string" ? parseAttrValue(value) : value,
);
}
/**
* Parse the initial value.
* It will first check if the parent element is a <marimo-ui-element/> with an object-id that
* exist in the UI registry.
* And otherwise fallback to the data-initial-value attribute.
*/
export function parseInitialValue<T>(
element: HTMLElement,
registry: UIElementRegistry,
): T {
// If parent is a <marimo-ui-element/> and has object-id, use that as the initialize the value
const objectId = element.parentElement
? UIElementId.parse(element.parentElement)
: undefined;
if (objectId && registry.has(objectId)) {
return registry.lookupValue(objectId) as T;
}
// Otherwise use the data-initial-value attribute
return parseAttrValue(element.dataset.initialValue);
}
/**
* Serialize the initial value.
*/
export function serializeInitialValue(value: unknown) {
return JSON.stringify(value);
}
export function getFilenameFromDOM() {
// If running in Islands, just return the window title.
if (isIslands()) {
return document.title || null;
}
// If we are running in WASM, we can get the filename from the URL
if (isWasm()) {
const filename = PyodideRouter.getFilename();
if (filename) {
return filename;
}
}
// TODO: Remove this once downstream usage of `getFilenameFromDOM` is removed
// such that is it not called before mounting the app.
const filenameTag = document.querySelector("marimo-filename");
if (import.meta.env.MODE === "test" && !filenameTag) {
return null;
}
assertExists(filenameTag, "marimo-filename tag not found");
const name = filenameTag.innerHTML;
return name.length === 0 ? null : name;
}