Trait Backend

Source

pub trait Backend: Send + Sync {
    // Required methods
    fn head(&self, name: &str) -> Result<Option<Head>>;
    fn swap_head(
        &self,
        name: &str,
        expected: Option<&Head>,
        new: &Head,
    ) -> Result<()>;
    fn put_version(&self, name: &str, version: &Version) -> Result<()>;
    fn version(&self, name: &str, digest: &str) -> Result<Option<Version>>;
    fn names(&self) -> Result<Vec<String>>;
    fn start_run(&self, name: &str, run: &Run) -> Result<u64>;
    fn finish_run(&self, name: &str, run: &Run) -> Result<()>;
    fn run(&self, name: &str, id: u64) -> Result<Option<Run>>;
    fn last_run(&self, name: &str) -> Result<Option<Run>>;
}

Expand description

Where a host keeps its scripts. Every method is called from inside an endpoint, so an implementation must not block for long; both built-ins are synchronous and local.

Required Methods§

Source

fn head(&self, name: &str) -> Result<Option<Head>>

The head of name, or None when no such script exists.

Source

fn swap_head( &self, name: &str, expected: Option<&Head>, new: &Head, ) -> Result<()>

Replace the head of name with new, if it is still expected (None: if no head exists yet). Otherwise a typed Conflict: someone got there first.

Source