Enum FileTreeEvent 

pub enum FileTreeEvent {
    Snapshot {
        children: Vec<FileTreeNode>,
    },
    Upserted {
        path: Vec<String>,
        node: FileTreeNode,
    },
    Removed {
        path: Vec<String>,
    },
}

One event on the /filetree SSE stream. The first is always a Snapshot; every later one upserts or removes a single node as the filesystem changes.

Variants

Snapshot

The full tree — the watched root’s child nodes — sent once immediately on connect.

Fields

children: Vec<FileTreeNode>

The watched root’s entries (its own identity is implicit — the caller knows the watched path).

Upserted

A single node came into existence or changed. A directory carries its whole (re-walked) subtree.

Fields

path: Vec<String>

The FULL component path to the node, relative to the watched root (the last element equals node’s name).

node: FileTreeNode

The new/updated node.

Removed

A single node (and, if a directory, its whole subtree) was removed.

Fields

path: Vec<String>

The FULL component path to the vanished node, relative to the watched root.

Implementations

impl FileTreeEvent

pub fn apply(self, root: &mut Vec<FileTreeNode>)

Fold this event into a live tree (the watched root’s children). Snapshot replaces the whole child set; Upserted inserts or replaces one node at its path (a directory node carries its whole subtree); Removed drops the node at its path (and, being a subtree, everything under it). Idempotent — replaying an already-applied event leaves the tree unchanged, so at-least-once delivery is safe.

This is THE fold, shared by every holder of a materialized tree: the SDK’s FileTree client, the laboratory host’s per-lab state, and the CLI daemon’s per-host state.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for FileTreeEvent

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for FileTreeEvent

fn clone(&self) -> FileTreeEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileTreeEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileTreeEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FileTreeEvent

impl JsonSchema for FileTreeEvent

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for FileTreeEvent

fn eq(&self, other: &FileTreeEvent) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FileTreeEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FileTreeEvent