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.
"""The cache commands act on the store the configuration picks."""
from __future__ import annotations
from typing import TYPE_CHECKING
from click.testing import CliRunner
from marimo._cli.cli import main
from tests._cli.test_cli_cache import NOTEBOOK, make_cache_dir
if TYPE_CHECKING:
from pathlib import Path
import pytest
from marimo._save.stores import Store
def configure_store(monkeypatch: pytest.MonkeyPatch, store_dir: Path) -> None:
"""Configure `store_dir` as the cache store, as marimo.toml would."""
from marimo._save.stores.file import FileStore
configure(monkeypatch, FileStore(save_path=str(store_dir)))
def configure(monkeypatch: pytest.MonkeyPatch, store: Store) -> None:
from marimo._save import stores
monkeypatch.setattr(
stores,
"configured_cache_store",
lambda current_path=None: store, # noqa: ARG005
)
def test_dir_prints_the_configured_store(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
"""A `cache.store` entry replaces resolution. The kernel writes there,
so the commands act there."""
notebook = tmp_path / "nb.py"
notebook.write_text(NOTEBOOK)
make_cache_dir(tmp_path)
store_dir = tmp_path / "elsewhere"
store_dir.mkdir()
configure_store(monkeypatch, store_dir)
result = CliRunner().invoke(main, ["cache", "dir", str(notebook)])
assert result.exit_code == 0, result.output
assert result.output == f"{store_dir}\n"
def test_dir_keeps_path_for_a_file_store_without_a_save_path(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
"""A file store given no location writes beside the notebook, as the
default does. Outside a kernel it cannot say where that is."""
from marimo._save.stores.file import FileStore
from marimo._save.stores.tiered import TieredStore
notebook = tmp_path / "nb.py"
notebook.write_text(NOTEBOOK)
cache_dir = make_cache_dir(tmp_path)
store_dir = tmp_path / "elsewhere"
store_dir.mkdir()
configure(
monkeypatch,
TieredStore([FileStore(), FileStore(save_path=str(store_dir))]),
)
result = CliRunner().invoke(main, ["cache", "dir", str(notebook)])
assert result.exit_code == 0, result.output
assert result.output.splitlines() == [str(cache_dir), str(store_dir)]
def test_dir_keeps_path_beside_a_store_the_default_method_distrusts(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
"""A store set by a pyproject or the notebook header is ignored by the
default cache method, so the notebook\x27s entries can sit in either
place."""
from marimo._save import stores
notebook = tmp_path / "nb.py"
notebook.write_text(NOTEBOOK)
cache_dir = make_cache_dir(tmp_path)
store_dir = tmp_path / "elsewhere"
store_dir.mkdir()
configure_store(monkeypatch, store_dir)
monkeypatch.setattr(
stores,
"cache_store_is_untrusted",
lambda current_path=None: True, # noqa: ARG005
)
result = CliRunner().invoke(main, ["cache", "dir", str(notebook)])
assert result.exit_code == 0, result.output
assert result.output.splitlines() == [str(cache_dir), str(store_dir)]
def test_dir_reports_nothing_for_a_store_with_no_local_directory(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
from marimo._save.stores.store import Store
class Remote(Store):
def get(self, key: str) -> bytes | None:
del key
return None
def put(self, key: str, value: bytes) -> bool:
del key, value
return True
def hit(self, key: str) -> bool:
del key
return False
make_cache_dir(tmp_path)
configure(monkeypatch, Remote())
result = CliRunner().invoke(main, ["cache", "dir", str(tmp_path)])
assert result.exit_code == 0, result.output
assert result.output == "No cache directories found.\n"