Method edit_cell

marimo/_code_mode/_context.py:1116–1240

Queue an update to an existing cell's code and/or config. Only the arguments you explicitly pass are changed — the cell's existing config is preserved for any argument left as `None`. Editing a cell does not automatically execute it. Use `run_cell` to queue it for e

(
        self,
        target: str,
        code: str | None = None,
        *,
        hide_code: bool | None = None,
        disabled: bool | None = None,
        column: int | None = None,
        name: str | None = None,
    )

        return cell_id

    def edit_cell(
        self,
        target: str,
        code: str | None = None,
        *,
        hide_code: bool | None = None,
        disabled: bool | None = None,
        column: int | None = None,
        name: str | None = None,
    ) -> None:
        """Queue an update to an existing cell's code and/or config.

        Only the arguments you explicitly pass are changed — the cell's
        existing config is preserved for any argument left as `None`.

        Editing a cell does not automatically execute it. Use `run_cell`
        to queue it for execution::

            ctx.edit_cell("my_cell", "x = 42")
            ctx.run_cell("my_cell")

        Examples:
            ```python
            # Update only code (config like hide_code is preserved)
            ctx.edit_cell("data_loader", "df = pd.read_parquet('new.parquet')")

            # Update only config (code is preserved)
            ctx.edit_cell("data_loader", hide_code=False)

            # Update both code and config
            ctx.edit_cell("data_loader", "df = load()", disabled=True)

            # Edit and run
            ctx.edit_cell("my_cell", "new_code()")
            ctx.run_cell("my_cell")

            # Rename a cell
            ctx.edit_cell("old_name", name="new_name")
            ```

        Args:
            target (str): Cell ID or cell name.
            code (str, optional): New Python source code. None keeps existing.
            hide_code (bool, optional): Collapse the code editor. None keeps existing.
            disabled (bool, optional): Prevent the cell from executing. None keeps existing.
            column (int, optional): Column index for multi-column layouts. None keeps existing.
            name (str, optional): New name for the cell. None keeps existing.
        """
        self._require_entered()
        cell_id = self._resolve_target(target)

        # Handle cell-id migration when converting to a setup cell.
        # Setup is identified by cell_id, not name — clear the name
        # and migrate to the well-known setup cell_id.
        new_cell_id: CellId_t | None = None
        if name == SETUP_CELL_NAME:
            setup_id = (
                self._cell_manager.setup_cell_id