28 releases

✓ Uses Rust 2018 edition

0.2.3 May 19, 2020
0.2.2 Mar 3, 2020
0.2.1 Jan 23, 2020
0.1.20 Sep 18, 2019
0.0.0 Mar 29, 2018

#3 in HTTP server

Download history 13158/week @ 2020-03-16 14194/week @ 2020-03-23 14056/week @ 2020-03-30 11118/week @ 2020-04-06 11071/week @ 2020-04-13 11439/week @ 2020-04-20 12623/week @ 2020-04-27 13710/week @ 2020-05-04 14456/week @ 2020-05-11 15794/week @ 2020-05-18 16475/week @ 2020-05-25 20152/week @ 2020-06-01 21860/week @ 2020-06-08 21048/week @ 2020-06-15 23250/week @ 2020-06-22 19397/week @ 2020-06-29

52,595 downloads per month
Used in 85 crates (79 directly)

MIT license

285KB
6.5K SLoC

warp

GHA Build Status MIT licensed crates.io Released API docs

A super-easy, composable, web server framework for warp speeds.

The fundamental building block of warp is the Filter: they can be combined and composed to express rich requirements on requests.

Thanks to its Filter system, warp provides these out of the box:

  • Path routing and parameter extraction
  • Header requirements and extraction
  • Query string deserialization
  • JSON and Form bodies
  • Multipart form data
  • Static Files and Directories
  • Websockets
  • Access logging
  • Gzip, Deflate, and Brotli compression

Since it builds on top of hyper, you automatically get:

  • HTTP/1
  • HTTP/2
  • Asynchronous
  • One of the fastest HTTP implementations
  • Tested and correct

Example

Add warp and Tokio to your dependencies:

tokio = { version = "0.2", features = ["macros"] }
warp = "0.2"

And then get started in your main.rs:

use warp::Filter;

#[tokio::main]
async fn main() {
    // GET /hello/warp => 200 OK with body "Hello, warp!"
    let hello = warp::path!("hello" / String)
        .map(|name| format!("Hello, {}!", name));

    warp::serve(hello)
        .run(([127, 0, 0, 1], 3030))
        .await;
}

For more information you can check the docs or the examples.

Dependencies

~9–13MB
~291K SLoC