• Features:
  • Re-implement addr::remote() filter from v0.3.x.
  • Implement From<&'static [u8]> for Body.
  • Add reply::stream() helper.
• Fixes:
  • Fix returning error from CORS if no request-method header.

• Features:
  • Add support for passing UnixListener to incoming(listener).
• Fixes:
  • Reduce some dependencies when server is not enabled.

Fixes:

• Fix Server::graceful() bounds incorrect requiring the filter to be a future.
• Enable tokio/net when the server feature is enabled.
• Render cfgs in the docs.

Full Changelog: v0.4.0...v0.4.1

• Fixes:
  • Fix Server::graceful() bounds incorrect requiring the filter to be a future.
  • Enable tokio/net when the server feature is enabled.
  • Render cfgs in the docs.

v0.4.0 (August 5, 2025)

• Changes:
  • Upgrade to hyper, http, and http-body to v1.
  • Remove multipart and websocket features from being enabled by default.
  • Put warp::serve() behind a server feature, not enabled by default.
  • Put warp::test behind a test feature, not enabled by default.
  • Remove tls feature and types.
  • Remove warp::addr filters.

Changes:

• Upgrade to hyper, http, and http-body to v1.
• Remove multipart and websocket features from being enabled by default.
• Put warp::serve() behind a server feature, not enabled by default.
• Put warp::test behind a test feature, not enabled by default.
• Remove tls feature and types.
• Remove warp::addr filters.

Full Changelog: v0.3.7...v0.4.0

tl;dr

• Features:
  • Add ecc private key support to tls() config.
• Fixes:
  • Several dependency upgrades.

What's Changed

• deps: move rustls-pemfile crate to tls feature by @tottoto in #1069
• ECC private keys support for tls feature by @joseluisq in #1048
• Fix cargo minimal-versions check by @Finomnis in #1078
• deps: remove unused tokio-stream dependency by @tottoto in #1079
• deps: update to rustls 0.22 by @tottoto in #1081
• multipart: fallback to filename as part name by @wca in #1045
• deps: update tokio-tungstenite, tracing-log and async-compression dependency by @tottoto in #1085
• update to use handlebars v5 by @campeis in #1087
• style: clean up new rustc warnings by @seanmonstar in #1097
• ci: single required job by @seanmonstar in #1098

New Contributors

• @Finomnis made their first contribution in #1078
• @wca made their first contribution in #1045

Full Changelog: v0.3.6...v0.3.7

• Features:
  • Add ecc private key support to tls() config.
• Fixes:
  • Several dependency upgrades.

Features

• Add ability to pass None to multipart::form().max_length().
• Implement Reply for Result<impl Reply, impl Reply>.
• Make multipart::Part::content_type() return the full mime string.
• Add TlsServer::try_bind_with_graceful_shutdown().

Fixes

• Updated tungstenite and rustls dependencies for security fixes.

New Contributors

• @jnicholls made their first contribution in #717
• @kouta-kun made their first contribution in #1044
• @tottoto made their first contribution in #1043
• @aedmondson made their first contribution in #1046
• @outamaa made their first contribution in #919
• @louiseyousre200 made their first contribution in #1056
• @nickbp made their first contribution in #1061
• @vitorenesduarte made their first contribution in #1064
• @AldaronLau made their first contribution in #1063
• @belgoking made their first contribution in #1062

• Features:
  • Add ability to pass None to multipart::form().max_length().
  • Implement Reply for Result<impl Reply, impl Reply>.
  • Make multipart::Part::content_type() return the full mime string.
  • Add TlsServer::try_bind_with_graceful_shutdown().
• Fixes:
  • Updated tungstenite and rustls dependencies for security fixes.

Fixes

• multipart filters now use multer dependency, fixing some streaming bugs.
• Rejection::into_response() is significantly faster.

New Contributors

• @jaysonsantos made their first contribution in #1033
• @alexeiakimov made their first contribution in #1005

• Fixes:
  • multipart filters now use multer dependency, fixing some streaming bugs.
  • Rejection::into_response() is significantly faster.

Fixes

• multipart::Part data is now streamed instead of buffered.
• Update dependency used for multipart filters.

New Contributors

• @baum made their first contribution in #1028
• @urkle made their first contribution in #1011

• Fixes:
  • multipart::Part data is now streamed instead of buffered.
  • Update dependency used for multipart filters.

