#web #http #http-server #cli #command-line

bin+lib simplewebserver

Run a tiny HTTP server from the command line

3 releases

0.1.2 Jan 9, 2022
0.1.1 Dec 28, 2021
0.1.0 Dec 28, 2021

#292 in #http-server

MIT license

13KB
257 lines

simplewebserver

CI

A convenient, standalone web server in the style of Python's SimpleHTTPServer.

Example usage of simplewebserver

Warning: Like its Python cousin, simplewebserver is intended for development and local file sharing. It should not be used in production environments.

Design Goals

  • Simple: Easy to use CLI, with good defaults and reasonable security
  • Capable: Multithreaded service and I/O powered by Tokio
  • Tiny: Minimal binary size, while still using mature libraries and being standalone

Installation

If you have a functional Rust installation, the simplest way to install simplewebserver is from crates.io:

cargo install simplewebserver

Binaries are available in GitHub Releases. They may be extracted and run directly.

Usage

USAGE:
    simplewebserver [FLAGS] [OPTIONS] <FILE>...

FLAGS:
    -D, --dry-run      Print files which would be served and exit
    -h, --help         Prints help information
    -r, --recursive    Serve directories recursively
    -V, --version      Prints version information
    -v, --verbose      Print additional logging info

OPTIONS:
    -a, --address <address>    Serve on IP address [default: 127.0.0.1]
    -p, --port <port>          Bind to a port [default: 8080]

ARGS:
    <FILE>...    The file(s) to serve

Dependencies

~8–18MB
~226K SLoC