4 releases (2 stable)
Uses old Rust 2015
1.0.1 | Feb 3, 2022 |
---|---|
1.0.0 | May 17, 2018 |
0.3.0 | Feb 2, 2018 |
0.2.0 | Jan 24, 2018 |
#264 in #tiny
42KB
229 lines
Servy
A tiny little web server
What is servy?
Well it's a tiny little web server written in rust.
It's a single binary with only a few flags meant to be analogous to python -m http.server
Important Note
By default servy starts on the ipv6 interface by using the host string [::1]
If you want to start it on the ipv4 interface use a ipv4 host string (see below)
Usage
servy
Start a web server on port 8000
servy my/dir
Start a web server using my/dir
as root directory
servy -p 8080
Start servy on port 8080
servy -h 127.0.0.1
Start servy with host string 127.0.0.1 (start on the ipv4 loopback interface)
servy -v
Use verbose output (print out a debug message every time a connection is made)
servy --help
Print the help message
Stuff inside
Servy in built on top of hyper. I like it because it's small and simple, compared to larger frameworks, without being unwieldy.
Benchmarks (cuz why not)
As servy is built on tokio-minihttp it's quite fast.
On my laptop with an Intel Core i7-4700MQ @ 2.4GHz with 16GB of RAM
When I run wrk -c 200 -d 10 -t 20 http://\[::1\]:8000/Cargo.toml
I get
Running 10s test @ http://[::1]:8000/Cargo.toml
20 threads and 200 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 1.87ms 1.20ms 205.06ms 99.30%
Req/Sec 5.40k 449.11 11.21k 93.31%
1084315 requests in 10.10s, 261.62MB read
Requests/sec: 107361.59
Transfer/sec: 25.90MB
For comparision running the same test on python -m http.server
on Python 3.6.4
Running 10s test @ http://0.0.0.0:8000/Cargo.toml
20 threads and 200 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 10.13ms 72.55ms 1.68s 97.76%
Req/Sec 371.84 314.60 1.94k 76.29%
20260 requests in 10.08s, 10.55MB read
Socket errors: connect 0, read 0, write 0, timeout 17
Requests/sec: 2009.57
Transfer/sec: 1.05MB
Contributing
If you run into any issues, have any suggestions on improvements, on even a pull request, shot it my way. All feedback is welcome and appreciated!
Dependencies
~9.5MB
~152K SLoC