Struct PersonRecord 

pub struct PersonRecord<P: Resource> { /* private fields */ }

A record the app keeps beside the one it shows: one per resource kind and app in the workspace the app is open in, the same on every device, so it reaches the person’s other devices with the workspace. What was watched, the words taught to the keyboard, where reading stopped. Or one of the person’s shared records another app keeps (tilo_resource::SharedRecord). The shared ones belong to the person rather than to a workspace, so they are kept in the person’s own scope and stay on this device until their personal store carries them.

It is a resource like the app’s own: its edits are its actions, applied by the replayable executor, attributed to the person, written into its history and undone per step (Self::undo). It is created with the resource’s genesis (Resource::initialize) where it does not exist yet. Read it through Self::state or Self::with; an edit from another window or device reaches it on the next frame.

Implementations

impl<P: Resource> PersonRecord<P>

pub fn get(&self) -> Rc<P::State>

The current state.

pub fn with<T>(&self, read: impl FnOnce(&P::State) -> T) -> T

Read the current state.

pub fn unreadable(&self) -> Option<String>

Why the record stopped reading as P, if it did: the state is then the last one that read, and a view shows this instead of it. Its published actions say the same.

pub fn state(&self) -> LocalState<Rc<P::State>>

The state as view state that follows every change, for a control bound to it.

pub fn revision(&self) -> u64

Increases whenever the state changes.

pub fn apply(&self, action: &P::Action) -> Result<(), ActionError>

Apply action now: one change of the record, attributed to the person, recorded in its history and — for content the person made — one undo step of theirs.

pub fn invoke(&self, invoke: &Invoke<P>) -> Result<(), ActionError>

Apply the action invoke names, as Self::apply.

pub fn editable(&self) -> bool

Whether this app changes the record: its own, or a shared one it is an editor of; any other is read here.

pub fn undo(&self) -> bool

Undo the person’s last edit of the record. Whether there was one.

pub fn redo(&self) -> bool

Redo the person’s last undone edit of the record.

pub fn syncs(&self) -> bool

Whether the record reaches other devices: it has a route. One kept on this device only has none.

pub fn content(&self) -> Option<ContentStore>

Where the content this record references — a picture its state names by hash — is stored and read: with the record, carried on its route. None for a record kept on this device only, which keeps no content.

pub fn record(&self) -> &StoredRecord

The record underneath, for a test or host that carries it between devices itself.

Trait Implementations

impl<P: Resource> Clone for PersonRecord<P>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.