♻️ (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:
parent
8a7a827259
commit
728a5c83dc
32 changed files with 918 additions and 488 deletions
|
|
@ -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"],
|
||||
)),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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"],
|
||||
)),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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"],
|
||||
)),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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"],
|
||||
)),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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"],
|
||||
)),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue