Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oltdaniel/zap
:zap: fast http framework for rust
https://github.com/oltdaniel/zap
efficiency http rust web-framework
Last synced: 3 months ago
JSON representation
:zap: fast http framework for rust
- Host: GitHub
- URL: https://github.com/oltdaniel/zap
- Owner: oltdaniel
- License: mit
- Archived: true
- Created: 2017-10-02T08:54:05.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-13T14:54:57.000Z (over 6 years ago)
- Last Synced: 2024-04-14T17:02:33.782Z (9 months ago)
- Topics: efficiency, http, rust, web-framework
- Language: Rust
- Homepage: https://docs.rs/zap
- Size: 38.1 KB
- Stars: 51
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-cn - oltdaniel/zap - ci.org/oltdaniel/zap.svg?branch=master">](https://travis-ci.org/oltdaniel/zap) (Libraries / Web programming)
- awesome-rust - oltdaniel/zap - ci.org/oltdaniel/zap.svg?branch=master">](https://travis-ci.org/oltdaniel/zap) (Libraries / Web programming)
README
# `zap` :zap:
[](https://github.com/oltdaniel/zap/issues)
[](https://travis-ci.org/oltdaniel/zap)
[](https://github.com/oltdaniel/zap)
[](https://crates.io/crates/zap)
[](https://crates.io/crates/zap)
The mission of `zap` is, to deliver a basic, but fast rust web server library.
[Documentation](https://docs.rs/zap/)
## About
**This code is based on tokio's minihttp project, so a big thanks to them.** ([source](https://github.com/tokio-rs/tokio-minihttp))
The goal of this project is, to show how fast Rust can be. It isn't made for huge complex applications, just a test project for benchmark reasons.
## How to use
Add the following to your `Cargo.toml`:
```toml
[dependencies]
zap = "0.0.4"
```
## Speed
So `zap` is not only fast, it is wapping **2.96** times faster than [iron](https://github.com/iron/iron), which is based on [hyper](https://github.com/hyperium/hyper). Benchmarks below:
### Benchmark Code
**Iron**
This code had been taken from the [ironframework.io](http://ironframework.io) webpage.
```rust
extern crate iron;
use iron::prelude::*;
use iron::status;
fn main() {
fn hello_world(_: &mut Request) -> IronResult {
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/oltdaniel/zap && cd zap
$ cargo run --example hello-world --release
```
```rust
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](https://github.com/oltdaniel/zap/wiki/Benchmarks).
**Iron**
```
[...]
Requests/sec: 307581.17
Transfer/sec: 33.44MB
```
**Zap**
```
[...]
Requests/sec: 912832.31
Transfer/sec: 40.90MB
```
## Credits & License
[Daniel Oltmanns](https://github.com/oltdaniel) & [others](https://github.com/oltdaniel/zap/graphs/contributors)
_Basically do what you'd like to._
[](https://github.com/oltdaniel/zap/blob/master/LICENSE)