diff --git a/actix-web-lab-derive/Cargo.toml b/actix-web-lab-derive/Cargo.toml index 7cb42247..ced1aa04 100644 --- a/actix-web-lab-derive/Cargo.toml +++ b/actix-web-lab-derive/Cargo.toml @@ -24,7 +24,7 @@ quote = "1" syn = { version = "1", features = ["full", "parsing"] } [dev-dependencies] -actix-web-lab = "=0.19.0" +actix-web-lab = "=0.19.1" actix-test = "0.1" actix-web = "4" diff --git a/actix-web-lab/CHANGELOG.md b/actix-web-lab/CHANGELOG.md index 56ec0892..228412ca 100644 --- a/actix-web-lab/CHANGELOG.md +++ b/actix-web-lab/CHANGELOG.md @@ -2,6 +2,8 @@ ## Unreleased - 2022-xx-xx +## 0.19.1 - 2023-02-26 + - Add `Host` extractor. ## 0.19.0 - 2023-02-19 diff --git a/actix-web-lab/Cargo.toml b/actix-web-lab/Cargo.toml index ced738d0..3ce16fa2 100644 --- a/actix-web-lab/Cargo.toml +++ b/actix-web-lab/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "actix-web-lab" -version = "0.19.0" +version = "0.19.1" description = "In-progress extractors and middleware for Actix Web" authors = ["Rob Ede "] keywords = ["actix", "http", "web", "framework", "async"] diff --git a/actix-web-lab/README.md b/actix-web-lab/README.md index 3bd68d87..84be8881 100644 --- a/actix-web-lab/README.md +++ b/actix-web-lab/README.md @@ -3,10 +3,10 @@ > Experimental extractors, middleware, and other extras for possible inclusion in Actix Web. [![crates.io](https://img.shields.io/crates/v/actix-web-lab?label=latest)](https://crates.io/crates/actix-web-lab) -[![Documentation](https://docs.rs/actix-web-lab/badge.svg)](https://docs.rs/actix-web-lab/0.19.0) +[![Documentation](https://docs.rs/actix-web-lab/badge.svg)](https://docs.rs/actix-web-lab/0.19.1) ![MIT or Apache 2.0 licensed](https://img.shields.io/crates/l/actix-web-lab.svg)
-[![dependency status](https://deps.rs/crate/actix-web-lab/0.19.0/status.svg)](https://deps.rs/crate/actix-web-lab/0.19.0) +[![dependency status](https://deps.rs/crate/actix-web-lab/0.19.1/status.svg)](https://deps.rs/crate/actix-web-lab/0.19.1) [![Download](https://img.shields.io/crates/d/actix-web-lab.svg)](https://crates.io/crates/actix-web-lab) [![CircleCI](https://circleci.com/gh/robjtede/actix-web-lab/tree/main.svg?style=shield)](https://circleci.com/gh/robjtede/actix-web-lab/tree/main) @@ -16,74 +16,74 @@ ### Responders -- `Csv`: efficient CSV streaming [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.Csv.html) -- `NdJson`: efficient NDJSON streaming [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.NdJson.html) -- `DisplayStream`: efficient line-by-line `Display` streaming [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.DisplayStream.html) -- `Html`: basic string wrapper that responds with HTML Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.Html.html) -- `Cbor`: basic CBOR format wrapper with appropriate Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.Cbor.html) -- `MessagePack`: basic MessagePack format wrapper with appropriate Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/respond/struct.MessagePack.html) -- `Sse`: semantic server-sent events (SSE) responder with a channel-like interface [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/sse/index.html) +- `Csv`: efficient CSV streaming [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.Csv.html) +- `NdJson`: efficient NDJSON streaming [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.NdJson.html) +- `DisplayStream`: efficient line-by-line `Display` streaming [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.DisplayStream.html) +- `Html`: basic string wrapper that responds with HTML Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.Html.html) +- `Cbor`: basic CBOR format wrapper with appropriate Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.Cbor.html) +- `MessagePack`: basic MessagePack format wrapper with appropriate Content-Type [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/respond/struct.MessagePack.html) +- `Sse`: semantic server-sent events (SSE) responder with a channel-like interface [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/sse/index.html) ### Middleware -- `from_fn`: use an async function as a middleware [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/fn.from_fn.html) -- `map_response`: use an async function to modify the response [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/fn.map_response.html) -- `map_response_body`: use an async function to modify the response body [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/fn.map_response_body.html) -- `RedirectHttps`: middleware to redirect traffic to HTTPS if connection is insecure with optional HSTS [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.RedirectHttps.html) -- `redirect_to_www`: function middleware to redirect traffic to `www.` if not already there [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/fn.redirect_to_www.html) -- `ErrorHandlers`: alternative error handler middleware with simpler interface [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.ErrorHandlers.html) -- `NormalizePath`: alternative path normalizing middleware with redirect option [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.NormalizePath.html) -- `CatchPanic`: catch panics in wrapped handlers and middleware, returning empty 500 responses [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.CatchPanic.html) -- `PanicReporter`: catch panics in wrapped handlers and middleware, returning empty 500 responses [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.PanicReporter.html) -- `LoadShed`: sheds load when the inner service isn't ready [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/middleware/struct.LoadShed.html) +- `from_fn`: use an async function as a middleware [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/fn.from_fn.html) +- `map_response`: use an async function to modify the response [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/fn.map_response.html) +- `map_response_body`: use an async function to modify the response body [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/fn.map_response_body.html) +- `RedirectHttps`: middleware to redirect traffic to HTTPS if connection is insecure with optional HSTS [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.RedirectHttps.html) +- `redirect_to_www`: function middleware to redirect traffic to `www.` if not already there [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/fn.redirect_to_www.html) +- `ErrorHandlers`: alternative error handler middleware with simpler interface [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.ErrorHandlers.html) +- `NormalizePath`: alternative path normalizing middleware with redirect option [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.NormalizePath.html) +- `CatchPanic`: catch panics in wrapped handlers and middleware, returning empty 500 responses [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.CatchPanic.html) +- `PanicReporter`: catch panics in wrapped handlers and middleware, returning empty 500 responses [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.PanicReporter.html) +- `LoadShed`: sheds load when the inner service isn't ready [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/middleware/struct.LoadShed.html) ### Extractors -- `LazyData`: app data/state initialized on first use [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.LazyData.html) -- `SwapData`: app data/state that can be replaced at runtime (alternative to `Data>`) [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.SwapData.html) -- `LocalData`: app data/state that uses an `Rc` internally, avoiding atomic overhead (alternative to `Data>`) [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.LocalData.html) -- `Json`: simplified JSON extractor with const-generic payload limits [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.Json.html) -- `Path`: simplified path parameter extractor that supports destructuring [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.Path.html) -- `Query`: simplified query-string extractor that can also collect multi-value items [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.Query.html) -- `RequestSignature`: wraps an extractor and calculates a request signature alongside [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.RequestSignature.html) -- `BodyLimit`: wraps a body extractor and prevents DoS attacks by limiting payload size [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.BodyLimit.html) -- `Bytes`: simplified Bytes extractor with const-generic limits [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.Bytes.html) -- `UrlEncodedForm`: URL-encoded form extractor with const-generic payload size limit [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.UrlEncodedForm.html) -- `Host`: Host information taken from either URL or Host header [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/extract/struct.Host.html) +- `LazyData`: app data/state initialized on first use [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.LazyData.html) +- `SwapData`: app data/state that can be replaced at runtime (alternative to `Data>`) [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.SwapData.html) +- `LocalData`: app data/state that uses an `Rc` internally, avoiding atomic overhead (alternative to `Data>`) [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.LocalData.html) +- `Json`: simplified JSON extractor with const-generic payload limits [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.Json.html) +- `Path`: simplified path parameter extractor that supports destructuring [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.Path.html) +- `Query`: simplified query-string extractor that can also collect multi-value items [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.Query.html) +- `RequestSignature`: wraps an extractor and calculates a request signature alongside [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.RequestSignature.html) +- `BodyLimit`: wraps a body extractor and prevents DoS attacks by limiting payload size [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.BodyLimit.html) +- `Bytes`: simplified Bytes extractor with const-generic limits [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.Bytes.html) +- `UrlEncodedForm`: URL-encoded form extractor with const-generic payload size limit [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.UrlEncodedForm.html) +- `Host`: Host information taken from either URL or Host header [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/extract/struct.Host.html) ### Macros -- `FromRequest`: Derive macro to implement `FromRequest` on an aggregate struct of other extractors [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/derive.FromRequest.html) +- `FromRequest`: Derive macro to implement `FromRequest` on an aggregate struct of other extractors [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/derive.FromRequest.html) ### Headers -- `StrictTransportSecurity`: Strict-Transport-Security (HSTS) configuration [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/header/struct.StrictTransportSecurity.html) -- `CacheControl`: Cache-Control typed header with support for modern directives [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/header/struct.CacheControl.html) -- `ContentLength`: Content-Length typed header [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/header/struct.ContentLength.html) -- `Forwarded`: Proxy and original client info [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/header/struct.Forwarded.html) +- `StrictTransportSecurity`: Strict-Transport-Security (HSTS) configuration [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/header/struct.StrictTransportSecurity.html) +- `CacheControl`: Cache-Control typed header with support for modern directives [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/header/struct.CacheControl.html) +- `ContentLength`: Content-Length typed header [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/header/struct.ContentLength.html) +- `Forwarded`: Proxy and original client info [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/header/struct.Forwarded.html) ### Body Types -- `channel`: a simple channel-like body type with a sender side that can be used from another thread [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/body/fn.channel.html) -- `writer`: a simple `AsyncWrite` body type [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/body/fn.writer.html) +- `channel`: a simple channel-like body type with a sender side that can be used from another thread [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/body/fn.channel.html) +- `writer`: a simple `AsyncWrite` body type [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/body/fn.writer.html) ### Services -- `Redirect`: (graduated 🎉) simple redirects [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/web/struct.Redirect.html) -- `spa`: Easy Single-page Application (SPA) service [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/web/fn.spa.html) +- `Redirect`: (graduated 🎉) simple redirects [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/web/struct.Redirect.html) +- `spa`: Easy Single-page Application (SPA) service [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/web/fn.spa.html) ### Route Guards -- `Acceptable`: (graduated 🎉) verifies that an `Accept` header is present and it contains a compatible MIME type [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/guard/struct.Acceptable.html) +- `Acceptable`: (graduated 🎉) verifies that an `Accept` header is present and it contains a compatible MIME type [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/guard/struct.Acceptable.html) ### Test Utilities -- `test_request`: construct `TestRequest` using an HTTP-like DSL [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/test/macro.test_request.html) -- `assert_response_matches`: quickly write tests that check various parts of a `ServiceResponse` [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/test/macro.assert_response_matches.html) +- `test_request`: construct `TestRequest` using an HTTP-like DSL [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/test/macro.test_request.html) +- `assert_response_matches`: quickly write tests that check various parts of a `ServiceResponse` [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/test/macro.assert_response_matches.html) ### Other Utilities -- `fork_request_payload`: effectively clone a request payload [(docs)](https://docs.rs/actix-web-lab/0.19.0/actix_web_lab/util/fn.fork_request_payload.html) +- `fork_request_payload`: effectively clone a request payload [(docs)](https://docs.rs/actix-web-lab/0.19.1/actix_web_lab/util/fn.fork_request_payload.html) ## Things To Know About This Crate