feat: support for old browsers with legacy-ui (#490)

- Provides support for rendering a File Explorer on non-WASM browsers,
enabled by using:

```bash
# modern (wasm powered) ui (default)
http-server start --service file-explorer
# legacy ui
http-server start --service file-server
```

- Introduces the `Handler` trait for allowing further handlers in the
future by just introducing a trait implementation. Both `FileExplorer`
and `FileServer` are `Handler` compliant.

Author: LeoBorai

Cargo.lock

@@ -7,6 +7,19 @@ members = [
 default-members = ["src/http-server"]
 resolver = "1"
 
+[workspace.package]
+authors = ["Leo Borai <[email protected]>"]
+categories = ["web-programming", "web-programming::http-server"]
+description = "Simple and configurable command-line HTTP server"
+documentation = ""
+edition = "2024"
+include = ["/ui", "/src/"]
+keywords = ["configurable", "http", "server", "serve", "static"]
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/http-server-rs/http-server"
+readme = "./README.md"
+version = "1.0.0-pre.6fa7635"
+
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [workspace.dependencies]
@@ -19,6 +32,7 @@ dirs = "5.0.1"
 futures = "0.3.31"
 gloo = "0.11.0"
 gloo-file = "0.3.0"
+handlebars = "6.3.2"
 humansize = "2.1.3"
 http = "1.1.0"
 http-body-util = "0.1"

Cargo.toml

@@ -1,15 +1,15 @@
 [package]
 name = "http-server"
-version = "1.0.0-pre.6fa7635"
-authors = ["Leo Borai <[email protected]>"]
-edition = "2021"
-description = "Simple and configurable command-line HTTP server"
-repository = "https://github.com/http-server-rs/http-server"
-categories = ["web-programming", "web-programming::http-server"]
-keywords = ["configurable", "http", "server", "serve", "static"]
-license = "MIT OR Apache-2.0"
-readme = "../../README.md"
-include = ["/ui", "/src/"]
+authors.workspace = true
+categories.workspace = true
+description.workspace = true
+documentation.workspace = true
+edition.workspace = true
+keywords.workspace = true
+include.workspace = true
+license.workspace = true
+repository.workspace = true
+version.workspace = true
 
 [[bin]]
 name = "http-server"
@@ -22,8 +22,11 @@ bytes = { workspace = true }
 chrono = { workspace = true, features = ["serde"] }
 clap = { workspace = true, features = ["env", "derive", "std"] }
 dirs = { workspace = true }
+futures = { workspace = true }
+handlebars = { workspace = true }
 http = { workspace = true }
 http-body-util = { workspace = true }
+humansize = { workspace = true }
 hyper = { workspace = true }
 hyper-util = { workspace = true, features = ["full"] }
 libloading = { workspace = true }

src/http-server/Cargo.toml

@@ -1,4 +1,4 @@
-mod start;
+pub mod start;
 
 use clap::Parser;
 

src/http-server/src/cli/command/mod.rs

@@ -1,5 +1,6 @@
 use std::net::IpAddr;
 use std::process::exit;
+use std::str::FromStr;
 use std::sync::Arc;
 
 use anyhow::Result;
@@ -12,6 +13,24 @@ use crate::server::Server;
 
 const THREAD_NAME: &str = "http-server";
 
+#[derive(Clone, Debug, Parser)]
+pub enum Service {
+    FileServer,
+    FileExplorer,
+}
+
+impl FromStr for Service {
+    type Err = String;
+
+    fn from_str(s: &str) -> std::result::Result<Self, Self::Err> {
+        match s {
+            "file-server" => Ok(Service::FileServer),
+            "file-explorer" => Ok(Service::FileExplorer),
+            _ => Err(format!("Invalid service: {}", s)),
+        }
+    }
+}
+
 #[derive(Debug, Parser)]
 pub struct StartOpt {
     /// Host (IP) to bind the server
@@ -23,6 +42,9 @@ pub struct StartOpt {
     /// Enable CORS with a permissive policy
     #[clap(long, default_value = "false")]
     pub cors: bool,
+    /// Service to run
+    #[clap(long, default_value = "file-explorer")]
+    pub service: Service,
 }
 
 impl From<&StartOpt> for Config {
@@ -31,6 +53,7 @@ impl From<&StartOpt> for Config {
             host: val.host,
             port: val.port,
             cors: val.cors,
+            service: val.service.clone().into(),
         }
     }
 }