♻️ (pagetop): initialize() devuelve Result sin panic

`Extension::initialize()` devuelve `Result<(), BoxError>`; `BoxError` es
un nuevo alias. Si una extensión falla, `prepare()` registra el error
con sus causas, vuelca las trazas, lo repite en stderr y termina con
código 1, sin panic! ni cambiar su firma.
This commit is contained in:
Manuel Cillero 2026-10-13 00:04:04 +02:00
parent 728a5c83dc
commit d3a9be7550
14 changed files with 199 additions and 110 deletions

1
Cargo.lock generated
View file

@ -1898,6 +1898,7 @@ dependencies = [
"sea-orm", "sea-orm",
"sea-schema", "sea-schema",
"serde", "serde",
"thiserror",
"tokio", "tokio",
"url", "url",
] ]

View file

@ -8,7 +8,7 @@ impl Extension for NavDemo {
vec![&pagetop::base::extension::Welcome] vec![&pagetop::base::extension::Welcome]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
let main_nav = Nav::new() let main_nav = Nav::new()
.with_item(nav::Item::link(Lc::n("Home"), "/")) .with_item(nav::Item::link(Lc::n("Home"), "/"))
.with_item(nav::Item::link_blank( .with_item(nav::Item::link_blank(
@ -37,6 +37,7 @@ impl Extension for NavDemo {
InRegion::Global(&CoreRegions::Header).add(main_nav); InRegion::Global(&CoreRegions::Header).add(main_nav);
InRegion::Global(&CoreRegions::Aside).add(user_menu); InRegion::Global(&CoreRegions::Aside).add(user_menu);
Ok(())
} }
} }

View file

@ -13,7 +13,7 @@ impl Extension for NavbarDemo {
] ]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
let brand = Brand::new() let brand = Brand::new()
.with_image(image::Source::logo(PageTopSvg::Color)) .with_image(image::Source::logo(PageTopSvg::Color))
.with_title(Lc::n("PageTop")) .with_title(Lc::n("PageTop"))
@ -46,6 +46,7 @@ impl Extension for NavbarDemo {
let navbar = Navbar::brand_left(brand).with_item(navbar::Item::nav(main_nav)); let navbar = Navbar::brand_left(brand).with_item(navbar::Item::nav(main_nav));
InRegion::Global(&CoreRegions::Header).add(navbar); InRegion::Global(&CoreRegions::Header).add(navbar);
Ok(())
} }
} }

View file

@ -158,13 +158,14 @@ impl Extension for Admin {
actions![action::DeclareAdminSections::new(seed::declare_default_sections).with_weight(-99),] actions![action::DeclareAdminSections::new(seed::declare_default_sections).with_weight(-99),]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
install_migrations!(m20260629_000001_create_settings); install_migrations!(m20260629_000001_create_settings)?;
registry::build(); registry::build();
// Región neutra del core: cualquier tema puede decidir renderizarla (o no) sin que // Región neutra del core: cualquier tema puede decidir renderizarla (o no) sin que
// `pagetop-admin` dependa de ninguno en concreto (ver `CoreRegions::Aside`). // `pagetop-admin` dependa de ninguno en concreto (ver `CoreRegions::Aside`).
InRegion::Global(&CoreRegions::Aside).add(component::AdminMenu::new()); InRegion::Global(&CoreRegions::Aside).add(component::AdminMenu::new());
Ok(())
} }
fn configure_router(&self, router: Router) -> Router { fn configure_router(&self, router: Router) -> Router {

View file

@ -24,5 +24,6 @@ pagetop.workspace = true
sea-orm.workspace = true sea-orm.workspace = true
sea-schema.workspace = true sea-schema.workspace = true
serde.workspace = true serde.workspace = true
thiserror.workspace = true
tokio.workspace = true tokio.workspace = true
url.workspace = true url.workspace = true

View file

@ -78,8 +78,9 @@ impl Extension for MyApp {
] ]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
install_migrations!(m20240101_000001_create_users); install_migrations!(m20240101_000001_create_users)?;
Ok(())
} }
} }

View file

