mem

Module nustd.mem.

nustd.mem: the shape fabric over plain nested Python dicts.

A Shape declares slots, each slot is a ref, and every ref is a path of keys into one dict you hand in. No storage backend, no views, no reactivity: reads walk the dict, writes mutate it in place, and the dict stays yours to print, copy or dump.

A missing key on the way down reads EMPTY rather than raising, and a write creates whatever levels it needs, so a Shape can be laid over an empty dict and filled in as it goes.

Usage:

import nustd.mem as nm
from nu import Context
from nu.domains.shape import Shape

class User(Shape):
    name = nm.StrRef.slot()
    age = nm.IntRef.slot()

data = {}
ctx = Context().bind(dict, data, User)

Typed leaves (IntRef, StrRef, DatetimeRef, ...) each carry their value Form, so the ref itself is an operand. Containers (ListRef, DictRef, SetRef) hold a plain list, dict or set. ShapeRef, ShapesListRef and ShapesDictRef nest Shapes inside Shapes. ProgramRef holds Nu source. JQueueRef, in nustd.mem.refs.jqueue, holds a live janus queue and is imported by its own path.

Modules

refs.std

Module nustd.mem.refs.std.

Dict-substrate refs for standard-library value types.

Full entries

refs.items

Module nustd.mem.refs.items.

Dict substrate item refs: typed value holders in nested dicts.

Full entries

refs.dict

Module nustd.mem.refs.dict.

Dict mapping reference: key-value container backed by nested dict.

Full entries

refs.list

Module nustd.mem.refs.list.

Dict sequence reference: ordered container backed by nested list.

Full entries

refs.prog

Module nustd.mem.refs.prog.

Dict-substrate ref for a stored Nu program.

Full entries

refs.base

Module nustd.mem.refs.base.

Dict substrate refs: navigate nested Python dicts under the runtime.

Full entries

refs.set

Module nustd.mem.refs.set.

Dict set reference: unordered unique-element container.

Full entries

refs.shape

Module nustd.mem.refs.shape.

Dict shape reference: structured container backed by nested dict.

Full entries

refs.dictshape

Module nustd.mem.refs.dictshape.

Dict shapes dict reference: mapping of homogeneous shapes.

Full entries

refs.listshape

Module nustd.mem.refs.listshape.

Dict shapes list reference: sequence of homogeneous shapes.

Full entries