♻️ (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.
This commit is contained in:
Manuel Cillero 2026-10-12 21:41:01 +02:00
parent 8a7a827259
commit 728a5c83dc
32 changed files with 918 additions and 488 deletions

View file

@ -1,13 +1,17 @@
use crate::{AutoDefault, config};
use crate::AutoDefault;
use serde::de::Error;
use serde::{Deserialize, Deserializer};
/// Modos disponibles para negociar el idioma de una petición HTTP.
///
/// El ajuste [`global::SETTINGS.app.lang_negotiation`](crate::global::App::lang_negotiation)
/// determina qué fuentes intervienen en la resolución del idioma efectivo utilizado por
/// [`RequestLocale`](crate::locale::RequestLocale) y en la generación de URLs mediante
/// [`Context::route()`](crate::core::component::Context::route).
/// El ajuste [`global::SETTINGS.app.lang_negotiation`] determina qué fuentes intervienen en la
/// resolución del idioma efectivo utilizado por [`RequestLocale`] y en la generación de URLs
/// mediante [`Context::route()`].
///
/// [`global::SETTINGS.app.lang_negotiation`]: crate::global::AppSettings::lang_negotiation
/// [`RequestLocale`]: crate::locale::RequestLocale
/// [`Context::route()`]: crate::core::component::Context::route
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
pub enum LangNegotiation {
/// Usa todas las fuentes disponibles para determinar el idioma, en este orden: comprueba el
@ -18,7 +22,7 @@ pub enum LangNegotiation {
/// comportamiento por defecto.
///
/// [`CurrentUser::language()`]: crate::auth::CurrentUser::language
/// [`global::SETTINGS.app.language`]: crate::global::App::language
/// [`global::SETTINGS.app.language`]: crate::global::AppSettings::language
#[default]
Full,
@ -42,12 +46,14 @@ impl<'de> Deserialize<'de> for LangNegotiation {
D: Deserializer<'de>,
{
let raw = String::deserialize(deserializer)?;
let result = match raw.trim().to_ascii_lowercase().as_str() {
"full" => Self::Full,
"noquery" => Self::NoQuery,
"configonly" => Self::ConfigOnly,
_ => config::invalid_setting("[app].lang_negotiation", &raw, Self::default()),
};
Ok(result)
match raw.trim().to_ascii_lowercase().as_str() {
"full" => Ok(Self::Full),
"noquery" => Ok(Self::NoQuery),
"configonly" => Ok(Self::ConfigOnly),
_ => Err(D::Error::unknown_variant(
&raw,
&["Full", "NoQuery", "ConfigOnly"],
)),
}
}
}

View file

@ -1,12 +1,13 @@
use crate::{AutoDefault, config};
use crate::AutoDefault;
use serde::de::Error;
use serde::{Deserialize, Deserializer};
/// Formatos disponibles para mostrar las trazas.
///
/// El valor se obtiene de [`global::SETTINGS.log.format`](crate::global::Log::format) y determina
/// la representación textual de los eventos registrados por `tracing`.
/// El valor configurado no distingue entre mayúsculas y minúsculas.
/// El valor se obtiene de [`global::SETTINGS.log.format`](crate::global::LogSettings::format) y
/// determina la representación textual de los eventos registrados por `tracing`. El valor
/// configurado no distingue entre mayúsculas y minúsculas.
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
pub enum LogFormat {
/// Formato JSON estructurado.
@ -29,13 +30,15 @@ impl<'de> Deserialize<'de> for LogFormat {
D: Deserializer<'de>,
{
let raw = String::deserialize(deserializer)?;
let result = match raw.trim().to_ascii_lowercase().as_str() {
"json" => Self::Json,
"full" => Self::Full,
"compact" => Self::Compact,
"pretty" => Self::Pretty,
_ => config::invalid_setting("[log].format", &raw, Self::default()),
};
Ok(result)
match raw.trim().to_ascii_lowercase().as_str() {
"json" => Ok(Self::Json),
"full" => Ok(Self::Full),
"compact" => Ok(Self::Compact),
"pretty" => Ok(Self::Pretty),
_ => Err(D::Error::unknown_variant(
&raw,
&["Json", "Full", "Compact", "Pretty"],
)),
}
}
}

View file

@ -1,12 +1,13 @@
use crate::{AutoDefault, config};
use crate::AutoDefault;
use serde::de::Error;
use serde::{Deserialize, Deserializer};
/// Modos de salida y rotación para el registro de trazas.
///
/// El valor se obtiene de [`global::SETTINGS.log.rolling`](crate::global::Log::rolling) y
/// determina si las trazas se muestran por pantalla o se vuelcan en archivos con rotación.
/// El valor configurado no distingue entre mayúsculas y minúsculas.
/// El valor se obtiene de [`global::SETTINGS.log.rolling`](crate::global::LogSettings::rolling) y
/// determina si las trazas se muestran por pantalla o se vuelcan en archivos con rotación. El valor
/// configurado no distingue entre mayúsculas y minúsculas.
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
pub enum LogRolling {
/// Escribe las trazas en la salida estándar (sin rotación de archivos). Es el valor por
@ -29,14 +30,16 @@ impl<'de> Deserialize<'de> for LogRolling {
D: Deserializer<'de>,
{
let raw = String::deserialize(deserializer)?;
let result = match raw.trim().to_ascii_lowercase().as_str() {
"stdout" => Self::Stdout,
"daily" => Self::Daily,
"hourly" => Self::Hourly,
"minutely" => Self::Minutely,
"endless" => Self::Endless,
_ => config::invalid_setting("[log].rolling", &raw, Self::default()),
};
Ok(result)
match raw.trim().to_ascii_lowercase().as_str() {
"stdout" => Ok(Self::Stdout),
"daily" => Ok(Self::Daily),
"hourly" => Ok(Self::Hourly),
"minutely" => Ok(Self::Minutely),
"endless" => Ok(Self::Endless),
_ => Err(D::Error::unknown_variant(
&raw,
&["Stdout", "Daily", "Hourly", "Minutely", "Endless"],
)),
}
}
}

View file

@ -1,11 +1,14 @@
use crate::{AutoDefault, config};
use crate::AutoDefault;
use serde::de::Error;
use serde::{Deserialize, Deserializer};
/// Opciones para el *banner* ASCII mostrado al arrancar la aplicación.
///
/// Se obtiene de [`global::SETTINGS.app.startup_banner`](crate::global::App::startup_banner) y
/// controla si se muestra un *banner* en la salida estándar al arrancar la aplicación.
/// Se obtiene de [`global::SETTINGS.app.startup_banner`] y controla si se muestra un *banner* en la
/// salida estándar al arrancar la aplicación.
///
/// [`global::SETTINGS.app.startup_banner`]: crate::global::AppSettings::startup_banner
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
pub enum StartupBanner {
/// No muestra ningún banner de inicio.
@ -27,14 +30,16 @@ impl<'de> Deserialize<'de> for StartupBanner {
D: Deserializer<'de>,
{
let raw = String::deserialize(deserializer)?;
let result = match raw.trim().to_ascii_lowercase().as_str() {
"off" => Self::Off,
"slant" => Self::Slant,
"small" => Self::Small,
"speed" => Self::Speed,
"starwars" => Self::Starwars,
_ => config::invalid_setting("[app].startup_banner", &raw, Self::default()),
};
Ok(result)
match raw.trim().to_ascii_lowercase().as_str() {
"off" => Ok(Self::Off),
"slant" => Ok(Self::Slant),
"small" => Ok(Self::Small),
"speed" => Ok(Self::Speed),
"starwars" => Ok(Self::Starwars),
_ => Err(D::Error::unknown_variant(
&raw,
&["Off", "Slant", "Small", "Speed", "Starwars"],
)),
}
}
}

View file

@ -1,14 +1,16 @@
use crate::{AutoDefault, config};
use crate::AutoDefault;
use serde::de::Error;
use serde::{Deserialize, Deserializer};
/// Criterios para ordenar las regiones de zonas horarias que se ofrecen para elegir.
///
/// Se obtiene de [`global::SETTINGS.app.timezone_order`](crate::global::App::timezone_order) y
/// determina el orden de los grupos de [`Timezone::supported_by_region()`]. Es también el orden
/// por defecto de [`form::SelectTimezone`], que puede cambiarse con `with_order()`. En todos los
/// casos el grupo *"Etc"* (`Etc/UTC`) va siempre al final.
/// Se obtiene de [`global::SETTINGS.app.timezone_order`] y determina el orden de los grupos de
/// [`Timezone::supported_by_region()`]. Es también el orden por defecto de
/// [`form::SelectTimezone`], que puede cambiarse con `with_order()`. En todos los casos el grupo
/// *"Etc"* (`Etc/UTC`) va siempre al final.
///
/// [`global::SETTINGS.app.timezone_order`]: crate::global::AppSettings::timezone_order
/// [`Timezone::supported_by_region()`]: crate::datetime::Timezone::supported_by_region
/// [`form::SelectTimezone`]: crate::base::component::form::SelectTimezone
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
@ -23,10 +25,11 @@ pub enum TimezoneOrder {
///
/// [`form::SelectTimezone`]: crate::base::component::form::SelectTimezone
Alphabetical,
/// En el orden en que se indican las regiones, en
/// [`global::SETTINGS.app.timezone_regions`](crate::global::App::timezone_regions) o con
/// `SelectTimezone::with_regions()`; si no se indica ninguna región válida, por nombre, como
/// `TimezoneOrder::Alphabetical`.
/// En el orden en que se indican las regiones, en [`global::SETTINGS.app.timezone_regions`] o
/// con `SelectTimezone::with_regions()`; si no se indica ninguna región válida, por nombre,
/// como `TimezoneOrder::Alphabetical`.
///
/// [`global::SETTINGS.app.timezone_regions`]: crate::global::AppSettings::timezone_regions
Listed,
}
@ -36,12 +39,14 @@ impl<'de> Deserialize<'de> for TimezoneOrder {
D: Deserializer<'de>,
{
let raw = String::deserialize(deserializer)?;
let result = match raw.trim().to_ascii_lowercase().as_str() {
"nearest" => Self::Nearest,
"alphabetical" => Self::Alphabetical,
"listed" => Self::Listed,
_ => config::invalid_setting("[app].timezone_order", &raw, Self::default()),
};
Ok(result)
match raw.trim().to_ascii_lowercase().as_str() {
"nearest" => Ok(Self::Nearest),
"alphabetical" => Ok(Self::Alphabetical),
"listed" => Ok(Self::Listed),
_ => Err(D::Error::unknown_variant(
&raw,
&["Nearest", "Alphabetical", "Listed"],
)),
}
}
}