@ -79,8 +79,9 @@ impl Extension for MyApp {
] ]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
install_migrations!(m20240101_000001_create_users); install_migrations!(m20240101_000001_create_users)?;
Ok(())
} }
} }
@ -176,7 +177,7 @@ use pagetop::prelude::*;
include_locales!(LOCALES_SEAORM); include_locales!(LOCALES_SEAORM);
use sea_orm::{ConnectOptions, Database, DatabaseConnection}; use sea_orm::{ConnectOptions, Database, DatabaseConnection, DbErr};
use url::Url; use url::Url;
use std::sync::OnceLock; use std::sync::OnceLock;
@ -189,6 +190,30 @@ pub mod migration;
static DBCONN: OnceLock<DatabaseConnection> = OnceLock::new(); static DBCONN: OnceLock<DatabaseConnection> = OnceLock::new();
/// Errores que detienen el arranque de la aplicación al conectar con la base de datos o al aplicar
/// las migraciones.
#[derive(Debug, thiserror::Error)]
pub enum DbError {
/// No se ha configurado el motor de base de datos (`database.db_type`).
#[error("database.db_type is not configured: use \"mysql\", \"postgres\" or \"sqlite\"")]
TypeNotConfigured,
/// No se puede construir la URL de conexión con los ajustes de la sección `[database]`.
#[error("invalid database URL: check db_host and db_name in config")]
InvalidUrl,
/// No se puede conectar con la base de datos.
#[error("cannot connect to database \"{name}\"")]
Connection {
/// Nombre de la base de datos (`database.db_name`).
name: String,
/// Error devuelto al conectar.
#[source]
source: DbErr,
},
/// Una migración, o su reversión, ha fallado.
#[error("migration failed")]
Migration(#[source] DbErr),
}
/// Implementa la extensión. /// Implementa la extensión.
pub struct SeaORM; pub struct SeaORM;
@ -206,57 +231,60 @@ impl Extension for SeaORM {
Some(&config::SETTINGS) Some(&config::SETTINGS)
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
trace::info!( // Preparar la aplicación varias veces en el mismo proceso (las pruebas lo hacen) reutiliza
"Connecting to database \"{}\" using a pool of {} connections", // la conexión ya abierta.
&config::SETTINGS.db_name, if DBCONN.get().is_none() {
&config::SETTINGS.max_pool_size let conn = connect().await?;
); // Si otra preparación simultánea se adelanta, se queda la suya y se descarta ésta.
let _ = DBCONN.set(conn);
}
Ok(())
}
}
let db_uri: String = match config::SETTINGS.db_type { // Abre el pool de conexiones con los ajustes de la sección `[database]`.
config::DbType::Unset => panic!( async fn connect() -> Result<DatabaseConnection, DbError> {
"database.db_type is not configured: use \"mysql\", \"postgres\" or \"sqlite\"" let settings = &*config::SETTINGS;
), let db_uri: String = match settings.db_type {
config::DbType::Unset => return Err(DbError::TypeNotConfigured),
config::DbType::Mysql | config::DbType::Postgres => { config::DbType::Mysql | config::DbType::Postgres => {
let scheme = if matches!(config::SETTINGS.db_type, config::DbType::Mysql) { let scheme = if matches!(settings.db_type, config::DbType::Mysql) {
"mysql" "mysql"
} else { } else {
"postgres" "postgres"
}; };
let mut tmp_uri = Url::parse(&format!( let mut uri = Url::parse(&format!(
"{}://{}/{}", "{}://{}/{}",
scheme, scheme, settings.db_host, settings.db_name
&config::SETTINGS.db_host,
&config::SETTINGS.db_name
)) ))
.expect("Invalid database URL: check db_host and db_name in config"); .map_err(|_| DbError::InvalidUrl)?;
tmp_uri // Sin servidor en la URL (p. ej. con `db_host` vacío) no se pueden fijar el usuario,
.set_username(config::SETTINGS.db_user.as_str()) // la contraseña ni el puerto.
.expect("Failed to set db_user in connection URL"); uri.set_username(&settings.db_user)
tmp_uri .map_err(|()| DbError::InvalidUrl)?;
// https://github.com/launchbadge/sqlx/issues/1624 // https://github.com/launchbadge/sqlx/issues/1624
.set_password(Some(config::SETTINGS.db_pass.as_str())) uri.set_password(Some(&settings.db_pass))
.expect("Failed to set db_pass in connection URL"); .map_err(|()| DbError::InvalidUrl)?;
if let Some(port) = config::SETTINGS.db_port { if let Some(port) = settings.db_port {
tmp_uri uri.set_port(Some(port)).map_err(|()| DbError::InvalidUrl)?;
.set_port(Some(port))
.expect("Failed to set db_port in connection URL");
} }
tmp_uri.to_string() uri.to_string()
}
config::DbType::Sqlite => {
format!("sqlite://{}", &config::SETTINGS.db_name)
} }
config::DbType::Sqlite => format!("sqlite://{}", settings.db_name),
}; };
let conn = Database::connect::<ConnectOptions>({ trace::info!(
let mut db_opt = ConnectOptions::new(db_uri); "Connecting to database \"{}\" using a pool of {} connections",
db_opt.max_connections(config::SETTINGS.max_pool_size); settings.db_name,
db_opt settings.max_pool_size
}) );
let mut options = ConnectOptions::new(db_uri);
options.max_connections(settings.max_pool_size);
Database::connect(options)
.await .await
.expect("Failed to connect to database"); .map_err(|source| DbError::Connection {
name: settings.db_name.clone(),
DBCONN.set(conn).expect("DBCONN already initialized"); source,
} })
} }

