pagetop/extensions/pagetop-bootsier/src/config.rs
Manuel Cillero 728a5c83dc ♻️ (config): Ajustes con #[settings] al arrancar
- Nuevo atributo `#[settings]`: valores por defecto en los campos (tipos
  comprobados al compilar y documentados); claves desconocidas y valores
  no válidos rechazados. Sustituye a `include_config!`, que se elimina.
- `LazySettings<T>::new()` declara los ajustes de una sección, y
  `Extension::settings()` los carga al arrancar, en orden; un error de
  configuración o una sección reclamada dos veces detiene el arranque.
- Aviso de secciones que no corresponden a ninguna extensión.
- Bootsier: [dev] bootsier_static_dir pasa a [bootsier] static_dir.
2026-10-12 21:41:01 +02:00

58 lines
2 KiB
Rust

//! Ajustes de configuración de `pagetop-bootsier`.
//!
//! Ejemplo:
//!
//! ```toml
//! [bootsier]
//! max_width = "90rem"
//! ```
//!
//! Uso:
//!
//! ```rust,no_run
//! # use pagetop::prelude::*;
//! use pagetop_bootsier::config;
//!
//! assert_eq!(config::SETTINGS.max_width, UnitValue::RelRem(90.0));
//! ```
//!
//! Todas las opciones, con su valor por defecto, se documentan en [`BootsierSettings`].
//!
//! Consulta [`pagetop::config`] para ver cómo PageTop lee los archivos de configuración y aplica
//! los valores a los ajustes.
use pagetop::prelude::*;
/// Ajustes de la sección `[bootsier]`, cargados al arrancar la aplicación.
pub static SETTINGS: LazySettings<BootsierSettings> = LazySettings::new();
/// Sección **`[bootsier]`** de la configuración.
#[settings(section = "bootsier")]
pub struct BootsierSettings {
/// Ancho máximo predeterminado para la página, por ejemplo "100%" o "90rem".
#[default(UnitValue::Px(1440))]
pub max_width: UnitValue,
/// Directorio raíz de `static/` para servir los archivos estáticos propios de Bootsier.
///
/// Si se indica una ruta válida, absoluta o relativa al directorio del proyecto (o, al ejecutar
/// el binario, al directorio de trabajo actual), los archivos estáticos se servirán desde
/// disco. Útil durante el desarrollo para poder modificar los archivos estáticos mientras la
/// aplicación está en ejecución, sin necesidad de recompilar.
///
/// Si la cadena está vacía, se ignora este ajuste.
pub static_dir: String,
}
#[cfg(test)]
mod tests {
use super::{BootsierSettings, config};
// `reference.toml` documents every option; with unknown keys rejected, loading it proves that
// it only documents keys that exist, with values of the right type.
const REFERENCE: &str = include_str!("../../../config/reference.toml");
#[test]
fn reference_toml_documents_only_existing_keys() {
config::load_from_str::<BootsierSettings>(REFERENCE).unwrap();
}
}