35 releases

0.3.3 Sep 27, 2022
0.3.2 Nov 9, 2021
0.3.1 Mar 25, 2021
0.2.5 Aug 31, 2020
0.0.0 Mar 29, 2018

#4 in HTTP server

Download history 102987/week @ 2022-11-30 87149/week @ 2022-12-07 76063/week @ 2022-12-14 55629/week @ 2022-12-21 44590/week @ 2022-12-28 69123/week @ 2023-01-04 72617/week @ 2023-01-11 84151/week @ 2023-01-18 83649/week @ 2023-01-25 81276/week @ 2023-02-01 76668/week @ 2023-02-08 72919/week @ 2023-02-15 77465/week @ 2023-02-22 77942/week @ 2023-03-01 84401/week @ 2023-03-08 70525/week @ 2023-03-15

323,103 downloads per month
Used in 441 crates (368 directly)

MIT license

315KB
6.5K SLoC

warp

crates.io Released API docs MIT licensed GHA Build Status Discord chat

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 = "1", features = ["full"] }
warp = "0.3"

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–19MB
~356K SLoC