• Fixes:
  • Fix fs filters path sanitization to reject colons on Windows.

• Fixes:
  • Fix fs filters path sanitization to reject colons on Windows.

Features:

• Add Filter::then(), which is like Filter::map() in that it's infallible, but is async like Filter::and_then().
• Add redirect::found() reply helper that returns 302 Found.
• Add compression-brotli and compression-gzip cargo features to enable only the compression you need.
• Allow HEAD requests to be served to fs::dir() filters.
• Allow path!() with no arguments.

Fixes:

• Update private dependencies Tungstenite and Multipart.
• Replaces uses of futures with futures-util, which is a smaller dependency.

New Contributors

• @viraptor made their first contribution in #825
• @zenria made their first contribution in #835
• @Aankhen made their first contribution in #849
• @FlorianDr made their first contribution in #843
• @adamchalmers made their first contribution in #858
• @ekzhang made their first contribution in #860
• @utkarshkukreti made their first contribution in #696
• @johannescpk made their first contribution in #861
• @sindreij made their first contribution in #864
• @haileys made their first contribution in #701
• @In-line made their first contribution in #836
• @0xdeafbeef made their first contribution in #839
• @emesterhazy made their first contribution in #866
• @joseluisq made their first contribution in #869
• @JasterV made their first contribution in #873
• @aujxn made their first contribution in #876
• @simonborje made their first contribution in #883
• @yaymukund made their first contribution in #885
• @SeanChao made their first contribution in #890
• @e-user made their first contribution in #877
• @gtsiam made their first contribution in #878
• @bkgood made their first contribution in #896
• @nylonicious made their first contribution in #906
• @some-dood made their first contribution in #912

• Features:
  • Add Filter::then(), which is like Filter::map() in that it's infallible, but is async like Filter::and_then().
  • Add redirect::found() reply helper that returns 302 Found.
  • Add compression-brotli and compression-gzip cargo features to enable only the compression you need.
  • Allow HEAD requests to be served to fs::dir() filters.
  • Allow path!() with no arguments.
• Fixes:
  • Update private dependencies Tungstenite and Multipart.
  • Replaces uses of futures with futures-util, which is a smaller dependency.

• Features:
  • Add pong constructor to websocket messages.
  • Add redirect::see_other and redirect::permanent helpers.
• Fixes:
  • Fix fs filters sometimes having an off-by-one error with range requests.
  • Fix CORS to allow spaces when checking Access-Control-Request-Headers.

v0.3.0 (January 19, 2021)

• Features:
  • Add TLS client authentication support.
  • Add TLS OCSP stapling support.
  • Add From<Reject> for Rejection.
  • Add close_frame accessor to ws::Message.
• Changes:
  • Update to Tokio v1.
  • Update to Bytes v1.
  • Update to hyper v0.14.
  • Rework sse filter to be more like ws, with a single Event type and builder.
  • Change cookie filter to extract a generic FromStr value.

• Features:
  • Add wrap_fn, which can be used to create a Wrap from a closure. These in turn are used with Filter::with().
  • Add warp::host filters to deal with Host/:authority headers.
  • Relax some lifetime bounds on Server.
• Fixes:
  • Fix panic when URI doesn't have a slash (for example, CONNECT foo.bar).

• Features:
  • Add tracing internals in place of log (log is still emitted for backwards compatibility).
  • Add warp::trace module set of filters to customize tracing dianostics.
  • Add path method to warp::fs::File reply.
  • Add source implementation for BodyDeserializeError.
  • Make warp::ws::MissingConnectionUpgrade rejection public.

• Features:
  • Add warp::compression filters, which will compress response bodies.
  • Add warp::header::value() filter to get a request HeaderValue.
  • Add request_headers method to warp::log::Info.
  • Add max_frame_size to warp::ws::Ws builder.
  • Add remote_addr to warp::test::RequestBuilder.
  • Add try_bind_with_graceful_shutdown to warp::Server builder.
  • Add serve_incoming_with_graceful_shutdown to warp::Server builder.
• Fixes:
  • Fix warp::addr::remote when used with Server::tls.
  • Fix panic in warp::path::{peek, tail, full} filters when the request URI is in authority-form or asterisk-form.

• Features:
  • Implement Reply for all Box<T> where T: Reply.
  • Add name methods to MissingHeader, InvalidHeader, and MissingCookie rejections.
  • Add warp::ext::optional() filter that optionally retrieves an extension from the request.
