Struct FrameworkTemplates 

pub struct FrameworkTemplates { /* private fields */ }

Thread-safe framework template environment with hot reload support

Templates are loaded from XDG directories with embedded fallbacks. The environment supports atomic reload for development hot-reload.

Implementations

impl FrameworkTemplates

pub fn new() -> Result<Self, FrameworkTemplateError>

Create a new framework templates instance

Loads templates from XDG directories. Templates MUST exist on disk (either in config or cache directory). Run acton-htmx templates init to download them.

Errors

Returns error if templates are not found or cannot be loaded.

pub fn get_config_dir() -> Option<PathBuf>

Get the XDG config directory for framework templates

Returns $XDG_CONFIG_HOME/acton-htmx/templates/framework/ or ~/.config/acton-htmx/templates/framework/ if not set.

pub fn get_cache_dir() -> Option<PathBuf>

Get the XDG cache directory for framework templates

Returns $XDG_CACHE_HOME/acton-htmx/templates/framework/ or ~/.cache/acton-htmx/templates/framework/ if not set.

pub fn get_embedded_template(name: &str) -> Option<&'static str>

Get embedded template content (for CLI to write to cache)

This is used by the CLI templates init command to populate the cache.

pub fn embedded_template_names() -> impl Iterator<Item = &'static str>

Get all embedded template names

pub fn render( &self, name: &str, ctx: Value, ) -> Result<String, FrameworkTemplateError>

Render a template with the given context

Errors

Returns error if the template is not found or rendering fails.

pub fn render_with_map( &self, name: &str, ctx: HashMap<&str, Value>, ) -> Result<String, FrameworkTemplateError>

Render a template with a context map

Convenience method that accepts a HashMap instead of minijinja::Value.

Errors

Returns error if the template is not found or rendering fails.

pub fn reload(&self) -> Result<(), FrameworkTemplateError>

Reload all templates from disk

Useful for hot-reload during development. Creates a new environment and atomically swaps it with the current one.

Errors

Returns error if templates cannot be reloaded.

pub fn is_customized(&self, name: &str) -> bool

Check if a template exists in user config (customized)

pub fn get_template_path(&self, name: &str) -> Option<PathBuf>

Get the path where a template would be loaded from

Returns the actual file path if found on disk, or None if using embedded.

pub const fn config_dir(&self) -> Option<&PathBuf>

Get a reference to the config directory

pub const fn cache_dir(&self) -> Option<&PathBuf>

Get a reference to the cache directory

Trait Implementations

impl Clone for FrameworkTemplates

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameworkTemplates

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

Formats the value using the given formatter.

impl Default for FrameworkTemplates

fn default() -> Self

Returns the “default value” for a type.