An optimized middleware & CLI application for serving static files~!
Clone or download
Latest commit 0ca66b1 Nov 22, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
packages v0.2.3 Nov 22, 2018
tests add stupid tests; May 14, 2018
.editorconfig import root files Apr 10, 2018
.gitignore hide “public” dir for local testing May 14, 2018
.travis.yml fix root/pkg files May 14, 2018
lerna.json v0.2.3 Nov 22, 2018
license import root files Apr 10, 2018
package.json import root files Apr 10, 2018
readme.md add benchmarks to root readme May 14, 2018
sirv-cli.png add rough readme for CLI May 14, 2018

readme.md

sirv Build Status

An optimized middleware & CLI application for serving static files~!

  • sirv
    GitHub · Package
    The core module, returning a middleware function for use in Polka & Express-like frameworks.

  • sirv-cli
    GitHub · Package
    The standalone CLI application, allowing for instant previews of static sites.

Benchmarks

All benchmarks are taken using the same Polka application on Node v8.9.0.

Please note that the actual numbers don't really matter; however, the percentage differences between them do!

File Exists

$ wrk -t8 -c100 -d10s http://localhost:3000/
serve-static
    Thread Stats   Avg      Stdev     Max   +/- Stdev
        Latency     8.74ms  596.13us  14.44ms   79.26%
        Req/Sec     1.38k    56.04     1.45k    69.62%
      109872 requests in 10.02s, 40.66MB read
    Requests/sec:  10969.49
    Transfer/sec:      4.06MB

sirv
    Thread Stats   Avg      Stdev     Max   +/- Stdev
        Latency     7.87ms    2.53ms  15.59ms   81.37%
        Req/Sec     1.53k    69.36     2.07k    71.25%
      122047 requests in 10.03s, 33.87MB read
    Requests/sec:  12174.15
    Transfer/sec:      3.38MB

File Missing

$ wrk -t8 -c100 -d10s http://localhost:3000/foobar
serve-static
    Thread Stats   Avg      Stdev     Max   +/- Stdev
        Latency     4.00ms  257.09us   7.81ms   76.04%
        Req/Sec     3.01k    65.66     3.15k    74.62%
      239800 requests in 10.01s, 26.30MB read
      Non-2xx or 3xx responses: 239800
    Requests/sec:  23962.46
    Transfer/sec:      2.63MB

sirv
    Thread Stats   Avg      Stdev     Max   +/- Stdev
        Latency     2.89ms  256.70us   6.62ms   72.19%
        Req/Sec     4.17k   157.94     4.93k    75.22%
      334715 requests in 10.10s, 44.69MB read
      Non-2xx or 3xx responses: 334715
    Requests/sec:  33130.72
    Transfer/sec:      4.42MB

License

MIT © Luke Edwards