Skip to content

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.

4.5 KB
Raw Blame
# Copyright 2026 Marimo. All rights reserved.
from __future__ import annotations

from unittest.mock import Mock, PropertyMock

import pytest

from marimo._session.app_host.commands import KernelCreatedResponse
from marimo._session.managers.app_host import (
    AppHostKernelManager,
    AppHostQueueManager,
    _AppHostLike,
    _AppHostPushQueue,
)
from marimo._session.model import SessionMode


@pytest.mark.requires("zmq")
class TestAppHostPushQueue:
    def test_put_calls_send_command(self) -> None:
        app_host = Mock()
        q = _AppHostPushQueue(app_host, "s1", "control")
        q.put("payload")
        app_host.send_command.assert_called_once_with(
            "s1", "control", "payload"
        )

    def test_put_nowait_calls_send_command(self) -> None:
        app_host = Mock()
        q = _AppHostPushQueue(app_host, "s1", "control")
        q.put_nowait("payload")
        app_host.send_command.assert_called_once_with(
            "s1", "control", "payload"
        )

    def test_get_raises_not_implemented(self) -> None:
        q = _AppHostPushQueue(Mock(), "s1", "control")
        with pytest.raises(NotImplementedError):
            q.get()

    def test_get_nowait_raises_not_implemented(self) -> None:
        q = _AppHostPushQueue(Mock(), "s1", "control")
        with pytest.raises(NotImplementedError):
            q.get_nowait()

    def test_empty_always_returns_true(self) -> None:
        q = _AppHostPushQueue(Mock(), "s1", "control")
        assert q.empty() is True


@pytest.mark.requires("zmq")
class TestPutControlRequestDelegation:
    """Verify AppHostQueueManager.put_control_request delegates correctly.

    Detailed routing logic is tested in tests/_session/test_queue.py.
    """

    def test_delegates_to_route_control_request(self) -> None:
        from marimo._runtime.commands import StopKernelCommand

        app_host = Mock()
        qm = AppHostQueueManager(app_host, "s1")
        qm.control_queue = Mock()
        qm.completion_queue = Mock()
        qm.set_ui_element_queue = Mock()

        cmd = StopKernelCommand()
        qm.put_control_request(cmd)

        qm.control_queue.put.assert_called_once_with(cmd)
        qm.completion_queue.put.assert_not_called()
        qm.set_ui_element_queue.put.assert_not_called()


@pytest.mark.requires("zmq")
class TestAppHostLike:
    def test_pid_delegates_to_app_host(self) -> None:
        app_host = Mock()
        type(app_host).pid = PropertyMock(return_value=1234)
        like = _AppHostLike(app_host, "s1")
        assert like.pid == 1234

    def test_is_alive_delegates_to_has_active_session(self) -> None:
        app_host = Mock()
        app_host.has_active_session.return_value = True
        like = _AppHostLike(app_host, "s1")
        assert like.is_alive() is True
        app_host.has_active_session.assert_called_once_with("s1")

    def test_terminate_is_noop(self) -> None:
        like = _AppHostLike(Mock(), "s1")
        like.terminate()  # should not raise

    def test_join_is_noop(self) -> None:
        like = _AppHostLike(Mock(), "s1")
        like.join(timeout=1.0)  # should not raise


@pytest.mark.requires("zmq")
class TestAppHostKernelManagerStartAndClose:
    async def test_start_kernel_failure_raises(self) -> None:
        app_host = Mock()
        app_host.create_kernel.return_value = KernelCreatedResponse(
            session_id="s1", success=False, error="boom"
        )

        config_manager = Mock()
        config_manager.get_config.return_value = {}

        mgr = AppHostKernelManager(
            app_host=app_host,
            session_id="s1",
            queue_manager=Mock(),
            mode=SessionMode.RUN,
            configs={},
            app_metadata=Mock(),
            config_manager=config_manager,
            redirect_console_to_browser=True,
        )

        with pytest.raises(RuntimeError, match="boom"):
            await mgr.start_kernel()

        assert mgr.kernel_task is None

    def test_close_kernel_calls_close_queues_and_stop_kernel(self) -> None:
        app_host = Mock()
        queue_manager = Mock()

        mgr = AppHostKernelManager(
            app_host=app_host,
            session_id="s1",
            queue_manager=queue_manager,
            mode=SessionMode.RUN,
            configs={},
            app_metadata=Mock(),
            config_manager=Mock(),
            redirect_console_to_browser=True,
        )

        mgr.close_kernel()

        queue_manager.close_queues.assert_called_once()
        app_host.stop_kernel.assert_called_once_with("s1")