#file-server #server #command-line #host #response-headers #file

app http-serve-folder

A configurable HTTP server that hosts a folder. Suitable for local testing.

2 unstable releases

0.2.0 Dec 13, 2023
0.1.0 Jun 23, 2022

#735 in HTTP server

MIT/Apache

17KB
86 lines

Crates.io Crates.io MIT/Apache 2.0

http-serve-folder

A command line configurable, single executable server for hosting a folder over HTTP. Only intended for use in local development/testing.

I created this because no minimal servers I found supported setting custom response headers, and I needed to be able to test locally while using SharedArrayBuffer which requires certain headers to be set.

Usage

Install

You can download the latest version from the Releases page under "Assets".

Or if you have Rust installed, you can compile and install it using:

cargo install http-serve-folder

Run

To see the instructions, use the -h flag:

http-serve-folder -h

Which outputs:

A configurable HTTP server that hosts a folder. Suitable for local
testing.

Usage: http-serve-folder [OPTIONS] [DIR]

Arguments:
  [DIR]  The folder you want to host

Options:
  -H, --header <HEADERS>         Headers to add to all file responses
  -i, --ip_address <IP_ADDRESS>  The IP Address to bind to [default: 127.0.0.1]
  -p, --port <PORT>              The port number to bind to [default: 4040]
  -l, --log <LOG>                The level of logging to display [default: info] [possible values: debug, info, warn, error, off]
  -h, --help                     Print help (see more with '--help')
  -V, --version                  Print version

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~10–20MB
~274K SLoC