View file

@ -162,6 +162,8 @@ pub use sea_orm::sea_query::*;
use pagetop::core::TypeInfo; use pagetop::core::TypeInfo;
use crate::DbError;
impl<M: MigrationTrait> MigrationName for M { impl<M: MigrationTrait> MigrationName for M {
fn name(&self) -> &str { fn name(&self) -> &str {
// Extrae el módulo contenedor, descartando el segmento final "Migration". // Extrae el módulo contenedor, descartando el segmento final "Migration".
@ -181,30 +183,27 @@ pub type MigrationItem = Box<dyn MigrationTrait>;
pub trait MigratorBase { pub trait MigratorBase {
/// Ejecuta las migraciones pendientes en orden ascendente. /// Ejecuta las migraciones pendientes en orden ascendente.
/// ///
/// Provoca un `panic!` si alguna migración falla, evitando que la aplicación arranque con un /// Devuelve [`DbError::Migration`] si alguna migración falla. Propagado desde
/// esquema de base de datos inconsistente. /// [`Extension::initialize()`](pagetop::core::extension::Extension::initialize), detiene el
async fn run_up(); /// arranque y evita que la aplicación funcione con un esquema de base de datos inconsistente.
async fn run_up() -> Result<(), DbError>;
/// Revierte todas las migraciones en orden descendente. /// Revierte todas las migraciones en orden descendente.
/// ///
/// Provoca un `panic!` si alguna reversión falla. /// Devuelve [`DbError::Migration`] si alguna reversión falla.
async fn run_down(); async fn run_down() -> Result<(), DbError>;
} }
#[pagetop::async_trait] #[pagetop::async_trait]
impl<M: MigratorTrait> MigratorBase for M { impl<M: MigratorTrait> MigratorBase for M {
async fn run_up() { async fn run_up() -> Result<(), DbError> {
let conn = SchemaManagerConnection::Connection(super::db::dbconn()); let conn = SchemaManagerConnection::Connection(super::db::dbconn());
if let Err(e) = Self::up(conn, None).await { Self::up(conn, None).await.map_err(DbError::Migration)
panic!("Migration upgrade failed: {e}");
}
} }
async fn run_down() { async fn run_down() -> Result<(), DbError> {
let conn = SchemaManagerConnection::Connection(super::db::dbconn()); let conn = SchemaManagerConnection::Connection(super::db::dbconn());
if let Err(e) = Self::down(conn, None).await { Self::down(conn, None).await.map_err(DbError::Migration)
panic!("Migration downgrade failed: {e}");
}
} }
} }
@ -214,6 +213,9 @@ impl<M: MigratorTrait> MigratorBase for M {
/// registrados en la tabla `seaql_migrations`. Se invoca habitualmente desde /// registrados en la tabla `seaql_migrations`. Se invoca habitualmente desde
/// [`Extension::initialize`](pagetop::core::extension::Extension::initialize). /// [`Extension::initialize`](pagetop::core::extension::Extension::initialize).
/// ///
/// Devuelve `Result<(), DbError>`: con `?`, una migración que falla ([`DbError::Migration`])
/// detiene el arranque de la aplicación.
///
/// **Requisito:** cada módulo de migración debe declararse como submódulo público bajo un módulo /// **Requisito:** cada módulo de migración debe declararse como submódulo público bajo un módulo
/// `migration` accesible desde el punto de llamada, y exportar `pub struct Migration` que /// `migration` accesible desde el punto de llamada, y exportar `pub struct Migration` que
/// implemente [`MigrationTrait`]. El macro genera rutas de la forma /// implemente [`MigrationTrait`]. El macro genera rutas de la forma
@ -231,11 +233,12 @@ impl<M: MigratorTrait> MigratorBase for M {
/// ///
/// #[async_trait] /// #[async_trait]
/// impl Extension for MyExt { /// impl Extension for MyExt {
/// async fn initialize(&self) { /// async fn initialize(&self) -> Result<(), BoxError> {
/// install_migrations!( /// install_migrations!(
/// m20240101_000001_create_users, /// m20240101_000001_create_users,
/// m20240115_000002_add_email_index, /// m20240115_000002_add_email_index,
/// ); /// )?;
/// Ok(())
/// } /// }
/// } /// }
/// ``` /// ```
@ -254,31 +257,31 @@ macro_rules! install_migrations {
m m
} }
} }
Migrator::run_up().await; Migrator::run_up().await
}}; }};
} }
/// Revierte las migraciones de una extensión en orden inverso al de su aplicación. /// Revierte las migraciones de una extensión en orden inverso al de su aplicación.
/// ///
/// Ejecuta el método `down` de cada migración indicada. Si el método `down` de alguna migración /// Ejecuta el método `down` de cada migración indicada y devuelve `Result<(), DbError>`. Si el
/// devuelve un error, provoca un `panic!`. Complementario a /// método `down` de alguna migración devuelve un error, devuelve [`DbError::Migration`].
/// [`install_migrations!`](crate::install_migrations). /// Complementario a [`install_migrations!`](crate::install_migrations).
/// ///
/// **Requisito:** los módulos de migración deben declararse como en /// **Requisito:** los módulos de migración deben declararse como en
/// [`install_migrations!`](crate::install_migrations). Todos los módulos indicados **deben /// [`install_migrations!`](crate::install_migrations). Todos los módulos indicados **deben
/// implementar `down`**; la implementación por defecto devuelve error, lo que provoca un pánico en /// implementar `down`**; la implementación por defecto devuelve un error.
/// `run_down`.
/// ///
/// En `src/lib.rs`: /// En `src/lib.rs`:
/// ```rust,ignore /// ```rust,ignore
/// #[async_trait] /// use pagetop_seaorm::DbError;
/// impl Extension for MyExt { ///
/// async fn uninitialize(&self) { /// mod migration;
///
/// async fn reset_schema() -> Result<(), DbError> {
/// uninstall_migrations!( /// uninstall_migrations!(
/// m20240101_000001_create_users, /// m20240101_000001_create_users,
/// m20240115_000002_add_email_index, /// m20240115_000002_add_email_index,
/// ); /// )
/// }
/// } /// }
/// ``` /// ```
#[macro_export] #[macro_export]
@ -296,6 +299,6 @@ macro_rules! uninstall_migrations {
m m
} }
} }
Migrator::run_down().await; Migrator::run_down().await
}}; }};
} }

