Struct Record 

pub struct Record {
    pub path: PathBuf,
    pub fields: BTreeMap<String, Value>,
    pub raw_content: Option<String>,
}

One parsed .md file = one record.

Serialization note: path serializes as a string. For machine-portable JSON, store records relative to the vault root before round-tripping; absolute paths are host-specific. raw_content is skipped when None so the wire format stays compact for record listings that don’t include body text.

Fields

path: PathBuf

Absolute path to the .md file.

fields: BTreeMap<String, Value>

Parsed frontmatter fields.

raw_content: Option<String>

Raw file content — only loaded for write operations.

Implementations

impl Record

pub fn get(&self, key: &str, vault_root: &Path) -> Option<Value>

Look up a field by name, checking virtual fields first.

pub fn get_with_links( &self, key: &str, vault_root: &Path, link_index: Option<&LinkGraph>, ) -> Option<Value>

Look up a field, including graph virtual fields when a link index is provided.

pub fn virtual_name(&self) -> String

Filename without .md extension, with URL-encoded characters decoded.

pub fn virtual_path(&self, vault_root: &Path) -> String

Relative path from vault root.

pub fn virtual_folder(&self) -> String

Parent folder name.

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Record

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Record

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

where __S: Serializer,

Serialize this value into the given Serde serializer.