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
Autosave only during code-mode (#9453)
Kiran Gadhavee5509199863e
diff --git a/marimo/_code_mode/_context.py b/marimo/_code_mode/_context.pyindex d710f36de7..767f182e12 100644--- a/marimo/_code_mode/_context.py+++ b/marimo/_code_mode/_context.py@@ -1587,7 +1587,7 @@ class AsyncCodeModeContext:internal_ops=ops,)if doc_ops:- tx = Transaction(changes=tuple(doc_ops), source="kernel")+ tx = Transaction(changes=tuple(doc_ops), source="code-mode")# Apply to local snapshot so _cell_label can read names.self._document.apply(tx)self.notify(diff --git a/marimo/_messaging/notebook/changes.py b/marimo/_messaging/notebook/changes.pyindex cdbc5e7c2a..c4e3cfb1db 100644--- a/marimo/_messaging/notebook/changes.py+++ b/marimo/_messaging/notebook/changes.py@@ -3,6 +3,8 @@from __future__ import annotations+from typing import Literal+import msgspecfrom marimo._ast.cell import CellConfig@@ -96,6 +98,8 @@ DocumentChange = (# Transaction# ------------------------------------------------------------------+TransactionSource = Literal["frontend", "kernel", "code-mode", "file-watch"]+class Transaction(msgspec.Struct, frozen=True, rename="camel"):"""An atomic batch of changes applied to a NotebookDocument.@@ -106,5 +110,5 @@ class Transaction(msgspec.Struct, frozen=True, rename="camel"):"""changes: tuple[DocumentChange, ...]- source: str+ source: TransactionSourceversion: int | None = Nonediff --git a/marimo/_session/extensions/extensions.py b/marimo/_session/extensions/extensions.pyindex b5b4129ec9..648251f684 100644--- a/marimo/_session/extensions/extensions.py+++ b/marimo/_session/extensions/extensions.py@@ -18,6 +18,7 @@ import msgspecfrom marimo import _loggersfrom marimo._cli.print import red+from marimo._messaging.notebook.changes import TransactionSourcefrom marimo._messaging.notebook.document import NotebookCellfrom marimo._messaging.notification import (AlertNotification,@@ -260,7 +261,7 @@ class NotificationListenerExtension(SessionExtension):consider a middleware chain instead of inline dispatch."""notif: KernelMessage | NotificationMessage = msg- kernel_transaction_applied = False+ applied_source: TransactionSource | None = Nonename = try_deserialize_kernel_notification_name(msg)if name == NotebookDocumentTransactionNotification.name:@@ -273,7 +274,7 @@ class NotificationListenerExtension(SessionExtension):notif = NotebookDocumentTransactionNotification(transaction=applied)- kernel_transaction_applied = applied.source == "kernel"+ applied_source = applied.sourceexcept Exception:LOGGER.warning("Failed to decode/apply kernel document transaction"@@ -281,16 +282,23 @@ class NotificationListenerExtension(SessionExtension):session.notify(notif, from_consumer_id=None)- if kernel_transaction_applied:- self._maybe_autosave(session)+ if applied_source is not None:+ self._maybe_autosave(session, applied_source)- def _maybe_autosave(self, session: Session) -> None:- """Best-effort persistence of kernel-driven mutations to disk.+ def _maybe_autosave(+ self, session: Session, source: TransactionSource+ ) -> None:+ """Best-effort persistence of code-mode mutations to disk.+ Only ``source="code-mode"`` transactions persist; ``"kernel"``+ bookkeeping (e.g. instantiation cell-order broadcasts) is skipped+ so opening or running a notebook never rewrites it on disk.Skipped in run mode and for unnamed notebooks. Failures surface asan ``AlertNotification`` toast; they never raise out of theinterceptor."""+ if source != "code-mode":+ returnif self.kernel_manager.mode != SessionMode.EDIT:returndiff --git a/packages/openapi/api.yaml b/packages/openapi/api.yamlindex 34a57bd58e..1836437359 100644--- a/packages/openapi/api.yaml+++ b/packages/openapi/api.yaml@@ -5053,7 +5053,11 @@ components:propertyName: typetype: arraysource:- type: string+ enum:+ - code-mode+ - file-watch+ - frontend+ - kernelversion:anyOf:- type: integerdiff --git a/packages/openapi/src/api.ts b/packages/openapi/src/api.tsindex c05abdb21b..0bdb4515b5 100644--- a/packages/openapi/src/api.ts+++ b/packages/openapi/src/api.ts@@ -6431,7 +6431,8 @@ export interface components {| components["schemas"]["SetName"]| components["schemas"]["SetConfig"])[];- source: string;+ /** @enum {unknown} */+ source: "code-mode" | "file-watch" | "frontend" | "kernel";/** @default null */version?: number | null;};diff --git a/tests/_session/extensions/test_notification_listener_autosave.py b/tests/_session/extensions/test_notification_listener_autosave.pyindex 852b20c295..8d2bfc7979 100644--- a/tests/_session/extensions/test_notification_listener_autosave.py+++ b/tests/_session/extensions/test_notification_listener_autosave.py@@ -18,6 +18,7 @@ from marimo._messaging.notebook.changes import (SetConfig,SetName,Transaction,+ TransactionSource,)from marimo._messaging.notebook.document import NotebookCell, NotebookDocumentfrom marimo._messaging.notification import (@@ -71,7 +72,7 @@ def _document_from(app_file_manager: AppFileManager) -> NotebookDocument:def _serialize_tx(- *changes: DocumentChange, source: str = "kernel"+ *changes: DocumentChange, source: TransactionSource = "code-mode") -> KernelMessage:return serialize_kernel_message(NotebookDocumentTransactionNotification(