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 { describe, expect, it } from "vitest";
import {
containsMangledLocal,
splitMangledLocals,
unmangleLocal,
} from "../local-variables";
describe("unmangleLocal", () => {
it("extracts the cell id and original name", () => {
expect(unmangleLocal("_cell_Hbol_a")).toEqual({
cellId: "Hbol",
name: "_a",
});
});
it("handles names with multiple underscore segments", () => {
expect(unmangleLocal("_cell_Hbol_a_b")).toEqual({
cellId: "Hbol",
name: "_a_b",
});
});
it("returns null for non-mangled strings", () => {
expect(unmangleLocal("just_a_variable")).toBeNull();
expect(unmangleLocal("_private")).toBeNull();
});
it("handles the single-underscore local", () => {
// `_` is a valid local name (variables.py:62-63), mangling to
// `_cell_<id>_` with no trailing suffix.
expect(unmangleLocal("_cell_Hbol_")).toEqual({
cellId: "Hbol",
name: "_",
});
});
it("handles UUID-style cell ids", () => {
// External / VSCode notebooks use `external_prefix()` which is a
// `uuid4()` (hyphenated).
expect(
unmangleLocal("_cell_c9bf9e57-1685-4c89-bafb-ff5af830be8a_a"),
).toEqual({
cellId: "c9bf9e57-1685-4c89-bafb-ff5af830be8a",
name: "_a",
});
});
it("does not match marimo cell file paths", () => {
// The compiled cell file is `__marimo__cell_<id>_.py` (two leading
// underscores, trailing `_` with no name); it must not be confused with a
// mangled local.
expect(unmangleLocal("__marimo__cell_Hbol_.py")).toBeNull();
expect(unmangleLocal("/tmp/marimo_42/__marimo__cell_Hbol_.py")).toBeNull();
});
});
describe("splitMangledLocals", () => {
it("returns a single text segment when nothing matches", () => {
expect(splitMangledLocals("plain text")).toEqual(["plain text"]);
});
it("splits a NameError message", () => {
expect(splitMangledLocals("name '_cell_Hbol_a' is not defined")).toEqual([
"name '",
{ cellId: "Hbol", name: "_a" },
"' is not defined",
]);
});
it("handles multiple mangled names in one string", () => {
expect(splitMangledLocals("_cell_AAAA_x and _cell_BBBB_y")).toEqual([
{ cellId: "AAAA", name: "_x" },
" and ",
{ cellId: "BBBB", name: "_y" },
]);
});
it("leaves the cell file path alone", () => {
const path = "/tmp/marimo_42/__marimo__cell_Hbol_.py";
expect(splitMangledLocals(path)).toEqual([path]);
});
it("ignores `_cell_...` substrings preceded by `_`", () => {
// Mirrors `(?<!_)` in `variables.py`: a leading `_` (e.g. inside
// `__marimo__cell_<id>_<...>`) means this is not a mangle the compiler
// produced, so we must not demangle it.
const text = "see __marimo__cell_Hbol_a for details";
expect(splitMangledLocals(text)).toEqual([text]);
});
it("splits a UUID-style cell id", () => {
expect(
splitMangledLocals(
"name '_cell_c9bf9e57-1685-4c89-bafb-ff5af830be8a_a' is not defined",
),
).toEqual([
"name '",
{
cellId: "c9bf9e57-1685-4c89-bafb-ff5af830be8a",
name: "_a",
},
"' is not defined",
]);
});
it("splits the single-underscore local", () => {
expect(splitMangledLocals("name '_cell_Hbol_' is not defined")).toEqual([
"name '",
{ cellId: "Hbol", name: "_" },
"' is not defined",
]);
});
});
describe("containsMangledLocal", () => {
it("detects mangled names", () => {
expect(containsMangledLocal("name '_cell_Hbol_a' is not defined")).toBe(
true,
);
});
it("ignores the cell file path", () => {
expect(containsMangledLocal("/tmp/marimo_42/__marimo__cell_Hbol_.py")).toBe(
false,
);
});
it("ignores `_cell_...` substrings preceded by `_`", () => {
expect(containsMangledLocal("see __marimo__cell_Hbol_a")).toBe(false);
});
});