Enum FilesystemOperation 

pub enum FilesystemOperation {
    CreateDirectory {
        path: AbsolutePath,
        parents: bool,
    },
    PutFile {
        path: AbsolutePath,
        content_ref: ContentRef,
        behavior: DestinationBehavior,
        expected_revision_no: Option<RevisionNo>,
    },
    DeletePath {
        path: AbsolutePath,
        behavior: DeleteDirectoryBehavior,
        expected_inode_id: Option<InodeId>,
    },
    MovePath {
        from_path: AbsolutePath,
        to_path: AbsolutePath,
        behavior: DestinationBehavior,
    },
    CopyPath {
        from_path: AbsolutePath,
        to_path: AbsolutePath,
        behavior: DestinationBehavior,
    },
    Undelete {
        inode_id: InodeId,
        deleted_at_seq: ChangeSeq,
        path: Option<AbsolutePath>,
    },
    RestoreRevision {
        path: AbsolutePath,
        source_revision_no: RevisionNo,
    },
}

The operation language a commit is written in, owned by loonfs-api and used here unchanged.

There is one spelling of a pre-planning operation across the workspace: what a client sends is what the planner matches on, so no surface translates between two versions of the same language. The durable fingerprint preimage is a separate, frozen spelling, and the planner’s operation_fingerprint_input is the only place this one is renamed into it. One path-oriented filesystem operation.

Variants

CreateDirectory

Create one directory.

Fields

path: AbsolutePath

Absolute destination path, rejected when invalid or already bound.

parents: bool

Also create missing ancestor directories (the same auto-create put_file performs). The final component must still be new.

PutFile

Create or replace one file with an already-durable content ref.

Fields

path: AbsolutePath

Absolute destination path; missing ancestors are created automatically.

content_ref: ContentRef

Immutable bytes that must be covered by a valid preparation proof.

behavior: DestinationBehavior

Whether an existing file may receive a new revision instead of causing a conflict.

expected_revision_no: Option<RevisionNo>

When set (with replace behavior), the put applies only while the file’s current revision is still this one; a raced write fails the request instead of silently stacking on it, and a missing file answers path_not_found.

DeletePath

Delete one path.

Fields

path: AbsolutePath

Absolute path that must resolve to a visible inode.

behavior: DeleteDirectoryBehavior

Whether a non-empty directory may be tombstoned recursively.

expected_inode_id: Option<InodeId>

When set, the delete applies only if the path still resolves to this inode; a raced rebinding fails the request instead of deleting (and reporting a recovery handle for) the wrong inode.

MovePath

Move one path to another path.

Fields

from_path: AbsolutePath

Absolute source path that must resolve to a visible inode.

to_path: AbsolutePath

Absolute destination whose parent must be visible and writable.

behavior: DestinationBehavior

Whether an existing destination file may be replaced.

CopyPath

Copy one file path to another path.

Fields

from_path: AbsolutePath

Absolute source path that must resolve to a visible file.

to_path: AbsolutePath

Absolute destination whose parent must be visible and writable.

behavior: DestinationBehavior

Whether an existing destination file may receive a copied revision.

Undelete

Recover a deleted file or subtree: revoke the deletion of inode_id recorded at deleted_at_seq (both reported by the delete and by the change feed) and re-bind it. Answers not_deleted when that generation is not the live one, so a stale request never cancels a later delete.

Fields

inode_id: InodeId

Deleted inode to make reachable again.

deleted_at_seq: ChangeSeq

Observed deletion sequence, which prevents cancelling a newer tombstone generation.

path: Option<AbsolutePath>

Absolute destination path whose parent must be visible and whose name must be absent. Absent means restore in place: re-bind under the parent and name the deletion recorded, anchored on the parent’s identity rather than any remembered spelling, so the entry lands correctly even when ancestors were renamed since. A deletion that recorded no binding needs the explicit path.

RestoreRevision

Restore an older revision as the current revision for a path.

Fields

path: AbsolutePath

Absolute path that must resolve to a visible file.

source_revision_no: RevisionNo

Existing historical revision whose content will be copied into a new current revision.

Trait Implementations

impl Clone for FilesystemOperation

fn clone(&self) -> FilesystemOperation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilesystemOperation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FilesystemOperation

fn deserialize<__D>( __deserializer: __D, ) -> Result<FilesystemOperation, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FilesystemOperation

impl PartialEq for FilesystemOperation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for FilesystemOperation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FilesystemOperation