• Fixes:
  • Fix the sending of pings when a user sends a ws::Message::ping().

• Features:
  • Add close and close_with constructors to warp::ws::Message.
• Fixes:
  • Fix warp::fs filters using a very small read buffer.

v0.2.0 (January 16, 2020)

• Features:
  • Update to std::future, adding async/await support!
  • Add warp::service() to convert a Filter into a tower::Service.
  • Implement Reply for Box<dyn Reply>.
• Changes:
  • Refactored Rejection system (#311).
  • Change path! macro to assume a path::end() by default, with explicit / .. to allow building a prefix (#359).
  • Change warp::path(str) to accept any AsRef<str> argument.
  • Rename "2"-suffixed filters and types (get2 to get, ws2 to ws, etc).
  • Filter::{or, or_else, recover} now require Self::Error=Rejection. This helps catch filters that didn't make sense (like warp::any().or(warp::get())).
  • Change several warp::body filters (#345).
  • Change warp::cors() to return a warp::cors::Builder which still implements Wrap, but can also build a cheaper-to-clone wrapper.
  • Change warp::multipart stream API to allow for errors when streaming.
  • Change warp::sse to no longer return a Filter, adds warp::sse::reply to do what Sse::reply did.
  • Change Server::tls() to return a TLS server builder (#340).
  • Change internal warp::never::Never usage with std::convert::Infallible.
  • Remove warp::ext::set() function (#222).
  • Remove deprecated warp::cookie::optional_value().

• Features:
  • Implement Clone for the warp::cors filter.
  • Add into_bytes method for warp::ws::Message.

• Features:
  • Make warp::multipart and wrap::ws support optional, though enabled by default.
• Fixes:
  • Fix warp::fs::dir filter to reject paths containing backslashes.

• Features:
  • Add warp::multipart support.

• Features:
  • Export all built-in Rejection causes in the warp::reject module.
  • Add Server::try_bind as fallible bind methods.

• Features:
  • Unseal the Reply trait: custom types can now implement Reply.
  • Add warp::sse::keep_alive() replacement for warp::sse::keep() which allows customizing keep-alive behavior.
  • Add warp::log::Info::host() accessor.
• Fixes:
  • Fix warp::fs filters from sending some headers for 304 responses.

• Features:
  • Add more accessors to warp::log::Info type for building custom log formats.
  • Implement Reply for Cow<'static, str>.

• Features:
  • Add warp::header::optional filter.

• Features:
  • Implement Reply for Vec<u8> and &'static [u8].
  • Set content-type header automatically for string and bytes replies.
  • Add expose_headers to warp::cors filter.

• Features:
  • Implement PartialEq, Eq, and Clone for warp::ws::Message.
• Fixes:
  • Fix panic when incoming request URI may not have a path (such as CONNECT requests).

• Features:
  • Add warp::sse filters for handling Server-Sent-Events.
  • Add allow_headers to warp::cors filter.
• Fixes:
  • Fix TLS handshake to close the connection if handshake fails.

• Features:
  • Add optional TLS support. Enable the tls feature, and then use Server::tls.
  • Add warp::cors filter for CORS support.
  • Add warp::addr::remote to access the remote address of a request.
  • Add warp::log::custom to support customizing of access logging.
  • Add warp::test::ws to improve testing Websocket filters.

• Features:
  • Add warp::ext::get and warp::ext::set to set request extensions.
  • Add Filter::untuple_one to unroll nested tuple layers from extractions.
  • Add Ws2::max_send_queue configuration method.
  • Add ws::Message::is_ping method, and yield pings to user code.
• Fixes:
  • Fix panic in debug mode when receiving a websocket ping.

• Features:

  • Improved flexibility of Rejection system.

    The Rejection type can now nest and combine arbitrary rejections, so it is no longer bound to a small set of meanings. The ranking of status codes is still used to determine which rejection gets priority.

    A different priority can be implemented by handling rejections with a Filter::recover, and searching for causes in order via Rejection::find_cause.

    • Adds warp::reject::custom() to create a Rejection with any Into<Box<std::error::Error>>. These rejections should be handled with an eventual Filter::recover. Any unhandled custom rejections are considered a server error.
    • Deprecates Rejection::with. Use custom rejections instead.
    • Deprecates Rejection::into_cause, as it can no longer work. Always returns Err(Rejection).
    • Deprecates Rejection::json, since the format needed is too generic. The errors.rs example shows how to send custom JSON when recovering from rejections.
    • Deprecates warp::reject(), since it current signals a 400 Bad Request, but in newer versions, it will signal 404 Not Found. It's deprecated simply to warn that the semantics are changing, but the function won't actually go away.
    • Deprecates reject::bad_request(), reject::forbidden(), and reject::server_error(). Uses custom rejections instead.

  • Renamed warp::path::index to warp::path::end.

• Features:

  • Export the types returned from the warp::body::stream() filter, BodyStream and StreamBuf.
  • Deprecated Rejection::into_cause, since an upcoming Rejection refactor will make it impossible to support.

• Fixes:

  • Fix websocket filters to do a case-insensitive match of the Connection header.

• Features:
  • Add Conditional and Range request support for warp::fs filters.
  • Relaxed bounds on Rejection::with to no longer need to be Sized.
  • Add warp::path::peek() which gets the unmatched tail without adjusting the currently matched path.

• Features:

  • Serve index.html automatically with warp::fs::dir filter.
  • Include last-modified header with warp::fs filters.
  • Add warp::redirect to easily reply with redirections.
  • Add warp::reply::{with_status, with_header} to wrap impl Replys directly with a new status code or header.
  • Add support for running a warp Server with a custom source of incoming connections.
    • Server::run_incoming to have the runtime started automatically.
    • Server::serve_incoming to get a future to run on existing runtime.
    • These can be used to support Unix Domain Sockets, TLS, and other transports.
  • Add Rejection::into_cause() to retrieve the original error of a rejection back.
  • Add Rejection::json() to convert a rejection into a JSON response.

• Fixes

  • Internal errors in warp that result in rendering a 500 Internal Server Error are now also logged at the error level.

• Features:
  • Add warp::reply::with::headers(HeaderMap) filter wrapper.
  • Add warp::cookie::optional() to get an optional cookie value.
  • Add warp::path::full() to be able to extract the full request path without affecting route matching.
  • Add graceful shutdown support to the Server.
  • Allow empty query strings to be treated as for warp::query().

• Features:
  • Add warp::reject::forbidden() to represent 403 Forbidden responses.
  • Add Rejection::with(cause) to customize rejection messages.
• Fixes:
  • Fix warp::body::form to allow charsets in the content-type header.

• Features:
  • Implemented Reply for Response<impl Into<hyper::Body>, allowing streaming response bodies.
  • Add warp::body::stream() filter to access the request body as an impl Stream.
  • Add warp::ws2() as a more flexible websocket filter.
    • This allows passing other extracted values to the upgrade callback, such as a value from a header or path.
    • Deprecates warp::ws(), and ws2() will become ws() in 0.2.
  • Add warp::get2(), warp::post2(), warp::put2(), and warp::delete2() as more standard method filters that are used via chaining instead of nesting.
    • get(), post(), put(), and delete() are deprecated, and the new versions will become them in 0.2.
  • Add Filter::unify() for when a filter returns Either<T, T>, converting the Either into the inner T, regardless of which variant it was.

    • This requires that both sides of the Either be the same type.

    • This can be useful when extracting a value that might be present in different places of the request.

      // Allow `MyId` to be a path parameter or a header...
      let id = warp::path::param::<MyId>()
          .or(warp::header::<MyId>())
          .unify();
      
      // A way of providing default values...
      let dnt = warp::header::<bool>("dnt")
          .or(warp::any().map(|| true))
          .unify();
      

  • Add content-type header automatically to replies from file and dir filters based on file extension.
  • Add warp::head(), warp::options(), and warp::patch() as new Method filters.
  • Try to use OS blocksize in warp::fs filters.
• Fixes:
  • Chaining filters that try to consume the request body will log that the body is already consumed, and return a 500 Internal Server Error rejection.

• Features:
  • Add warp::query::raw() filter to get query as a String.
  • Add Filter::recover() to ease customizing of rejected responses.
  • Add warp::header::headers_clone() filter to get a clone of request's HeaderMap.
  • Add warp::path::tail() filter to get remaining "tail" of the request path.
• Fixes:
  • URL decode path segments in warp::fs filters.

v0.1.0 (August 1, 2018)

• Initial release.