Function show_code

marimo/_output/show_code.py:35–114

Display an output along with the code of the current cell. Use `mo.show_code` to show the code of the current cell along with the cell's output. This is useful if you want a cell's code to appear in the app preview or when running the notebook as an app with `marimo run`. In th

(
    output: object = None, *, position: Literal["above", "below"] = "below"
)

def show_code(
    output: object = None, *, position: Literal["above", "below"] = "below"
) -> Html:
    """Display an output along with the code of the current cell.

    Use `mo.show_code` to show the code of the current cell along with
    the cell's output. This is useful if you want a cell's code to
    appear in the app preview or when running the notebook as an app
    with `marimo run`.

    In the displayed code, all occurrences of mo.show_code(...) will be
    replaced with ...

    Show code that produces the output `factorial(5)`:

    ```python
    def factorial(n: int) -> int:
        if n == 0:
            return 1
        return n * factorial(n - 1)


    mo.show_code(factorial(5))
    ```

    Show code of a cell, without an output:

    ```python
    def factorial(n: int) -> int:
        if n == 0:
            return 1
        return n * factorial(n - 1)


    mo.show_code()
    ```

    Args:
        output: the output to display with the cell's code; omit the output
            to just show the cell's code.
        position: Where to display the code relative to the output.
            Use "above" to show code above the output, or "below" (default) to show
            code below the output.

    Returns:
        HTML of the `output` arg displayed with its code.
    """
    assert position in ["above", "below"], (
        "position must be 'above' or 'below'"
    )

    try:
        context = get_context()
    except ContextNotInitializedError:
        return as_html(output)

    cell_id = context.cell_id
    if cell_id is None: