http-serve-folder

Crates.iohttp-serve-folder
lib.rshttp-serve-folder
version0.2.0
sourcesrc
created_at2022-06-23 23:17:19.546241
updated_at2023-12-13 00:43:40.448296
descriptionA configurable HTTP server that hosts a folder. Suitable for local testing.
homepage
repositoryhttps://github.com/paul-hansen/http-serve-folder
max_upload_size
id612117
size53,522
Paul Hansen (paul-hansen)

documentation

README

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.

Commit count: 11

cargo fmt