Struct Theme 

pub struct Theme { /* private fields */ }

Implementations

impl Theme

pub fn new() -> Self

Creates an empty theme.

pub fn from_styles(styles: BTreeMap<String, Style>) -> Self

Creates a theme from a style map after normalizing capture names.

pub fn insert( &mut self, capture_name: impl AsRef<str>, style: Style, ) -> Option<Style>

Inserts or replaces a style for a capture name.

Capture names are normalized (trimmed, lowercased, optional @ removed). Returns the previously associated style, if any.

pub fn styles(&self) -> &BTreeMap<String, Style>

Returns the internal normalized style map.

pub fn get_exact(&self, capture_name: &str) -> Option<&Style>

Returns the exact style for a capture after normalization.

pub fn resolve(&self, capture_name: &str) -> Option<&Style>

Resolves a style using dotted-name fallback and finally normal.

For example, comment.documentation falls back to comment before attempting normal.

pub fn from_json_str(input: &str) -> Result<Self, ThemeError>

Parses a theme from JSON.

Both wrapped ({ "styles": { ... } }) and flat style documents are accepted.

Errors

Returns an error if the JSON cannot be parsed.

pub fn from_toml_str(input: &str) -> Result<Self, ThemeError>

Parses a theme from TOML.

Errors

Returns an error if the TOML cannot be parsed.

pub fn from_builtin(theme: BuiltinTheme) -> Result<Self, ThemeError>

Loads a built-in theme from embedded JSON.

Errors

Returns an error if embedded theme JSON fails to parse.

pub fn from_builtin_name(name: &str) -> Result<Self, ThemeError>

Loads a built-in theme from a name or alias.

Errors

Returns ThemeError::UnknownBuiltinTheme for unknown names.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Theme

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

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Theme

Returns the “default value” for a type.

impl PartialEq for Theme

fn eq(&self, other: &Theme) -> 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 Eq for Theme

impl StructuralPartialEq for Theme