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 {
FunctionArg,
FunctionCall,
Literal,
VariableDeclaration,
} from "../poet";
describe("Python Poet", () => {
describe("Variable Declaration", () => {
it("should create a variable declaration", () => {
const declaration = new VariableDeclaration("x", "42");
expect(declaration.toCode()).toBe("x = 42");
});
it("should handle nested code objects", () => {
const inner = new VariableDeclaration("y", "42");
const declaration = new VariableDeclaration("x", inner);
expect(declaration.toCode()).toBe("x = y = 42");
});
});
describe("Function Call", () => {
it("should create a function call", () => {
const call = new FunctionCall("print", [
new FunctionArg("message", "'Hello, world!'"),
]);
expect(call.toCode()).toBe("print(message='Hello, world!')");
});
it("should create a function call with a literal", () => {
const call = new FunctionCall("print", {
message: new Literal("Hello, world!"),
});
expect(call.toCode()).toBe("print(message='Hello, world!')");
});
it("should add arguments", () => {
const call = new FunctionCall("sum", [new FunctionArg("a", "1")]).addArg(
new FunctionArg("b", "2"),
);
expect(call.toCode()).toBe("sum(a=1, b=2)");
});
it("should chain method calls", () => {
const call = new FunctionCall("df", []).chain("head", [
new FunctionArg("n", "5"),
]);
expect(call.toCode()).toBe("df().head(n=5)");
});
});
describe("Literal", () => {
it("should convert boolean to True/False", () => {
const literal = new Literal(true);
expect(literal.toCode()).toBe("True");
});
it("should convert undefined", () => {
const literal = new Literal(undefined);
expect(literal.toCode()).toBe("");
// When removeUndefined is false, undefined is converted to None
const literal2 = new Literal(undefined, { removeUndefined: false });
expect(literal2.toCode()).toBe("None");
});
it("should convert null to None", () => {
const literal = new Literal(null);
expect(literal.toCode()).toBe("None");
// When removeNull is true, null is converted to empty string
const literal2 = new Literal(null, { removeNull: true });
expect(literal2.toCode()).toBe("");
});
it("should convert empty array to empty list", () => {
const literal = new Literal([]);
expect(literal.toCode()).toBe("[]");
});
it("should convert array to list", () => {
const literal = new Literal([1, 2, 3]);
expect(literal.toCode()).toBe(`[
1,
2,
3
]`);
});
it("should replace null values with None", () => {
const literal = new Literal([1, null, 3]);
expect(literal.toCode()).toBe(`[
1,
None,
3
]`);
});
it("should remove undefined values from list", () => {
const literal = new Literal([1, undefined, 3]);
expect(literal.toCode()).toBe(`[
1,
3
]`);
});
it("should convert nested array to nested list", () => {
const literal = new Literal([1, [2, null, 3, undefined, "5"], 4]);
expect(literal.toCode()).toBe(`[
1,
[
2,
None,
3,
'5'
],
4
]`);
});
it("should convert empty object to empty dict", () => {
const literal = new Literal({});
expect(literal.toCode()).toBe("{}");
});
it("should convert object to dict", () => {
const literal = new Literal({ a: 1, b: 2 });
expect(literal.toCode()).toBe(`{
'a': 1,
'b': 2
}`);
});
it("should convert nested object to nested dict", () => {
const literal = new Literal({
a: 1,
b: { c: 2, d: null, e: undefined },
f: [1, 2, 3],
});
expect(literal.toCode()).toBe(`{
'a': 1,
'b': {
'c': 2,
'd': None
},
'f': [
1,
2,
3
]
}`);
});
});
describe("Altair Charts", () => {
it("should create a basic bar chart", () => {
const chart = new FunctionCall("alt.Chart", [
new FunctionArg("data", "df"),
])
.chain("mark_bar", [])
.chain("encode", {
x: new Literal("category:N"),
y: new Literal("value:Q"),
});
expect(chart.toCode()).toMatchInlineSnapshot(
`"alt.Chart(data=df).mark_bar().encode(x='category:N', y='value:Q')"`,
);
});
it("should create a scatter plot with color and tooltip", () => {
const chart = new FunctionCall(
"alt.Chart",
[new FunctionArg("data", "df")],
true,
)
.chain("mark_circle", [])
.chain("encode", [
new FunctionArg("x", "'x:Q'"),
new FunctionArg("y", "'y:Q'"),
new FunctionArg("color", "'category:N'"),
new FunctionArg("tooltip", "['category:N', 'x:Q', 'y:Q', 'size:Q']"),
])
.chain("interactive", []);
expect(chart.toCode()).toMatchInlineSnapshot(
`
"alt.Chart(data=df)
.mark_circle()
.encode(
x='x:Q',
y='y:Q',
color='category:N',
tooltip=['category:N', 'x:Q', 'y:Q', 'size:Q']
)
.interactive()"
`,
);
});
it("should create a layered chart", () => {
const points = new FunctionCall(
"alt.Chart",
[new FunctionArg("data", "df")],
true,
)
.chain("mark_point", [])
.chain("encode", [
new FunctionArg("x", "'x:Q'"),
new FunctionArg("y", "'y:Q'"),
]);
const line = new FunctionCall(
"alt.Chart",
[new FunctionArg("data", "df")],
true,
)
.chain("mark_line", [])
.chain("encode", [
new FunctionArg("x", "'x:Q'"),
new FunctionArg("y", "'y:Q'"),
]);
const layered = new FunctionCall("alt.layer", [points, line], true).chain(
"properties",
[new FunctionArg("title", "'Layered Chart'")],
);
expect(layered.toCode()).toMatchInlineSnapshot(
`
"alt.layer(
alt.Chart(data=df)
.mark_point()
.encode(
x='x:Q',
y='y:Q'
),
alt.Chart(data=df)
.mark_line()
.encode(
x='x:Q',
y='y:Q'
)
)
.properties(title='Layered Chart')"
`,
);
});
it("should create a faceted chart", () => {
const chart = new FunctionCall(
"alt.Chart",
[new FunctionArg("data", "df")],
true,
)
.chain("mark_bar", [])
.chain("encode", [
new FunctionArg("x", "'category:N'"),
new FunctionArg("y", "'value:Q'"),
new FunctionArg("color", "'category:N'"),
new FunctionArg("row", "'group:N'"),
])
.chain("properties", [
new FunctionArg("title", "'Faceted Bar Chart'"),
new FunctionArg("height", "150"),
]);
expect(chart.toCode()).toMatchInlineSnapshot(`
"alt.Chart(data=df)
.mark_bar()
.encode(
x='category:N',
y='value:Q',
color='category:N',
row='group:N'
)
.properties(
title='Faceted Bar Chart',
height=150
)"
`);
});
});
});