Function preview

marimo/_cli/development/commands.py:731–874

Preview a marimo file as static HTML. Creates a static HTML export of the marimo file and serves it on a simple HTTP server for preview purposes. Example usage: marimo development preview my_notebook.py marimo development preview my_notebook.py --port 8000

(file_path: Path, port: int, host: str, headless: bool)

    help="Don't automatically open the browser",
)
def preview(file_path: Path, port: int, host: str, headless: bool) -> None:
    """
    Preview a marimo file as static HTML.

    Creates a static HTML export of the marimo file and serves it
    on a simple HTTP server for preview purposes.

    Example usage:
        marimo development preview my_notebook.py
        marimo development preview my_notebook.py --port 8000
    """
    import threading
    import webbrowser

    import uvicorn
    from starlette.applications import Starlette
    from starlette.responses import HTMLResponse
    from starlette.routing import Route
    from starlette.staticfiles import StaticFiles

    from marimo._ast.app_config import _AppConfig
    from marimo._config.config import DEFAULT_CONFIG
    from marimo._server.templates.templates import static_notebook_template
    from marimo._server.tokens import SkewProtectionToken
    from marimo._utils.paths import marimo_package_path

    if TYPE_CHECKING:
        from starlette.requests import Request

    try:
        # Run the notebook to get actual outputs
        click.echo(f"Running notebook {file_path.name}...")
        from marimo._server.export import run_app_until_completion
        from marimo._server.utils import asyncio_run
        from marimo._session.notebook import load_notebook
        from marimo._session.state.serialize import (
            serialize_notebook,
            serialize_session_view,
        )
        from marimo._utils.code import hash_code

        # Create file manager for the notebook
        file_manager = load_notebook(file_path)

        # Run the notebook to completion and get session view
        session_view, did_error = asyncio_run(
            run_app_until_completion(
                file_manager,
                cli_args={},
                argv=None,
            )
        )
        if did_error:
            click.echo(
                "Warning: Some cells had errors during execution", err=True
            )

        # Create session snapshot from the executed session