cell

Module nuspace.ops.cell.

Cell ops: write one, edit it, place it, drop it.

The only writer of the two facts that must agree about a cell's place: the plane's cells list and the cell's plane. Every op here that changes one writes the other in the same commit. A cell stays on the plane it was made on: nothing here moves one to another.

Every op here that writes a cell, or the plane's cells, counts it on the plane's version in the same commit, so following a plane's cells is one key to watch.

A cell is addressed by its id alone. An op that needs its plane reads plane off it, inside its own bracket.

A cell's state is in the other store (States). Dropping a cell drops it too, as a commit of its own after the structure one, in the order atomic_state gives.

add_cell

Write a cell onto a plane and place it at index, in one commit.

ops.add_cell(plane_id, prog, cell_id=None, name='', index=None, made_by='', meta=None, into=None)

Path nuspace.ops.add_cell. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

has_ui is worked out from prog (HasUi). The props are written every time, so an existing cell given again takes the ones passed now.

Arguments

Undocumented: example.

remove_cell

Drop a cell: its live cell runs interrupted, off its plane, row deleted, then its state.

ops.remove_cell(cell_id)

Path nuspace.ops.remove_cell. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

Two commits, the row first. The other way round, a cell still on the plane (and its runs, still live until the interrupt lands) would read its state gone. This way the worst a crash between them leaves is state no cell points at.

Arguments

Undocumented: example.

rename_cell

Set a cell's name. A no-op when it is missing.

ops.rename_cell(cell_id, name)

Path nuspace.ops.rename_cell. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

Arguments

Undocumented: example.

reorder_cells

Put a plane's cells in the order given.

ops.reorder_cells(plane_id, cell_ids)

Path nuspace.ops.reorder_cells. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

Ids not on the plane are skipped, and cells left out keep their place after the named ones, so a partial order is a move, not a truncation.

Arguments

Undocumented: example.

set_cell_meta

Merge fields into a cell's meta. A no-op when it is missing.

ops.set_cell_meta(cell_id, fields)

Path nuspace.ops.set_cell_meta. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

Arguments

Undocumented: example.

set_prog

Replace a cell's source, and its has_ui with it. Bumps its version.

ops.set_prog(cell_id, prog)

Path nuspace.ops.set_prog. Defined on nuspace.ops.cell, bound as a function. Builds nu.Nu.

Live cell runs keep running the prog they loaded: rerunning them is the reload service's. Nothing validates: a broken prog stores fine, and reads as not drawing.

Arguments

Undocumented: example.