View file

@ -239,7 +239,7 @@ impl Extension for User {
] ]
} }
async fn initialize(&self) { async fn initialize(&self) -> Result<(), BoxError> {
install_migrations!( install_migrations!(
m20260629_000001_create_users, m20260629_000001_create_users,
m20260629_000002_create_roles, m20260629_000002_create_roles,
@ -247,11 +247,12 @@ impl Extension for User {
m20260629_000004_create_role_permissions, m20260629_000004_create_role_permissions,
m20260629_000005_create_sessions, m20260629_000005_create_sessions,
m20260629_000006_create_user_tokens, m20260629_000006_create_user_tokens,
); )?;
permission::build_registry(); permission::build_registry();
auth::seed_initial_data().await; auth::seed_initial_data().await;
#[cfg(feature = "demo-data")] #[cfg(feature = "demo-data")]
demo::seed_demo_data().await; demo::seed_demo_data().await;
Ok(())
} }
fn configure_router(&self, router: Router) -> Router { fn configure_router(&self, router: Router) -> Router {

View file

@ -7,7 +7,7 @@ use crate::datetime::Timezone;
use crate::locale::Locale; use crate::locale::Locale;
use crate::response::{render_error_pages, response_for_panic, route_not_found}; use crate::response::{render_error_pages, response_for_panic, route_not_found};
use crate::web::Router; use crate::web::Router;
use crate::{PAGETOP_VERSION, global, trace}; use crate::{BoxError, PAGETOP_VERSION, global, trace};
use tower_http::catch_panic::CatchPanicLayer; use tower_http::catch_panic::CatchPanicLayer;
use tracing_appender::non_blocking::WorkerGuard; use tracing_appender::non_blocking::WorkerGuard;
@ -54,9 +54,13 @@ impl Application {
/// que no dependen de ninguna otra, luego las que dependen de extensiones ya habilitadas, y así /// que no dependen de ninguna otra, luego las que dependen de extensiones ya habilitadas, y así
/// hasta habilitar la extensión raíz. /// hasta habilitar la extensión raíz.
/// ///
/// Es `async` porque cada extensión puede realizar operaciones asíncronas en su /// Es `async` porque cada extensión puede realizar operaciones asíncronas en su `initialize()`
/// [`initialize()`](crate::core::extension::Extension::initialize) (conexión a base de datos, /// (conexión a base de datos, migraciones, semillas de datos, etc.).
/// migraciones, semillas de datos...). ///
/// Si alguna extensión devuelve un error al inicializarse, detiene el arranque y termina el
/// proceso con el código de salida `1` (ver [`Extension::initialize()`]).
///
/// [`Extension::initialize()`]: crate::core::extension::Extension::initialize
pub async fn prepare(root_extension: ExtensionRef) -> Self { pub async fn prepare(root_extension: ExtensionRef) -> Self {
Self::internal_prepare(Some(root_extension)).await Self::internal_prepare(Some(root_extension)).await
} }
@ -87,12 +91,38 @@ impl Application {
// Registra las acciones de las extensiones. // Registra las acciones de las extensiones.
extension::all::register_actions(); extension::all::register_actions();
// Inicializa las extensiones. // Inicializa las extensiones. Si alguna falla, detiene aquí el arranque.
extension::all::initialize_extensions().await; if let Err((name, err)) = extension::all::initialize_extensions().await {
Self::abort_startup(tracing, name, err);
}
Self { tracing } Self { tracing }
} }
// Detiene el arranque cuando una extensión falla al inicializarse. Escribe el error, con todas
// sus causas, en las trazas y en la salida de errores, que es lo único que ve quien arranca la
// aplicación si las trazas se escriben en archivos. Vuelca las trazas antes de terminar,
// porque `process::exit()` no ejecuta los destructores.
//
// Muchos errores terminan ya con el texto de su causa (p. ej. los de SeaORM), así que se omite
// cada causa con la que ya termina el mensaje.
fn abort_startup(tracing: Option<WorkerGuard>, name: &str, err: BoxError) -> ! {
let mut message = format!("Extension \"{name}\" failed to initialize: {err}");
let mut source = err.source();
while let Some(cause) = source {
let cause_text = cause.to_string();
if !message.ends_with(&cause_text) {
message.push_str(": ");
message.push_str(&cause_text);
}
source = cause.source();
}
trace::error!("{message}");
drop(tracing);
eprintln!("{message}");
std::process::exit(1);
}
// Muestra la cabecera de arranque si está habilitada en la configuración. // Muestra la cabecera de arranque si está habilitada en la configuración.
fn show_banner() { fn show_banner() {
use colored::Colorize; use colored::Colorize;

View file

@ -3,7 +3,7 @@ use crate::core::extension::ExtensionRef;
use crate::core::theme::ThemeRef; use crate::core::theme::ThemeRef;
use crate::core::theme::all::register_theme; use crate::core::theme::all::register_theme;
use crate::web::Router; use crate::web::Router;
use crate::{config, global, serve_static_files, trace, web}; use crate::{BoxError, config, global, serve_static_files, trace, web};
use std::sync::OnceLock; use std::sync::OnceLock;
@ -131,11 +131,15 @@ pub fn load_settings() {
// **< INICIALIZA LAS EXTENSIONES >***************************************************************** // **< INICIALIZA LAS EXTENSIONES >*****************************************************************
pub async fn initialize_extensions() { /// Inicializa las extensiones en el orden en que se registraron.
///
/// Se detiene en la primera que falle y devuelve su nombre corto junto con el error.
pub async fn initialize_extensions() -> Result<(), (&'static str, BoxError)> {
trace::info!("Calling application bootstrap"); trace::info!("Calling application bootstrap");
for e in EXTENSIONS.get().into_iter().flatten() { for e in EXTENSIONS.get().into_iter().flatten() {
e.initialize().await; e.initialize().await.map_err(|err| (e.short_name(), err))?;
} }
Ok(())
} }
// **< CONFIGURA LAS RUTAS >************************************************************************ // **< CONFIGURA LAS RUTAS >************************************************************************

View file

@ -1,3 +1,4 @@
use crate::BoxError;
use crate::actions; use crate::actions;
use crate::async_trait; use crate::async_trait;
use crate::config::LoadSettings; use crate::config::LoadSettings;
@ -119,16 +120,20 @@ pub trait Extension: AnyInfo + Send + Sync {
/// Inicializa la extensión durante la fase de arranque de la aplicación. /// Inicializa la extensión durante la fase de arranque de la aplicación.
/// ///
/// La firma extendida que se muestra es el resultado de aplicar la macro /// La firma extendida que muestra este método es el resultado de aplicar la macro
/// [`pagetop::async_trait`](pagetop::async_trait) a la declaración del método: /// [`pagetop::async_trait`] a la declaración:
/// ///
/// ```text /// ```text
/// async fn initialize(&self) {} /// async fn initialize(&self) -> Result<(), BoxError> { Ok(()) }
/// ``` /// ```
/// ///
/// Solo es necesario sobrescribir este método **cuando la extensión necesita ejecutar alguna /// Solo es necesario sobrescribir este método **cuando la extensión necesita ejecutar alguna
/// lógica de inicialización**. PageTop lo invoca una sola vez, después de que todas las /// lógica de inicialización**. PageTop lo invoca después de que todas las dependencias se han
/// dependencias se han inicializado y antes de aceptar cualquier petición HTTP. /// inicializado y antes de aceptar cualquier petición HTTP.
///
/// Si devuelve un error, el arranque se detiene: PageTop lo registra en las trazas junto con
/// sus causas, lo muestra en la salida de errores y termina el proceso con el código de salida
/// `1`. El tipo [`BoxError`] permite propagar con `?` cualquier tipo de error.
/// ///
/// ```rust,no_run /// ```rust,no_run
/// use pagetop::prelude::*; /// use pagetop::prelude::*;
@ -137,12 +142,18 @@ pub trait Extension: AnyInfo + Send + Sync {
/// ///
/// #[async_trait] /// #[async_trait]
/// impl Extension for MyExtension { /// impl Extension for MyExtension {
/// async fn initialize(&self) { /// async fn initialize(&self) -> Result<(), BoxError> {
/// // lógica de inicialización... /// // lógica de inicialización...
/// Ok(())
/// } /// }
/// } /// }
/// ``` /// ```
async fn initialize(&self) {} ///
/// [`pagetop::async_trait`]: pagetop::async_trait
/// [`BoxError`]: crate::BoxError
async fn initialize(&self) -> Result<(), BoxError> {
Ok(())
}
/// Devuelve los ajustes de configuración de la extensión, para cargarlos en el arranque de la /// Devuelve los ajustes de configuración de la extensión, para cargarlos en el arranque de la
/// aplicación. /// aplicación.

View file

@ -170,6 +170,12 @@ impl Deref for StaticResources {
} }
} }
/// Alias para un error cualquiera, `Box<dyn std::error::Error + Send + Sync>`.
///
/// Lo devuelve [`Extension::initialize()`](crate::core::extension::Extension::initialize) para que
/// cada extensión pueda propagar con `?` sus propios tipos de error sin convertirlos.
pub type BoxError = Box<dyn std::error::Error + Send + Sync>;
/// Alias para `Cow<'static, str>`. /// Alias para `Cow<'static, str>`.
/// ///
/// Es un puntero inteligente con semántica *copy-on-write* para cadenas. Permite reutilizar /// Es un puntero inteligente con semántica *copy-on-write* para cadenas. Permite reutilizar

View file

@ -6,7 +6,7 @@ pub use crate::PAGETOP_VERSION;
pub use crate::{async_trait, builder_fn, builder_impl, html, main, settings, test}; pub use crate::{async_trait, builder_fn, builder_impl, html, main, settings, test};
pub use crate::{AutoDefault, CowStr, Getters, StaticResources, UniqueId, Weight}; pub use crate::{AutoDefault, BoxError, CowStr, Getters, StaticResources, UniqueId, Weight};
// MACROS. // MACROS.