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 type {
CompletionContext,
CompletionResult,
CompletionSource,
} from "@codemirror/autocomplete";
import { type CellId, HTMLCellId } from "@/core/cells/ids";
import { documentationAtom } from "@/core/documentation/state";
import { store } from "@/core/state/jotai";
import { Logger } from "../../../utils/Logger";
import { AUTOCOMPLETER, Autocompleter } from "./Autocompleter";
import { asSignatureHint, setSignatureHintEffect } from "./signature-hint";
/**
* Completion source for Python, using Jedi.
*/
export const pythonCompletionSource: CompletionSource = async (
context: CompletionContext,
): Promise<CompletionResult | null> => {
const query = context.state.doc.sliceString(0, context.pos);
const element = document.activeElement;
let cellId: CellId | null = null;
if (element !== null) {
const cellContainer = HTMLCellId.findElement(element);
if (cellContainer !== null) {
cellId = HTMLCellId.parse(cellContainer.id);
}
}
if (cellId === null) {
Logger.error("Failed to find active cell.");
return null;
}
const result = await AUTOCOMPLETER.request({
document: query,
cellId: cellId,
});
if (!result) {
context.view?.dispatch({ effects: setSignatureHintEffect.of(null) });
return null;
}
// If it is a tooltip (e.g. a signature after `(` or `,`), show it as a
// Tooltip instead of a completion.
const tooltip = Autocompleter.asHoverTooltip({
position: context.pos,
message: result,
limitToType: "tooltip",
});
if (tooltip) {
store.set(documentationAtom, {
documentation: tooltip.html ?? null,
});
}
// Surface the signature as a floating hint near the cursor (the LSP path has
// its own signature help), and clear any stale hint when we instead have a
// real completion list.
context.view?.dispatch({
effects: setSignatureHintEffect.of(
tooltip ? asSignatureHint(tooltip) : null,
),
});
if (tooltip) {
return null;
}
return Autocompleter.asCompletionResult(context.pos, result);
};