Struct OptionsBuilder 

#[non_exhaustive]
pub struct OptionsBuilder<'a> { /* private fields */ }

Builder for Options that provides an API for configuration.

Create an OptionsBuilder using Options::builder().

Example

use acdc_parser::{Options, SafeMode};

let options = Options::builder()
    .with_safe_mode(SafeMode::Safe)
    .with_timings()
    .with_attribute("toc", "left")
    .with_attribute("sectnums", true)
    .build()?;

Implementations

impl<'a> OptionsBuilder<'a>

pub fn with_safe_mode(self, safe_mode: SafeMode) -> Self

Set the safe mode for parsing.

Example

use acdc_parser::{Options, SafeMode};

let options = Options::builder()
    .with_safe_mode(SafeMode::Safe)
    .build()?;

pub fn with_timings(self) -> Self

Enable timing information during parsing.

Example

use acdc_parser::Options;

let options = Options::builder()
    .with_timings()
    .build()?;

pub fn with_base_dir(self, base_dir: impl AsRef<Path>) -> Self

Set the directory used to resolve relative includes from the entry input.

For file input this overrides the entry file’s parent directory. Nested includes remain relative to the file that contains them.

pub fn with_strict(self) -> Self

Reject manpage titles that do not use the name(volume) form.

Other recoverable problems still produce warnings.

Example

use acdc_parser::Options;

let options = Options::builder()
    .with_strict()
    .build()?;

pub fn with_attribute( self, name: impl Into<Cow<'a, str>>, value: impl Into<AttributeValue<'a>>, ) -> Self

Supply an application attribute.

Application values take precedence over document entries, subject to the attribute’s standard assignment rules.

This is a convenience method that accepts various types for the value:

• &str becomes AttributeValue::String
• bool becomes AttributeValue::Bool
• () becomes AttributeValue::None

Example

use acdc_parser::Options;

let options = Options::builder()
    .with_attribute("toc", "left")
    .with_attribute("sectnums", true)
    .build()?;

pub fn with_attributes<N, V>( self, attributes: impl IntoIterator<Item = (N, V)>, ) -> Self

where N: Into<Cow<'a, str>>, V: Into<AttributeValue<'a>>,

Replace the application-supplied attributes.

pub fn with_defaults<N, V>( self, defaults: impl IntoIterator<Item = (N, V)>, ) -> Self

where N: Into<Cow<'a, str>>, V: Into<AttributeValue<'a>>,

Replace defaults for attributes not supplied by the application.

Document entries can replace these defaults when the attribute permits it. Intrinsic backend values retain their normal precedence. Backend, base backend, file type, and document type defaults also determine their convenience attributes when the options are built.

pub fn with_default_attribute( self, name: impl Into<Cow<'a, str>>, value: impl Into<AttributeValue<'a>>, ) -> Self

Supply a default without changing an application override.

pub fn attribute(&self, name: &str) -> Option<&AttributeValue<'a>>

Inspect a supplied override or default before validation.

pub fn build(self) -> Result<Options<'a>, Error>

Build the Options from this builder.

Example

use acdc_parser::{Options, SafeMode};

let options = Options::builder()
    .with_safe_mode(SafeMode::Safe)
    .build()?;

Errors

Returns a structured error for an invalid attribute value.

Trait Implementations

impl<'a> Clone for OptionsBuilder<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for OptionsBuilder<'a>

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

Formats the value using the given formatter.

impl<'a> Default for OptionsBuilder<'a>

fn default() -> Self

Returns the “default value” for a type.