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.
"""Check scratch ownership and cleanup without a running host."""
from __future__ import annotations
import json
from contextlib import asynccontextmanager
from types import SimpleNamespace
from typing import Any
import httpx
import pytest
from conftest import scratch
from contract import Frame, Host
@asynccontextmanager
async def scratch_probe(*, root="/tmp", **overrides: Any):
config = SimpleNamespace(stash=pytest.Stash())
project = {
"id": "p1",
"name": "scratch",
"root": root,
"status": "indexed",
"message": None,
"operations": ["notebook.create"],
}
existing = {
"id": "existing",
"project_id": "p1",
"path": "existing.py",
"name": "existing.py",
"operations": ["notebook.delete"],
"updated_at": None,
}
catalog = [
Frame(event=kind, data=json.dumps({kind: value}))
for kind, value in (
("host", {"operations": ["notebook.create", "notebook.delete"]}),
("project", project),
("notebook", existing),
)
]
requests = []
def respond(request):
requests.append((request.method, request.url.path))
if request.method == "POST":
body = json.loads(request.content)
return httpx.Response(
201,
json={
**existing,
"id": "new",
"path": body.get("path"),
"name": body.get("name", body.get("path")),
**overrides,
},
)
assert request.method == "DELETE"
return httpx.Response(204)
async with httpx.AsyncClient(
base_url="http://127.0.0.1/", transport=httpx.MockTransport(respond)
) as client:
host = Host(client, timeout=1)
def create():
return scratch.__wrapped__(host, catalog, config)
yield create, requests
@pytest.mark.parametrize(
"overrides",
[
{"project_id": "wrong"},
{"path": "wrong.py"},
{"root": None, "name": "wrong.py"},
],
)
async def test_invalid_create_metadata_is_cleaned_up(overrides):
async with scratch_probe(**overrides) as (
create,
requests,
):
with pytest.raises(AssertionError):
await anext(create())
assert requests == [
("POST", "/notebooks"),
("DELETE", "/notebooks/new"),
]
async def test_existing_notebook_is_never_deleted():
async with scratch_probe(id="existing") as (
create,
requests,
):
with pytest.raises(AssertionError, match="existing notebook"):
await anext(create())
assert requests == [("POST", "/notebooks")]
async def test_undeletable_notebook_skips_remaining_scratch_checks():
async with scratch_probe(
operations=["notebook.edit", "runtime.start"],
) as (create, requests):
for _ in range(2):
with pytest.raises(
pytest.skip.Exception, match=r"'new'.*notebook\.delete"
):
await anext(create())
assert requests == [("POST", "/notebooks")]
async def test_scratch_is_deleted_after_use():
async with scratch_probe() as (create, requests):
fixture = create()
assert (await anext(fixture))["id"] == "new"
assert requests == [("POST", "/notebooks")]
await fixture.aclose()
assert requests == [
("POST", "/notebooks"),
("DELETE", "/notebooks/new"),
]