Struct ThemeFile 

pub struct ThemeFile {
    pub theme: Theme,
    pub widgets: Option<WidgetTheme>,
}

Available on crate feature serde only.

A parsed theme document: a base Theme plus optional WidgetTheme slots.

Use ThemeFile::from_toml_str / ThemeFile::load to construct one, then feed theme into crate::Context::set_theme and widgets into crate::RunConfig::widget_theme.

Example

use slt::ThemeFile;

let tf = ThemeFile::from_toml_str(r##"
[theme]
primary = "#ff0000"

[widgets.button]
fg = "#ffffff"
"##).unwrap();
assert_eq!(tf.theme.primary, slt::Color::Rgb(255, 0, 0));
assert!(tf.widgets.is_some());

Fields

theme: Theme

The base theme (the [theme] table). Missing fields fall back to Theme::dark().

widgets: Option<WidgetTheme>

Optional per-widget color overrides (the [widgets] table).

Implementations

impl ThemeFile

pub fn from_toml_str(src: &str) -> Result<ThemeFile, ThemeLoadError>

Parse a ThemeFile from a TOML string.

Errors

Returns ThemeLoadError::Parse for malformed TOML or a shape that does not match the expected [theme] / [widgets] layout.

Example

use slt::ThemeFile;

let tf = ThemeFile::from_toml_str("[theme]\nprimary = \"#00ff00\"\n").unwrap();
assert_eq!(tf.theme.primary, slt::Color::Rgb(0, 255, 0));

pub fn to_toml_string(&self) -> Result<String, ThemeLoadError>

Serialize this ThemeFile back to a TOML string.

The output round-trips through ThemeFile::from_toml_str. Colors are emitted as human-friendly tokens (#rrggbb, named, or indexed:N).

Errors

Returns ThemeLoadError::Parse if serialization fails (e.g. a value that TOML cannot represent).

Example

use slt::{Theme, ThemeFile};

let tf = ThemeFile { theme: Theme::dracula(), widgets: None };
let toml = tf.to_toml_string().unwrap();
assert!(toml.contains("[theme]"));

pub fn load(path: impl AsRef<Path>) -> Result<ThemeFile, ThemeLoadError>

Read and parse a ThemeFile from a TOML file at path.

Errors

Returns ThemeLoadError::Io if the file cannot be read, or ThemeLoadError::Parse if its contents are not valid TOML.

Example

use slt::ThemeFile;

let tf = ThemeFile::load("theme.toml").unwrap();
println!("primary = {:?}", tf.theme.primary);

Trait Implementations

impl Clone for ThemeFile

fn clone(&self) -> ThemeFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ThemeFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ThemeFile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.