Struct FrontmatterParser 

pub struct FrontmatterParser { /* private fields */ }

Unified frontmatter parser with templating support.

This struct provides a centralized interface for parsing frontmatter from content using the grey_matter library, with optional Tera templating support. It handles YAML, TOML, and JSON frontmatter formats automatically.

Implementations

impl FrontmatterParser

pub fn new() -> Self

Create a new frontmatter parser.

pub fn with_project_dir(project_dir: PathBuf) -> Result<Self>

Create a new frontmatter parser with custom project directory.

Arguments

• project_dir - Project root directory for template rendering

pub fn parse_with_templating<T>( &mut self, content: &str, variant_inputs: Option<&Value>, file_path: &Path, context: Option<&OperationContext>, ) -> Result<ParsedFrontmatter<T>>

where T: DeserializeOwned,

Parse content and extract frontmatter with optional templating.

This method provides the complete parsing pipeline:

1. Extract frontmatter using gray_matter
2. Apply Tera templating if variant_inputs is provided
3. Deserialize the result to the target type

Arguments

• content - The content to parse
• variant_inputs - Optional template variables (project, config, etc.)
• file_path - Path to the file (used for error reporting)
• context - Optional operation context for warning deduplication

Returns

• ParsedFrontmatter<T> - The parsed result with data and content

pub fn parse<T>(&self, content: &str) -> Result<ParsedFrontmatter<T>>

where T: DeserializeOwned,

Simple parse without templating, just extract frontmatter and content.

Arguments

• content - The content to parse

Returns

• ParsedFrontmatter<T> - The parsed result with data and content

pub fn has_frontmatter(&self, content: &str) -> bool

Check if content has frontmatter.

Arguments

• content - The content to check

Returns

• bool - True if frontmatter is present

pub fn strip_frontmatter(&self, content: &str) -> String

Extract just the content without frontmatter.

Arguments

• content - The content to process

Returns

• String - Content with frontmatter removed

pub fn extract_raw_frontmatter(&self, content: &str) -> Option<String>

Extract just the raw frontmatter string.

Arguments

• content - The content to process

Returns

• Option<String> - Raw frontmatter as YAML string, if present

pub fn apply_templating( &mut self, content: &str, variant_inputs: Option<&Value>, file_path: &Path, ) -> Result<String>

Apply Tera templating to content.

Always renders the content as a template to catch syntax errors. If variant_inputs is provided, it’s used for template variables. Otherwise, renders with an empty context.

Arguments

• content - The content to template
• variant_inputs - Optional template variables (project, config, etc.)
• file_path - Path to file for error reporting

Returns

• Result<String> - Templated content or error

Trait Implementations

impl Clone for FrontmatterParser

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 FrontmatterParser

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

Formats the value using the given formatter.

impl Default for FrontmatterParser

fn default() -> Self

Returns the “default value” for a type.