zap

Crates.iozap
lib.rszap
version0.0.4
sourcesrc
created_at2017-10-02 15:18:21.04488
updated_at2017-11-13 16:24:35.819674
descriptionLigthing fast web framework for rust
homepage
repositoryhttps://github.com/oldaniel/zap
max_upload_size
id34179
size13,182
Daniel Oltmanns (oldaniel)

documentation

README

zap :zap:

GitHub issues GitHub stars Crates.io Crates.io

The mission of zap is, to deliver a basic, but fast rust web framework.

Documentation

About

This code is based on tokio's minihttp project, so a big thanks to them. (source)

How to use

Add the following to your Cargo.toml:

[dependencies]
zap = "0.0.4"

Speed

So zap is not only fast, it is wapping 2.96 times faster than iron, which is based on hyper. Benchmarks below:

Benchmark Code

Iron

This code had been taken from the ironframework.io webpage.

extern crate iron;

use iron::prelude::*;
use iron::status;

fn main() {
    fn hello_world(_: &mut Request) -> IronResult<Response> {
        Ok(Response::with((status::Ok, "Hello World!")))
    }

    Iron::new(hello_world).http("localhost:3000").unwrap();
}

Zap

This example can be run, by:

$ git clone https://github.com/oldaniel/zap && cd zap
$ cargo run --example hello-world --release
extern crate zap;

use std::io::Error as ZapError;
use zap::prelude::*;

struct HelloWorld;

impl Handler for HelloWorld {
    type Request = Request;
    type Response = Response;
    type Error = ZapError;
    type Future = ZapResult;

    fn call(&self, _: Request) -> ZapResult {
        let mut resp = Response::new();

        resp.body("Hello World!");

        resp.ok()
    }
}

fn main() {
    let addr = "0.0.0.0:8080".parse().unwrap();
    let mut server = Server::new(Http, addr);
    server.threads(8);
    server.serve(|| Ok(HelloWorld));
}

Benchmark Results

The benchmark results have been computed with this command: wrk -t16 -c500 -d10s http://127.0.0.1:8080 --latency

Technical details about the server:

  • Intel Core I7-6700K, hyper-threaded
  • 16GB RAM, 2400MHZ

Detailed results: in the wiki.

Iron

[...]
Requests/sec: 307581.17
Transfer/sec:     33.44MB

Zap

[...]
Requests/sec: 912832.31
Transfer/sec:     40.90MB

Todo

Some things we still need to make:

  • Make it faster
  • URL and body parsing
  • Request key storing

Credits & License

A project by Daniel Oltmanns. Other amazing contributors here.

GitHub license

Commit count: 49

cargo fmt