Revue de code et refactoring

pmoapp/src/lib.rs

@@ -239,6 +239,8 @@
 //! - [Vite Documentation](https://vitejs.dev/)
 
 use rust_embed::RustEmbed;
+use std::future::Future;
+use std::pin::Pin;
 
 /// Structure représentant l'application web embarquée.
 ///
@@ -248,16 +250,72 @@ use rust_embed::RustEmbed;
 /// ## Exemple
 ///
 /// ```rust,no_run
-/// use pmoapp::Webapp;
+/// use pmoapp::{Webapp, WebAppExt};
 /// use pmoserver::ServerBuilder;
 ///
 /// # async fn example() {
 /// let mut server = ServerBuilder::new("MyApp").build();
 ///
-/// // Ajouter la webapp comme SPA sur le chemin /app
-/// server.add_spa::<Webapp>("/app").await;
+/// // Ajouter la webapp via le trait WebAppExt
+/// server.add_webapp::<Webapp>("/app").await;
 /// # }
 /// ```
 #[derive(RustEmbed, Clone)]
 #[folder = "webapp/dist"]
 pub struct Webapp;
+
+/// Trait pour étendre un serveur HTTP avec des fonctionnalités webapp.
+///
+/// Ce trait permet à `pmoapp` d'ajouter des méthodes d'extension sur des types
+/// de serveurs externes (comme `pmoserver::Server`) sans que ces crates dépendent de `pmoapp`.
+///
+/// # Architecture
+///
+/// Similaire au pattern utilisé par `pmoupnp` pour `UpnpServer`, ce trait permet
+/// une extension propre et découplée :
+///
+/// - `pmoserver` définit un serveur HTTP générique
+/// - `pmoapp` étend ce serveur avec des méthodes webapp via ce trait
+/// - Le serveur n'a pas besoin de connaître `pmoapp`
+///
+/// # Exemple d'implémentation
+///
+/// ```ignore
+/// impl WebAppExt for pmoserver::Server {
+///     fn add_webapp<W: RustEmbed>(&mut self, path: &str) -> ... {
+///         // Délègue à la méthode interne add_spa
+///         self.add_spa::<W>(path)
+///     }
+/// }
+/// ```
+pub trait WebAppExt {
+    /// Ajoute une Single Page Application au serveur.
+    ///
+    /// # Arguments
+    ///
+    /// * `path` - Le chemin où monter la webapp (ex: "/app")
+    ///
+    /// # Type Parameter
+    ///
+    /// * `W` - Type RustEmbed contenant les fichiers de la webapp
+    fn add_webapp<W>(&mut self, path: &str) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>
+    where
+        W: RustEmbed + Clone + Send + Sync + 'static;
+
+    /// Ajoute une webapp avec une redirection automatique depuis la racine.
+    ///
+    /// # Arguments
+    ///
+    /// * `path` - Le chemin où monter la webapp (ex: "/app")
+    ///
+    /// # Type Parameter
+    ///
+    /// * `W` - Type RustEmbed contenant les fichiers de la webapp
+    fn add_webapp_with_redirect<W>(&mut self, path: &str) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>
+    where
+        W: RustEmbed + Clone + Send + Sync + 'static;
+}
+
+// Implémentation du trait pour pmoserver::Server (feature-gated)
+#[cfg(feature = "pmoserver")]
+mod pmoserver_impl;

pmoapp/src/pmoserver_impl.rs

@@ -0,0 +1,57 @@
+//! Implémentation du trait WebAppExt pour le serveur pmoserver
+//!
+//! Ce module enrichit `pmoserver::Server` avec les fonctionnalités webapp en
+//! implémentant le trait [`WebAppExt`](crate::WebAppExt). Cette implémentation
+//! permet d'enregistrer facilement des webapps embarquées sur le serveur.
+//!
+//! ## Architecture
+//!
+//! `pmoapp` étend `pmoserver::Server` sans que `pmoserver` connaisse `pmoapp`.
+//! C'est le pattern d'extension : `pmoapp` ajoute des fonctionnalités à un type
+//! externe via un trait, similaire au pattern utilisé par `pmoupnp` pour `UpnpServer`.
+//!
+//! ## Exemple d'utilisation
+//!
+//! ```rust,no_run
+//! use pmoapp::{Webapp, WebAppExt};
+//! use pmoserver::ServerBuilder;
+//!
+//! # async fn example() {
+//! let mut server = ServerBuilder::new("MyApp").build();
+//!
+//! // Le trait WebAppExt est automatiquement disponible
+//! server.add_webapp::<Webapp>("/app").await;
+//!
+//! // Ou avec redirection
+//! server.add_webapp_with_redirect::<Webapp>("/app").await;
+//! # }
+//! ```
+
+use crate::WebAppExt;
+use pmoserver::Server;
+use rust_embed::RustEmbed;
+use std::future::Future;
+use std::pin::Pin;
+
+impl WebAppExt for Server {
+    fn add_webapp<W>(&mut self, path: &str) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>
+    where
+        W: RustEmbed + Clone + Send + Sync + 'static,
+    {
+        let path = path.to_string();
+        Box::pin(async move {
+            self.add_spa::<W>(&path).await;
+        })
+    }
+
+    fn add_webapp_with_redirect<W>(&mut self, path: &str) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>
+    where
+        W: RustEmbed + Clone + Send + Sync + 'static,
+    {
+        let path = path.to_string();
+        Box::pin(async move {
+            self.add_spa::<W>(&path).await;
+            self.add_redirect("/", &path).await;
+        })
+    }
+}