♻️ (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,5 +1,6 @@
use crate::actions;
use crate::async_trait;
use crate::config::LoadSettings;
use crate::core::AnyInfo;
use crate::core::action::ActionBox;
use crate::core::theme::ThemeRef;
@ -143,6 +144,38 @@ pub trait Extension: AnyInfo + Send + Sync {
/// ```
async fn initialize(&self) {}
/// Devuelve los ajustes de configuración de la extensión, para cargarlos en el arranque de la
/// aplicación.
///
/// Se cargan en el orden en que se registran las extensiones y antes de llamar a
/// [`initialize()`]. Así, un error de la configuración (como un valor no válido o una clave
/// desconocida) detiene el arranque. Cada extensión debe usar una sección propia: si dos
/// extensiones reclaman la misma, el arranque también se detiene. Ver [`pagetop::config`] para
/// saber cómo declarar los ajustes usando [`#[settings]`](crate::settings). La implementación
/// por defecto devuelve `None`.
///
/// # Ejemplo
///
/// ```rust,ignore
/// # use pagetop::prelude::*;
/// pub mod config;
///
/// pub struct Blog;
///
/// #[async_trait]
/// impl Extension for Blog {
/// fn settings(&self) -> Option<&'static dyn LoadSettings> {
/// Some(&config::SETTINGS)
/// }
/// }
/// ```
///
/// [`initialize()`]: Self::initialize
/// [`pagetop::config`]: crate::config
fn settings(&self) -> Option<&'static dyn LoadSettings> {
None
}
/// Registra rutas, servicios y capas de la extensión en el servidor web de la aplicación.
///
/// Recibe las rutas acumuladas hasta ese momento, añade lo que la extensión necesite y retorna