Struct FigBackend 

pub struct FigBackend { /* private fields */ }

A Backend over a standalone config file, backed by fig::Editor.

Implementations

impl FigBackend

pub fn open(source: &[u8], format: Format) -> Result<Self, BackendError>

Open an editor over a copy of source parsed as format.

Trait Implementations

impl Backend for FigBackend

fn apply(&mut self, op: EditOp) -> Result<(), BackendError>

Apply one edit. Atomic: on Err, the document is unchanged.

fn to_value(&self) -> Result<Value, BackendError>

The current value tree to render (for an embed backend, the metadata region — not the whole host file).

fn source(&self) -> Result<String, BackendError>

The canonical serialized form the embedder persists on save (for an embed backend, the full rendered host file).

fn leading_comment(&self, path: &[Seg]) -> Result<Option<String>, BackendError>

The own-line comment block immediately above the node at path, lines joined by \n with markers and indentation stripped. None when there is no block — and, by default, always: a backend that never reads comments renders every page exactly as it did before this method existed, so the comment surface is opt-in for an implementor and never a blank column for a document that has none.

fn trailing_comment(&self, path: &[Seg]) -> Result<Option<String>, BackendError>

The same-line comment after the value at path, marker stripped. None when there is none, and by default always — see leading_comment.

fn schema(&self) -> Option<Schema>

The schema governing this document, if the backend knows one. The backend is exactly the component that knows where the document came from, so it is the right place to know what governs it — a prov backend returns the schema resolved from the workspace config; a standalone config file has none. Defaulted to None so existing backends are unaffected.

fn candidates(&self, path: &[Seg]) -> Result<Option<Vec<Choice>>, BackendError>

The values a picker at path should offer, when the backend can enumerate them. None — the default — means it cannot, and a frontend falls back to free text.

fn item_key( &self, seq_path: &[Seg], index: usize, ) -> Result<Option<String>, BackendError>

A stable identity for item index of the sequence at seq_path, if the backend has one. None — the default — leaves the model to infer one.