picoserve

picoserve is a simple 0-dependency HTTP server that just serves files. There's no authentication, no caching control, no uploading, and so on. You can just GET files and, optionally, index directories for viewing.

Installation

$ cargo install --git https://github.com/zeylahellyer/picoserve

Usage

Start the pico server, which will by default serve the current directory and bind to 127.0.0.1:5555:

$ picoserve
= Listening on 127.0.0.1:5555
= Serving /Users/zeyla/dev/picoserve

You can then GET files:

$ http get 127.0.0.1:5555/Cargo.toml
HTTP/1.1 200 OK
Content-Length: 479
Content-Type: text/plain
Server: picoserve/0.1.0

[package]
authors = ["Zeyla Hellyer <zeyla@hellyer.dev>"]
categories = ["command-line-utilities"]
description = "Get setup with serving a directory quickly."
documentation = "https://github.com/zeylahellyer/picoserve"
edition = "2018"
include = ["src/**/*.rs", "Cargo.toml"]
keywords = ["http server"]
license = "ISC"
name = "picoserve"
readme = "README.md"
repository = "https://github.com/zeylahellyer/picoserve.git"
version = "0.1.0"

[dev-dependencies]
rusty-hook = "0.11.2"

You can index directories for browser viewing on port 8080:

$ picoserve --index --port 8080
= Listening on 127.0.0.1:8080
= Serving /Users/zeyla/dev/picoserve
= Indexing directories for browser file listing

Flags

• --host <value>: set the host to bind to
• --port <value>: set the port to bind to
• --dir <value>: path to the directory to serve
• --index: enable an index for browser viewing

License

ISC.