feat: file explorer

Implements `FileExplorer`. A file system explorer for the "root_dir"
(the root directory specified when running the HTTP server).

The `FileExplorer` list directory files and serves HTML, CSS, JavaScript,
and WASM files. Other files are returned as binary files (prompt for download).

Author: LeoBorai

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "http-server"
-version = "0.1.0"
+version = "0.0.9"
 authors = ["Esteban Borai <estebanborai@gmail.com>"]
 edition = "2018"
 license = "MIT"
@@ -12,4 +12,7 @@ categories = ["authentication", "encoding", "web-programming", "web-programming:
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
+ascii = "0.8"
 clap = "2.33.3"
+mime_guess = "2.0"
+tiny_http = "0.6"

Cargo.toml

@@ -4,8 +4,8 @@ use clap::{crate_version, App};
 /// Creates a CLAP `App` instance
 pub fn make_app() -> App<'static, 'static> {
     App::new("http-server")
-        .author("Esteban Borai (https://github.com/EstebanBorai)")
         .about("A simple, zero-configuration command-line HTTP server")
+        .author("Authors: https://github.com/EstebanBorai/http-server/blob/main/AUTHORS")
         .version(crate_version!())
         .setting(clap::AppSettings::ColoredHelp)
         .args(&make_args())

src/cli/app.rs

@@ -7,16 +7,21 @@ use clap::Arg;
 /// the element `1` represents the `long` name.
 pub type CommandLineOption<'a> = (&'a str, &'a str);
 
+/// The address to bind the HTTP server to
 pub const ADDRESS: CommandLineOption = ("a", "address");
+/// The port to bind the HTTP server to
 pub const PORT: CommandLineOption = ("p", "port");
+/// The root directory to serve files from
+pub const ROOT_DIR: CommandLineOption = ("", "root_dir");
+/// If `true` every output will not be logged
 pub const SILENT: CommandLineOption = ("s", "silent");
 
 trait IntoArg {
-    /// Creates a `clap::Arg` from a `CommandLineOption`
-    /// where the element at index `0` of the tuple will be the `short`
-    /// argument name and the element at index `1` will be the `long`
-    /// argument name
+    /// Creates an argument with the `short` and `long` names
+    /// defined in the `CommandLineOption` tuple
     fn into_arg(&self) -> Arg<'static, 'static>;
+    /// Creates a positional argument with the provided `index` and `name`
+    fn into_positional(&self, index: u64) -> Arg<'static, 'static>;
 }
 
 impl IntoArg for CommandLineOption<'static> {
@@ -25,6 +30,10 @@ impl IntoArg for CommandLineOption<'static> {
             .short(self.0)
             .long(self.1)
     }
+
+    fn into_positional(&self, index: u64) -> Arg<'static, 'static> {
+        Arg::with_name(self.1).index(index).required(false)
+    }
 }
 
 /// Creates and returns a vector of `Arg` instances
@@ -42,6 +51,9 @@ pub fn make_args() -> Vec<Arg<'static, 'static>> {
             .takes_value(true)
             .default_value("7878")
             .validator(validate_port),
+        ROOT_DIR
+            .into_positional(1)
+            .help("Directory to serve files from"),
         SILENT.into_arg().help("Disable outputs").takes_value(false),
     ]
 }

src/cli/args.rs

@@ -13,8 +13,9 @@ pub fn validate_address(value: String) -> Result<(), String> {
 pub fn validate_port(value: String) -> Result<(), String> {
     match value.parse::<u16>() {
         Ok(_) => Ok(()),
-        Err(_) => Err(format!(
+        Err(_) => Err(
             "The provided value must be a number and must be a 16-bit integer (maximum: 65535)"
-        )),
+                .to_string(),
+        ),
     }
 }

src/cli/validator.rs

@@ -1,6 +1,8 @@
-use crate::cli::{ADDRESS, PORT, SILENT};
+use crate::cli::{ADDRESS, PORT, ROOT_DIR, SILENT};
 use clap::App;
+use std::env::current_dir;
 use std::net::{IpAddr, SocketAddr};
+use std::path::PathBuf;
 use std::str::FromStr;
 
 /// Configuration for the HTTP/S Server
@@ -9,8 +11,8 @@ pub struct Config {
     pub address: IpAddr,
     pub port: u16,
     pub socket_address: SocketAddr,
+    pub root_dir: PathBuf,
     pub silent: bool,
-    // pub input: PathBuf,
 }
 
 impl From<App<'static, 'static>> for Config {
@@ -19,13 +21,20 @@ impl From<App<'static, 'static>> for Config {
         let address = IpAddr::from_str(matches.value_of(ADDRESS.1).unwrap()).unwrap();
         let port = matches.value_of(PORT.1).unwrap().parse::<u16>().unwrap();
         let socket_address = SocketAddr::new(address, port);
+        let root_dir = if let Some(root_dir) = matches.value_of(ROOT_DIR.1) {
+            PathBuf::from_str(root_dir).unwrap()
+        } else {
+            current_dir().unwrap()
+        };
+
         let silent = matches.is_present(SILENT.1);
 
         // at this point the values provided to the config are validated by the CLI
         Self {
             address,
             port,
             socket_address,
+            root_dir,
             silent,
         }
     }