Struct MemSource 

pub struct MemSource { /* private fields */ }

A plugin package held entirely in memory.

Keys are /-separated paths relative to the plugin root; directories exist implicitly wherever a key has a parent. There are no symlinks, so every path is truthfully confined.

use agent_plugins::MemSource;

let plugin = MemSource::new()
    .file("plugin.json", br#"{
        "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
        "name": "in-memory"
    }"#)
    .load()
    .unwrap();
assert_eq!(plugin.manifest.name.as_str(), "in-memory");

Implementations

impl MemSource

pub fn new() -> Self

An empty package (which, containing no manifest, would be rejected).

pub fn file(self, path: impl Into<String>, bytes: impl Into<Vec<u8>>) -> Self

Add a file at a /-separated path relative to the plugin root.

pub fn load(self) -> Result<LoadedPlugin, Rejection>

Load the package.

Trait Implementations

impl Clone for MemSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemSource

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

Formats the value using the given formatter.

impl Default for MemSource

fn default() -> Self

Returns the “default value” for a type.

impl Source for MemSource

type Error = !

The source’s own failure type. Failures are folded into the loading conversation as Answer::Unavailable, where the spec’s failure boundaries decide how far the damage spreads.

fn kind(&mut self, path: &PackagePath) -> Result<Option<FileKind>, Infallible>

What kind of entry does path resolve to? None if absent.

fn confined(&mut self, _path: &PackagePath) -> Result<bool, Infallible>

Does path, fully resolved, stay within the plugin root? Sources that cannot contain links may simply return Ok(true).

fn read(&mut self, path: &PackagePath) -> Result<Vec<u8>, Infallible>

Read the file at path.

fn list(&mut self, path: &PackagePath) -> Result<Vec<DirEntry>, Infallible>

List the immediate entries of the directory at path.