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 { langs } from "@uiw/codemirror-extensions-langs";
import ReactCodeMirror, {
EditorView,
keymap,
Prec,
type ReactCodeMirrorRef,
} from "@uiw/react-codemirror";
import {
HelpCircleIcon,
LayersIcon,
PlayIcon,
SkipForwardIcon,
TrashIcon,
} from "lucide-react";
import React, { memo } from "react";
import { cn } from "@/utils/cn";
import { Button } from "../ui/button";
import { Tooltip } from "../ui/tooltip";
import "./debugger-code.css";
import { useKeydownOnElement } from "@/hooks/useHotkey";
import { useInputHistory } from "@/hooks/useInputHistory";
interface Props {
code: string;
onSubmit: (code: string) => void;
}
export const Debugger: React.FC<Props> = ({ code, onSubmit }) => {
return (
<div className="flex flex-col w-full rounded-b overflow-hidden">
<DebuggerOutput code={code} />
<DebuggerInput onSubmit={onSubmit} />
<DebuggerControls onSubmit={onSubmit} />
</div>
);
};
const DebuggerOutput: React.FC<{
code: string;
}> = memo((props) => {
const ref = React.useRef<ReactCodeMirrorRef>({});
return (
<ReactCodeMirror
minHeight="200px"
maxHeight="200px"
ref={ref}
theme="dark"
value={props.code}
className={"*:outline-hidden [&>.cm-editor]:pr-0 overflow-hidden dark"}
readOnly={true}
editable={false}
basicSetup={{
lineNumbers: false,
}}
extensions={[
langs.sh(),
EditorView.updateListener.of((update) => {
if (update.docChanged) {
ref.current.view?.dispatch({
selection: {
anchor: update.state.doc.length,
head: update.state.doc.length,
},
scrollIntoView: true,
});
}
}),
]}
/>
);
});
DebuggerOutput.displayName = "DebuggerOutput";
const DebuggerInput: React.FC<{
onSubmit: (code: string) => void;
}> = ({ onSubmit }) => {
const [value, setValue] = React.useState("");
const ref = React.useRef<HTMLDivElement>(null);
const { navigateUp, navigateDown, addToHistory } = useInputHistory({
value,
setValue,
});
// Capture some events for command history navigation
useKeydownOnElement(ref, {
ArrowUp: navigateUp,
ArrowDown: navigateDown,
});
return (
<div ref={ref}>
<ReactCodeMirror
minHeight="18px"
theme="dark"
className={
"debugger-input *:outline-hidden cm-focused [&>.cm-editor]:pr-0 overflow-hidden dark border-t-4"
}
value={value}
autoFocus={true}
basicSetup={{
lineNumbers: false,
}}
extensions={[
langs.py(),
Prec.highest(
keymap.of([
{
key: "Enter",
preventDefault: true,
stopPropagation: true,
run: () => {
const v = value.trim().replaceAll("\n", "\\n");
if (!v) {
return true;
}
addToHistory(v);
onSubmit(v);
setValue("");
return true;
},
},
{
key: "Shift-Enter",
preventDefault: true,
stopPropagation: true,
run: (view: EditorView) => {
// Insert newline and move cursor to end of line
view.dispatch({
changes: {
from: view.state.selection.main.to,
insert: "\n",
},
});
return true;
},
},
]),
),
]}
onChange={(value) => setValue(value)}
/>
</div>
);
};
export const DebuggerControls: React.FC<{
onSubmit: (code: string) => void;
onClear?: () => void;
}> = ({ onSubmit, onClear }) => {
const buttonClasses = cn(
"m-0 w-9 h-8 bg-(--slate-2) text-(--slate-11) hover:text-(--blue-11) rounded-none hover:bg-(--sky-3) hover:border-(--blue-8)",
"first:rounded-l-lg first:border-l border-t border-b hover:border",
"last:rounded-r-lg last:border-r",
);
const iconClasses = "w-5 h-5";
return (
<div className="flex">
<Tooltip content="Next line">
<Button
aria-label="Next line"
variant="text"
size="icon"
data-testid="debugger-next-button"
className={buttonClasses}
onClick={() => onSubmit("n")}
>
<SkipForwardIcon fontSize={36} className={iconClasses} />
</Button>
</Tooltip>
<Tooltip content="Continue execution">
<Button
aria-label="Continue execution"
variant="text"
size="icon"
data-testid="debugger-continue-button"
onClick={() => onSubmit("c")}
className={cn(
buttonClasses,
"text-(--grass-11) hover:text-(--grass-11) hover:bg-(--grass-3) hover:border-(--grass-8)",
)}
>
<PlayIcon fontSize={36} className={iconClasses} />
</Button>
</Tooltip>
<Tooltip content="Print stack trace">
<Button
aria-label="Print stack trace"
variant="text"
size="icon"
data-testid="debugger-stack-button"
className={buttonClasses}
onClick={() => onSubmit("bt")}
>
<LayersIcon fontSize={36} className={iconClasses} />
</Button>
</Tooltip>
<Tooltip content="Help">
<Button
aria-label="Debugger help"
variant="text"
size="icon"
data-testid="debugger-help-button"
className={buttonClasses}
onClick={() => onSubmit("help")}
>
<HelpCircleIcon fontSize={36} className={iconClasses} />
</Button>
</Tooltip>
{onClear && (
<Tooltip content="Quit and clear">
<Button
aria-label="Quit and clear debugger"
variant="text"
size="icon"
data-testid="debugger-clear-button"
className={cn(
buttonClasses,
"text-(--red-11) hover:text-(--red-11) hover:bg-(--red-2) hover:border-(--red-8)",
)}
onClick={() => {
// Quit the debugger (`q`) before tearing down the console, so
// the stdin response targets the still-present pdb prompt.
onSubmit("q");
onClear();
}}
>
<TrashIcon fontSize={36} className={iconClasses} />
</Button>
</Tooltip>
)}
</div>
);
};