:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import type { NotebookComponentRunStatus } from 'lib/components/MarkdownNotebook'
import type { NotebookComponentBlockNode, NotebookComponentProps } from 'lib/components/MarkdownNotebook/types'
import { resolveNotebookComponentRunStatus } from './markdownNotebookRunStatus'
import type { NotebookNodeRunTerminalStatus, NotebookStaleReason } from './notebookNodeStalenessLogic'
describe('markdownNotebookRunStatus', () => {
const sqlCell = (props: NotebookComponentProps = {}, tagName = 'SQLV2'): NotebookComponentBlockNode => ({
id: 'block-fingerprint',
type: 'component',
tagName,
props,
})
const cases: {
label: string
node: NotebookComponentBlockNode
staleNodeIds?: Record<string, NotebookStaleReason>
nodeRunStatuses?: Record<string, NotebookNodeRunTerminalStatus>
expected: NotebookComponentRunStatus
}[] = [
{ label: 'a block that cannot run', node: sqlCell({}, 'Query'), expected: 'idle' },
{ label: 'a cell that has never run', node: sqlCell(), expected: 'idle' },
{
label: 'a successful run',
node: sqlCell({ nodeId: 'node-1' }),
nodeRunStatuses: { 'node-1': 'done' },
expected: 'success',
},
{
label: 'a failed run',
node: sqlCell({ nodeId: 'node-1' }),
nodeRunStatuses: { 'node-1': 'failed' },
expected: 'error',
},
{
label: 'an interrupted run',
node: sqlCell({ nodeId: 'node-1' }),
nodeRunStatuses: { 'node-1': 'interrupted' },
expected: 'error',
},
{
label: 'a cell an upstream re-run outdated',
node: sqlCell({ nodeId: 'node-1' }),
staleNodeIds: { 'node-1': 'upstream' },
nodeRunStatuses: { 'node-1': 'done' },
expected: 'stale',
},
{
// The failure, not the staleness, is what the user has to act on.
label: 'a stale cell whose last run failed',
node: sqlCell({ nodeId: 'node-1' }),
staleNodeIds: { 'node-1': 'upstream' },
nodeRunStatuses: { 'node-1': 'failed' },
expected: 'error',
},
{
// The session's run record is gone after a reload, so the cell's own record stands in.
label: 'a reloaded cell that completed',
node: sqlCell({ nodeId: 'node-1', result: { row_count: 1 }, runStatus: 'done' }),
expected: 'success',
},
{
// An interrupted run persists a partial result, so the result can't imply success.
label: 'a reloaded cell that was interrupted mid-run',
node: sqlCell({ nodeId: 'node-1', result: { stdout: 'partial' }, runStatus: 'interrupted' }),
expected: 'error',
},
{
label: 'a reloaded cell that never ran',
node: sqlCell({ nodeId: 'node-1', result: null, runStatus: null }),
expected: 'idle',
},
{
// Cells written before the outcome was persisted, and hand-authored markdown.
label: 'a cell carrying an unrecognized persisted outcome',
node: sqlCell({ nodeId: 'node-1', result: { row_count: 1 }, runStatus: 'whatever' }),
expected: 'idle',
},
{
label: 'a cell that has not pinned an id yet, by its block id',
node: sqlCell(),
nodeRunStatuses: { 'block-fingerprint': 'done' },
expected: 'success',
},
{
label: 'a cell that pinned an id, by that id rather than its block id',
node: sqlCell({ nodeId: 'node-1' }),
nodeRunStatuses: { 'block-fingerprint': 'done' },
expected: 'idle',
},
]
it.each(cases)('resolves $label', ({ node, staleNodeIds, nodeRunStatuses, expected }) => {
expect(resolveNotebookComponentRunStatus(node, staleNodeIds ?? {}, nodeRunStatuses ?? {})).toBe(expected)
})
})