Struct RenderOptions 

#[non_exhaustive]
pub struct RenderOptions<'a> {
    pub order_by: OrderBy,
    pub include_origins: bool,
    pub print_placeholders_in_comments: PlaceholderCommentMode,
    pub custom_header_attributes: Option<&'a BTreeMap<String, String>>,
}

Available on crate feature catalog only.

Shared rendering options for catalog serialization.

These fields control how a catalog is sorted and which optional reference and placeholder details are written. Some storage formats still impose their own invariants: FCL always renders in canonical (id, ctxt) order, while origin and placeholder detail flags apply across supported catalog storage formats.

References render the source file only; Ferrocat does not track or emit line numbers (see CatalogOrigin).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

order_by: OrderBy

Sort order for the final rendered catalog.

include_origins: bool

Whether source origins should be rendered as references.

print_placeholders_in_comments: PlaceholderCommentMode

Controls emission of placeholder comments.

custom_header_attributes: Option<&'a BTreeMap<String, String>>

Optional additional header attributes to inject or override.

Implementations

impl<'a> RenderOptions<'a>

pub fn with_order_by(self, order_by: OrderBy) -> Self

Returns options that render messages with the given sort order.

pub fn with_include_origins(self, include_origins: bool) -> Self

Returns options that enable or disable rendered source origins.

pub fn with_placeholder_comments( self, print_placeholders_in_comments: PlaceholderCommentMode, ) -> Self

Returns options that use the given placeholder comment mode.

pub fn with_custom_header_attributes( self, custom_header_attributes: &'a BTreeMap<String, String>, ) -> Self

Returns options that inject or override the given header attributes.

Trait Implementations

impl<'a> Clone for RenderOptions<'a>

fn clone(&self) -> RenderOptions<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RenderOptions<'a>

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

Formats the value using the given formatter.

impl Default for RenderOptions<'_>

fn default() -> Self

Returns the “default value” for a type.

impl<'a> Eq for RenderOptions<'a>

impl<'a> PartialEq for RenderOptions<'a>

fn eq(&self, other: &RenderOptions<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> StructuralPartialEq for RenderOptions<'a>