🥅 (config): Detiene arranque si config falla

This commit is contained in:
Manuel Cillero 2026-10-17 11:27:51 +02:00
parent 98a71b6f51
commit d1d3a62c8f
4 changed files with 66 additions and 12 deletions

View file

@ -72,6 +72,11 @@ impl Application {
// Secuencia de arranque común a new() y prepare().
async fn internal_prepare(root_extension: Option<ExtensionRef>) -> Self {
// Comprueba la configuración global antes de usarla. Un error detiene aquí el arranque.
if let Err(err) = global::check_settings() {
Self::abort_startup(None, err);
}
// Al arrancar muestra una cabecera para la aplicación.
Self::show_banner();

View file

@ -144,9 +144,10 @@ const DEFAULT_CONFIG_DIR: &str = "config";
const DEFAULT_RUN_MODE: &str = "default";
// Configuración combinada de los archivos TOML en el orden de carga, más el modo de ejecución
// (`app.run_mode`). Se construye una sola vez, en el primer acceso, y sólo la leen las funciones de
// este módulo: así ningún ajuste se salta las comprobaciones de `#[settings]`.
static CONFIG_VALUES: LazyLock<Config> = LazyLock::new(|| {
// (`app.run_mode`), o el texto del error si no se pudieron leer (`ConfigError` no implementa
// `Clone`). Se construye una sola vez, en el primer acceso, y sólo la leen las funciones de este
// módulo: así ningún ajuste se salta las comprobaciones de `#[settings]`.
static CONFIG_VALUES: LazyLock<Result<Config, String>> = LazyLock::new(|| {
// CONFIG_DIR (si existe) o DEFAULT_CONFIG_DIR. Si no se puede resolver, se usa tal cual. Sólo
// se avisa si CONFIG_DIR está definida: que falte el directorio predeterminado es normal en una
// aplicación sin configuración propia, pero un CONFIG_DIR erróneo podría dejar la aplicación
@ -189,14 +190,38 @@ static CONFIG_VALUES: LazyLock<Config> = LazyLock::new(|| {
// Guarda el modo de ejecución explícitamente.
.set_override("app.run_mode", rm)
.and_then(|builder| builder.build())
.unwrap_or_else(|err| panic!("Failed to read the configuration files: {err}"))
.map_err(|err| err.to_string())
});
// Configuración combinada, o el error que impidió leer los archivos.
fn config_values() -> Result<&'static Config, ConfigError> {
CONFIG_VALUES
.as_ref()
.map_err(|message| ConfigError::Message(message.clone()))
}
// Comprueba que los archivos de configuración se pueden leer (p. ej. que ningún TOML está mal
// formado), para detener el arranque con un error en lugar del `panic!` del primer acceso.
pub(crate) fn check_files() -> Result<(), ConfigError> {
config_values().map(|_| ())
}
// Comprueba, sin guardarlos, que los ajustes de la sección de `T` se pueden cargar. Sirve para los
// ajustes que se guardan en otra variable, como los globales de PageTop.
pub(crate) fn check<T: SettingsSection>() -> Result<(), ConfigError> {
section_from::<T>(config_values()?).map(|_| ())
}
// Secciones del primer nivel de la configuración.
pub(crate) fn sections() -> Vec<String> {
CONFIG_VALUES
.clone()
.try_deserialize::<HashMap<String, IgnoredAny>>()
config_values()
.ok()
.and_then(|config| {
config
.clone()
.try_deserialize::<HashMap<String, IgnoredAny>>()
.ok()
})
.map(|sections| sections.into_keys().collect())
.unwrap_or_default()
}
@ -213,11 +238,14 @@ pub trait SettingsSection: DeserializeOwned + Default + Send + Sync + 'static {
}
// Carga los ajustes de la sección `T::SECTION` de la configuración. Las claves ausentes toman su
// valor por defecto, y si falta la sección entera se usan los de todos los campos. Si la sección no
// puede deserializarse (un valor no válido o una clave desconocida), lanza `panic!` con un mensaje
// que indica la sección y el problema.
// valor por defecto, y si falta la sección entera se usan los de todos los campos. Si los archivos
// no se pueden leer o la sección no puede deserializarse (un valor no válido o una clave
// desconocida), lanza `panic!` con un mensaje que indica el problema. Al arrancar no llega a
// ocurrir: la aplicación lo comprueba antes y se detiene con un error.
pub(crate) fn load<T: SettingsSection>() -> T {
section_from(&CONFIG_VALUES)
let config = config_values()
.unwrap_or_else(|err| panic!("Failed to read the configuration files: {err}"));
section_from(config)
.unwrap_or_else(|err| panic!("Invalid settings in section [{}]: {err}", T::SECTION))
}
@ -318,7 +346,7 @@ impl<T: SettingsSection> LoadSettings for LazySettings<T> {
// mismos.
fn load(&self) -> Result<(), BoxError> {
if self.0.get().is_none() {
let _ = self.0.set(section_from::<T>(&CONFIG_VALUES)?);
let _ = self.0.set(section_from::<T>(config_values()?)?);
}
Ok(())
}

View file

@ -12,6 +12,9 @@ static EXTENSIONS: OnceLock<Vec<ExtensionRef>> = OnceLock::new();
/// Errores de las extensiones que detienen el arranque de la aplicación.
#[derive(Debug, thiserror::Error)]
pub enum StartupError {
/// Los archivos de configuración no se pueden leer (p. ej. un TOML mal formado).
#[error("Failed to read the configuration files")]
ReadConfig(#[source] BoxError),
/// Dos extensiones, o una extensión y PageTop, reclaman la misma sección de la configuración:
/// cada una la leería con su propia estructura de ajustes.
#[error("Settings section [{0}] is already claimed by PageTop or another extension")]

View file

@ -1,5 +1,6 @@
//! Ajustes de configuración globales de PageTop.
use crate::core::extension::all::StartupError;
use crate::{config, settings};
use std::sync::LazyLock;
@ -31,6 +32,23 @@ pub static SETTINGS: LazyLock<Settings> = LazyLock::new(|| Settings {
server: config::load(),
});
// Comprueba que los archivos de configuración se pueden leer y que los ajustes globales son válidos.
// La aplicación lo llama al arrancar, antes del primer acceso a `SETTINGS`, que lanzaría `panic!`.
pub(crate) fn check_settings() -> Result<(), StartupError> {
config::check_files().map_err(|err| StartupError::ReadConfig(err.into()))?;
check_section::<AppSettings>()?;
check_section::<DevSettings>()?;
check_section::<LogSettings>()?;
check_section::<ServerSettings>()
}
fn check_section<T: config::SettingsSection>() -> Result<(), StartupError> {
config::check::<T>().map_err(|err| StartupError::InvalidSettings {
section: T::SECTION,
source: err.into(),
})
}
// **< Settings >***********************************************************************************
/// Ajustes globales de [`SETTINGS`].