✨ Añade API para extensiones con funcionalidades

Añade el interfaz común que debe implementar cualquier extensión de
PageTop para añadir nuevas funcionalidades a la aplicación en forma de
servicios web y API de uso.

src/core/extension/all.rs

@@ -0,0 +1,104 @@
+use crate::core::extension::ExtensionRef;
+use crate::{service, trace};
+
+use std::sync::{LazyLock, RwLock};
+
+// EXTENSIONES *************************************************************************************
+
+static ENABLED_EXTENSIONS: LazyLock<RwLock<Vec<ExtensionRef>>> =
+    LazyLock::new(|| RwLock::new(Vec::new()));
+
+static DROPPED_EXTENSIONS: LazyLock<RwLock<Vec<ExtensionRef>>> =
+    LazyLock::new(|| RwLock::new(Vec::new()));
+
+// REGISTRO DE LAS EXTENSIONES *********************************************************************
+
+pub fn register_extensions(root_extension: Option<ExtensionRef>) {
+    // Prepara la lista de extensiones habilitadas.
+    let mut enabled_list: Vec<ExtensionRef> = Vec::new();
+
+    // Si se proporciona una extensión raíz inicial, se añade a la lista de extensiones habilitadas.
+    if let Some(extension) = root_extension {
+        add_to_enabled(&mut enabled_list, extension);
+    }
+
+    // Guarda la lista final de extensiones habilitadas.
+    ENABLED_EXTENSIONS
+        .write()
+        .unwrap()
+        .append(&mut enabled_list);
+
+    // Prepara una lista de extensiones deshabilitadas.
+    let mut dropped_list: Vec<ExtensionRef> = Vec::new();
+
+    // Si se proporciona una extensión raíz, analiza su lista de dependencias.
+    if let Some(extension) = root_extension {
+        add_to_dropped(&mut dropped_list, extension);
+    }
+
+    // Guarda la lista final de extensiones deshabilitadas.
+    DROPPED_EXTENSIONS
+        .write()
+        .unwrap()
+        .append(&mut dropped_list);
+}
+
+fn add_to_enabled(list: &mut Vec<ExtensionRef>, extension: ExtensionRef) {
+    // Verifica que la extensión no esté en la lista para evitar duplicados.
+    if !list.iter().any(|e| e.type_id() == extension.type_id()) {
+        // Añade primero (en orden inverso) las dependencias de la extensión.
+        for d in extension.dependencies().iter().rev() {
+            add_to_enabled(list, *d);
+        }
+
+        // Añade la propia extensión a la lista.
+        list.push(extension);
+    }
+}
+
+fn add_to_dropped(list: &mut Vec<ExtensionRef>, extension: ExtensionRef) {
+    // Recorre las extensiones que la actual recomienda deshabilitar.
+    for d in &extension.drop_extensions() {
+        // Verifica que la extensión no esté ya en la lista.
+        if !list.iter().any(|e| e.type_id() == d.type_id()) {
+            // Comprueba si la extensión está habilitada. Si es así, registra una advertencia.
+            if ENABLED_EXTENSIONS
+                .read()
+                .unwrap()
+                .iter()
+                .any(|e| e.type_id() == extension.type_id())
+            {
+                trace::warn!(
+                    "Trying to drop \"{}\" extension which is enabled",
+                    extension.short_name()
+                );
+            } else {
+                // Si la extensión no está habilitada, se añade a la lista y registra la acción.
+                list.push(*d);
+                trace::debug!("Extension \"{}\" dropped", d.short_name());
+                // Añade recursivamente las dependencias de la extensión eliminada.
+                // De este modo, todas las dependencias se tienen en cuenta para ser deshabilitadas.
+                for dependency in &extension.dependencies() {
+                    add_to_dropped(list, *dependency);
+                }
+            }
+        }
+    }
+}
+
+// INICIALIZA LAS EXTENSIONES **********************************************************************
+
+pub fn initialize_extensions() {
+    trace::info!("Calling application bootstrap");
+    for extension in ENABLED_EXTENSIONS.read().unwrap().iter() {
+        extension.initialize();
+    }
+}
+
+// CONFIGURA LOS SERVICIOS *************************************************************************
+
+pub fn configure_services(scfg: &mut service::web::ServiceConfig) {
+    for extension in ENABLED_EXTENSIONS.read().unwrap().iter() {
+        extension.configure_service(scfg);
+    }
+}