Struct Document 

pub struct Document { /* private fields */ }

A format-neutral in-memory document: a parsed Value plus the Format it was parsed from. Has no file or stdin coupling — construct it from a string or any std::io::Read the caller supplies.

Implementations

impl Document

pub fn parse(source: &str, format: Format) -> DocumentResult<Document>

Parse source in the given format.

Named parse (not from_str) deliberately: this takes an explicit format argument, so it is not the single-argument std::str::FromStr contract that from_str would imply.

pub fn from_reader<R: Read>( reader: R, format: Format, ) -> DocumentResult<Document>

Read reader fully to a String, then parse it in the given format.

Reads only from the supplied reader — never touches the process’s own stdin.

pub fn value(&self) -> &Value

Borrow the parsed value.

pub fn value_mut(&mut self) -> &mut Value

Mutably borrow the parsed value.

pub fn format(&self) -> Format

The format this document was parsed from.

pub fn encode(&self) -> DocumentResult<String>

Re-render the current value in its format via Format::save.

This is a fresh, non-source-preserving render: comments and original formatting are not retained. Use DocumentFile when the original source’s formatting must survive an edit.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.