Enum FileTreeNode 

pub enum FileTreeNode {
    File {
        name: String,
        size: Option<u64>,
        created_at: Option<i64>,
        modified_at: Option<i64>,
        created_by: Option<String>,
        modified_by: Option<String>,
    },
    Directory {
        name: String,
        created_at: Option<i64>,
        modified_at: Option<i64>,
        created_by: Option<String>,
        modified_by: Option<String>,
        children: Vec<FileTreeNode>,
    },
    Symlink {
        name: String,
        target: Option<String>,
        created_at: Option<i64>,
        modified_at: Option<i64>,
        created_by: Option<String>,
        modified_by: Option<String>,
    },
}

One node of the filesystem tree — discriminated by type. A directory carries its children inline; file and symlink are leaves. Symlinks are the link itself (never followed), so a broken or looping link renders as a leaf rather than confusing the tree.

Common metadata on every variant: name (basename), created_at (birth time when the filesystem records one), modified_at (mtime), and the reserved created_by/modified_by (the attribution engine fills these later; always None today).

Variants

File

A regular file.

Fields

name: String

Basename of this file.

size: Option<u64>

Size in bytes.

created_at: Option<i64>

Creation time (unix seconds), when the filesystem records a birth time. None when unsupported — best-effort display metadata, never load-bearing.

modified_at: Option<i64>

Last-modified time (unix seconds). None when the stat couldn’t be read.

created_by: Option<String>

The agent that created this entry, when known. Reserved for the attribution engine; currently always None.

modified_by: Option<String>

The agent that last modified this entry, when known. Reserved; currently always None.

Directory

A directory — carries its child nodes.

Fields

name: String

Basename of this directory (the watched root is represented by the snapshot’s child list, not by a root node).

created_at: Option<i64>

Creation time (unix seconds), when the filesystem records a birth time.

modified_at: Option<i64>

Last-modified time (unix seconds) — a directory’s mtime tracks entry add/remove.

created_by: Option<String>

The agent that created this entry, when known. Reserved.

modified_by: Option<String>

The agent that last modified this entry, when known. Reserved.

children: Vec<FileTreeNode>

This directory’s entries. Empty for an empty directory — never absent.

Symlink

A symbolic link (the link itself, not its target — never followed).

Fields

name: String

Basename of this link.

target: Option<String>

The link’s target path, exactly as stored in the link (possibly relative, possibly dangling — never resolved or followed). None only when the readlink itself failed.

created_at: Option<i64>

Creation time (unix seconds), when the filesystem records a birth time.

modified_at: Option<i64>

Last-modified time (unix seconds).

created_by: Option<String>

The agent that created this entry, when known. Reserved.

modified_by: Option<String>

The agent that last modified this entry, when known. Reserved.

Implementations

impl FileTreeNode

pub fn name(&self) -> &str

This node’s basename.

pub fn children_mut(&mut self) -> Option<&mut Vec<FileTreeNode>>

Mutable access to a directory’s children — None for files and symlinks.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for FileTreeNode

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 FileTreeNode

fn clone(&self) -> FileTreeNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileTreeNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileTreeNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FileTreeNode

impl JsonSchema for FileTreeNode

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 FileTreeNode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for FileTreeNode

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 FileTreeNode