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 { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { getSerializedLayout } from "@/core/layout/layout";
import { initialLayoutState, layoutStateAtom } from "@/core/layout/state";
import { kioskModeAtom } from "@/core/mode";
import { connectionAtom } from "@/core/network/connection";
import { store } from "@/core/state/jotai";
import { isStaticNotebook } from "@/core/static/static-state";
import { ConnectionState } from "@/core/session/types";
import { pairConfigAtom } from "@/core/config/pair";
import { PAIR_CONFIG } from "./fixtures/pair-config";
import { mount, visibleForTesting } from "../mount";
// Mock React DOM
vi.mock("react-dom/client", () => ({
createRoot: vi.fn(() => ({
render: vi.fn(),
})),
}));
// Mock static state
vi.mock("@/core/static/static-state", () => ({
getStaticModelNotifications: vi.fn(() => undefined),
getStaticVirtualFiles: vi.fn(() => ({})),
isStaticNotebook: vi.fn(() => false),
}));
// Mock other side-effect modules
vi.mock("@/core/vscode/vscode-bindings", () => ({
maybeRegisterVSCodeBindings: vi.fn(),
}));
vi.mock("@/plugins/plugins", () => ({
initializePlugins: vi.fn(),
}));
vi.mock("@/core/network/auth", () => ({
cleanupAuthQueryParams: vi.fn(),
}));
vi.mock("@/utils/vitals", () => ({
reportVitals: vi.fn(),
}));
// Mock preloadPage
vi.mock("@/core/MarimoApp", () => ({
MarimoApp: () => null,
preloadPage: vi.fn(),
}));
describe("mount", () => {
const mockElement = document.createElement("div");
beforeEach(() => {
visibleForTesting.reset();
window.history.replaceState({}, "", "/");
vi.mocked(isStaticNotebook).mockReturnValue(false);
store.set(layoutStateAtom, initialLayoutState());
store.set(kioskModeAtom, false);
// Reset connection atom to initial state
store.set(connectionAtom, { state: ConnectionState.NOT_STARTED });
});
afterEach(() => {
vi.clearAllMocks();
});
const baseOptions = {
filename: "test.py",
code: "",
version: "0.0.1",
mode: "edit" as const,
config: {},
configOverrides: {},
appConfig: {},
view: { showAppCode: true },
serverToken: "",
};
const mountRead = (options: Record<string, unknown> = {}) =>
mount(
{ ...baseOptions, mode: "read", runtimeConfig: [], ...options },
mockElement,
);
it("hydrates the server's Pair configuration", () => {
const error = mountRead({ pairConfig: PAIR_CONFIG });
expect(error).toBeUndefined();
expect(store.get(pairConfigAtom)).toEqual(PAIR_CONFIG);
});
it("clears Pair configuration when the server omits it", () => {
store.set(pairConfigAtom, PAIR_CONFIG);
const error = mountRead();
expect(error).toBeUndefined();
expect(store.get(pairConfigAtom)).toBeUndefined();
});
describe("connection state initialization", () => {
it("should set connection to CONNECTING when runtimeConfig has lazy=false", () => {
mount(
{
...baseOptions,
runtimeConfig: [{ url: "http://localhost:8080", lazy: false }],
},
mockElement,
);
const connection = store.get(connectionAtom);
expect(connection.state).toBe(ConnectionState.CONNECTING);
});
it("should keep connection as NOT_STARTED when runtimeConfig has lazy=true", () => {
mount(
{
...baseOptions,
runtimeConfig: [{ url: "http://localhost:8080", lazy: true }],
},
mockElement,
);
const connection = store.get(connectionAtom);
expect(connection.state).toBe(ConnectionState.NOT_STARTED);
});
it("should keep connection as NOT_STARTED when no runtimeConfig is provided", () => {
mount(
{
...baseOptions,
runtimeConfig: [],
},
mockElement,
);
const connection = store.get(connectionAtom);
expect(connection.state).toBe(ConnectionState.NOT_STARTED);
});
it("should keep connection as NOT_STARTED for static notebooks even with lazy=false", () => {
vi.mocked(isStaticNotebook).mockReturnValue(true);
// Reset mount state to allow another mount
visibleForTesting.reset();
mount(
{
...baseOptions,
runtimeConfig: [{ url: "http://localhost:8080", lazy: false }],
},
mockElement,
);
const connection = store.get(connectionAtom);
expect(connection.state).toBe(ConnectionState.NOT_STARTED);
});
});
it("hydrates the layout embedded in the mount config", () => {
const layout = {
type: "slides",
data: {
deck: { transition: "fade", verticalAlign: "center" },
},
};
const error = mountRead({ layout });
expect(error).toBeUndefined();
const layoutState = store.get(layoutStateAtom);
expect(layoutState.selectedLayout).toBe("slides");
expect(getSerializedLayout()).toEqual({
type: "slides",
data: {
cells: [],
deck: { transition: "fade", verticalAlign: "center" },
},
});
});
it("uses vertical layout for malformed mount data", () => {
const error = mountRead({ layout: { data: {} } });
expect(error).toBeUndefined();
expect(store.get(layoutStateAtom)).toEqual(initialLayoutState());
});
it("starts kiosk clients in kiosk mode", () => {
window.history.replaceState({}, "", "/?kiosk=true");
const error = mountRead();
expect(error).toBeUndefined();
expect(store.get(kioskModeAtom)).toBe(true);
});
});