actix-web-lab

Experimental extractors, middleware, and other extras for possible inclusion in Actix Web.

Features

Feature Voting →

Responders

• Csv: efficient CSV streaming (docs)
• NdJson: efficient NDJSON streaming (docs)
• DisplayStream: efficient line-by-line Display streaming (docs)
• Html: basic string wrapper that responds with HTML Content-Type (docs)

Middleware

• from_fn: use an async function as a middleware (docs)
• RedirectHttps: middleware to redirect traffic to HTTPS if connection is insecure with optional HSTS (docs)
• redirect_to_www: function middleware to redirect traffic to www. if not already there (docs)
• ErrorHandlers: alternative error handler middleware with simpler interface (docs)

Extractors

• LazyData: app data/state initialized on first use (docs)
• SwapData: app data/state that can be replaced at runtime (alternative to Data<RwLock<T>>) (docs)
• LocalData: app data/state that can be replaced at runtime (alternative to Data<RwLock<T>>) (docs)
• Json: simplified JSON extractor with const-generic limits (docs)
• Path: simplified path parameter extractor that supports destructuring (docs)
• Query: simplified query-string extractor (docs)
• RequestSignature: wraps an extractor and calculates a request signature alongside (docs)

Macros

• FromRequest: Derive macro to implement FromRequest on an aggregate struct of other extractors (docs)

Headers

• Hsts: Strict-Transport-Security (HSTS) (docs)
• CacheControl: Cache-Control header with support for modern directives (docs)

Body Types

• channel: a simple channel-like body type with a sender side that can be used from another thread (docs)

Services

• Redirect: simple redirects (docs)
• spa: Easy Single-page Application (SPA) service (docs)

Route Guards

• Acceptable: verifies that an Accept header is present and it contains a compatible MIME type (docs)

Test Utilities

• test_request: Construct TestRequest using an HTTP-like DSL (docs)
• assert_response_matches: quickly write tests that check various parts of a ServiceResponse (docs)

Things To Know About This Crate

• It will never reach v1.0.
• Minimum Supported Rust Version (MSRV) is latest stable at the time of each release.
• Breaking changes will likely happen on most 0.x version bumps.
• Documentation might be limited for some items.
• Items that graduate to Actix Web crate will be marked deprecated here for a reasonable amount of time so you can migrate.
• Migrating will often be as easy as dropping the _lab suffix from imports when migrating.