Struct ThemeLoader 

pub struct ThemeLoader { /* private fields */ }

Discovers and loads Helix-compatible theme files from one or more directories.

let loader = ThemeLoader::new(["/home/me/.config/helix/themes"]);
let theme = loader.load("catppuccin_mocha")?;
let style = theme.get("ui.text");

Implementations

impl ThemeLoader

pub fn new<I, P>(theme_dirs: I) -> Self

where I: IntoIterator<Item = P>, P: Into<PathBuf>,

Create a loader that searches theme_dirs for .toml theme files.

Directories are searched in order; first match wins.

pub fn default_search_paths(app_theme_dir: impl Into<PathBuf>) -> Self

Create a loader with app-local themes first, then standard Helix user config themes ($XDG_CONFIG_HOME/helix/themes or $HOME/.config/helix/themes).

pub fn load(&self, name: &str) -> Result<Theme, ThemeError>

Load a theme by name (stem without .toml extension).

pub fn load_ref(&self, theme_ref: &str) -> Result<Theme, ThemeError>

Load a theme by name or explicit file path.

Names like "catppuccin_mocha" are searched as <dir>/<name>.toml. Single-component filenames like "catppuccin_mocha.toml" are searched directly in each configured directory. Absolute paths and relative paths with separators are loaded as file paths.

pub fn load_path(&self, path: impl AsRef<Path>) -> Result<Theme, ThemeError>

Load a theme from an explicit file path.

pub fn read_names(&self) -> Vec<String>

List all available theme names (sorted, deduplicated stems).

Trait Implementations

impl Clone for ThemeLoader

fn clone(&self) -> ThemeLoader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeLoader

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

Formats the value using the given formatter.