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.
from __future__ import annotations
import json
import msgspec
import pytest
from marimo._messaging.notification import (
AlertNotification,
CompletedRunNotification,
InterruptedNotification,
)
from marimo._messaging.serde import (
deserialize_kernel_message,
deserialize_kernel_notification_name,
serialize_kernel_message,
)
from marimo._messaging.types import KernelMessage
class TestSerializeKernelMessage:
def test_serialize_interrupted(self) -> None:
"""Test serializing an Interrupted message."""
message = InterruptedNotification()
result = serialize_kernel_message(message)
assert isinstance(result, bytes)
parsed = json.loads(result.decode())
assert parsed["op"] == "interrupted"
def test_serialize_alert(self) -> None:
"""Test serializing an Alert message."""
message = AlertNotification(
title="Test Alert",
description="This is a test alert",
variant="danger",
)
result = serialize_kernel_message(message)
assert isinstance(result, bytes)
parsed = json.loads(result.decode())
assert parsed["op"] == "alert"
assert parsed["title"] == "Test Alert"
assert parsed["description"] == "This is a test alert"
assert parsed["variant"] == "danger"
class TestDeserializeKernelMessage:
def test_deserialize_interrupted(self) -> None:
"""Test deserializing an Interrupted message."""
message_dict = {"op": "interrupted"}
kernel_message = KernelMessage(json.dumps(message_dict).encode())
result = deserialize_kernel_message(kernel_message)
assert isinstance(result, InterruptedNotification)
def test_deserialize_alert(self) -> None:
"""Test deserializing an Alert message."""
message_dict = {
"op": "alert",
"title": "Test Alert",
"description": "This is a test alert",
"variant": "danger",
}
kernel_message = KernelMessage(json.dumps(message_dict).encode())
result = deserialize_kernel_message(kernel_message)
assert isinstance(result, AlertNotification)
assert result.title == "Test Alert"
assert result.description == "This is a test alert"
assert result.variant == "danger"
def test_deserialize_invalid_json(self) -> None:
"""Test deserializing invalid JSON should raise an error."""
invalid_message = KernelMessage(b"invalid json")
with pytest.raises(msgspec.DecodeError):
assert deserialize_kernel_message(invalid_message)
def test_deserialize_unknown_message_type(self) -> None:
"""Test deserializing unknown message type should raise an error."""
message_dict = {"name": "unknown-message-type", "data": "some data"}
kernel_message = KernelMessage(json.dumps(message_dict).encode())
with pytest.raises(msgspec.ValidationError):
assert deserialize_kernel_message(kernel_message)
def test_deserialize_missing_required_fields(self) -> None:
"""Test deserializing message with missing required fields should raise an error."""
message_dict = {
"name": "kernel-ready"
# Missing required fields, such as layout and resumed
}
kernel_message = KernelMessage(json.dumps(message_dict).encode())
with pytest.raises(msgspec.ValidationError):
assert deserialize_kernel_message(kernel_message)
class TestRoundTripSerialization:
def test_round_trip_interrupted(self) -> None:
"""Test round-trip for Interrupted message."""
original = InterruptedNotification()
serialized = serialize_kernel_message(original)
deserialized = deserialize_kernel_message(serialized)
assert isinstance(deserialized, InterruptedNotification)
def test_round_trip_alert(self) -> None:
"""Test round-trip for Alert message."""
original = AlertNotification(
title="Warning",
description="Something went wrong",
variant="danger",
)
serialized = serialize_kernel_message(original)
deserialized = deserialize_kernel_message(serialized)
assert isinstance(deserialized, AlertNotification)
assert deserialized.title == original.title
assert deserialized.description == original.description
assert deserialized.variant == original.variant
def test_round_trip_with_unicode(self) -> None:
"""Test round-trip with unicode characters."""
original = AlertNotification(
title="测试标题",
description="Тестовое описание with émojis 🚀",
variant="danger",
)
serialized = serialize_kernel_message(original)
deserialized = deserialize_kernel_message(serialized)
assert isinstance(deserialized, AlertNotification)
assert deserialized.title == original.title
assert deserialized.description == original.description
assert deserialized.variant == original.variant
def test_deserialize_kernel_notification_name() -> None:
original = CompletedRunNotification()
serialized = serialize_kernel_message(original)
assert deserialize_kernel_notification_name(serialized) == "completed-run"