Method run_cell

marimo/_code_mode/_context.py:1303–1342

Queue a cell for execution. Cells created or edited in the same batch are not executed automatically — use `run_cell` to mark them for execution. Can also be used to re-run an existing cell without editing it. All queued `run_cell` targets are executed in a single b

(self, target: str)

        )

    def run_cell(self, target: str) -> None:
        """Queue a cell for execution.

        Cells created or edited in the same batch are not executed
        automatically — use `run_cell` to mark them for execution.
        Can also be used to re-run an existing cell without editing it.

        All queued `run_cell` targets are executed in a single batch
        on context exit, after structural operations (create/edit/delete)
        have been applied.

        Examples:
            ```python
            # Create and run
            cid = ctx.create_cell("x = 1")
            ctx.run_cell(cid)

            # Edit and run
            ctx.edit_cell("my_cell", code="y = 2")
            ctx.run_cell("my_cell")

            # Re-run an existing cell without editing
            ctx.run_cell("my_cell")
            ```

        Args:
            target (str): Cell ID or cell name to execute.
        """
        self._require_entered()
        cell_id = self._resolve_target(target)
        # Guard against running a cell that is queued for deletion.
        deleted_ids = {
            op.cell_id for op in self._ops if isinstance(op, _DeleteOp)
        }
        if cell_id in deleted_ids:
            raise ValueError(
                f"Cannot run cell {target!r} because it is queued "
                "for deletion in this batch"
            )
        self._cells_to_run.add(cell_id)

    # ------------------------------------------------------------------
    # Screenshot