Crate salvo 

Salvo is a powerful web framework that can make your work easier.

salvo uses a set of [feature flags] to reduce the amount of compiled and optional dependencies.

Feature flags

Feature	Description	Default?
cookie	Support for Cookie	✔️
server	Built-in Server implementation	✔️
server-handle	Expose a ServerHandle for graceful/forced shutdown	✔️
http1	Support for HTTP 1.1 protocol	✔️
http2	Support for HTTP 2 protocol	✔️
http2-cleartext	Support for HTTP 2 over cleartext TCP	❌
quinn	Use quinn to support HTTP 3 protocol	❌
test	Utilities for testing application	✔️
acme	Automatically obtain certificates through ACME	❌
rustls	TLS built on rustls	❌
openssl	TLS built on openssl-tls	❌
native-tls	TLS built on native-tls	❌
tls12	Allow TLS 1.2 (in addition to 1.3) for the rustls backend	❌
aws-lc-rs	Use aws-lc-rs as the rustls crypto provider	✔️
ring	Use ring as the rustls crypto provider	❌
unix	Listener based on Unix socket	❌
socket2	Tune listener socket options via socket2	❌
fix-http1-request-uri	Rewrite HTTP/1.1 absolute-form request URIs to origin-form	✔️
matched-path	Expose the matched route template on the request	✔️
tower-compat	Adapters for tower::Layer and tower::Service	❌
anyhow	Integrate with the anyhow crate	❌
eyre	Integrate with the eyre crate	❌
affix-state	Middleware for adding shared application state to the request context	❌
craft	Generate handlers or endpoints with shared data	❌
basic-auth	Middleware for basic authentication	❌
caching-headers	Middleware for setting caching headers	❌
catch-panic	Middleware for catching panics	❌
concurrency-limiter	Middleware for limiting concurrency	❌
force-https	Middleware for forcing HTTPS	❌
logging	Middleware for logging requests and responses	❌
request-id	Middleware for setting a request ID	❌
size-limiter	Middleware for limiting request size	❌
sse	Server-Sent Events (SSE) middleware	❌
timeout	Middleware for setting a timeout	❌
trailing-slash	Middleware for handling trailing slashes	❌
websocket	WebSocket implementation	❌
cache	Response caching middleware	❌
compression	Response compression middleware	❌
cors	CORS middleware	❌
csrf	CSRF protection middleware	❌
flash	Flash messages middleware	❌
jwt-auth	JWT authentication middleware using the AWS-LC provider	❌
jwt-auth-ring	JWT authentication middleware using the RustCrypto provider	❌
oapi	OpenAPI 3 generation and Swagger/RapiDoc/ReDoc/Scalar UIs	❌
otel	OpenTelemetry integration	❌
proxy	Reverse-proxy middleware	❌
rate-limiter	Rate-limiting middleware	❌
rfc9457	RFC 9457 Problem Details responses	❌
serve-static	Static file / directory serving	❌
session	Cookie-based session middleware	❌
tus	tus.io resumable upload protocol	❌

jwt-auth and jwt-auth-ring enable the same middleware with different cryptography providers. Enable only one in normal builds. If Cargo feature unification enables both, call jwt_auth::install_crypto_provider() before any JWT operation.

Re-exports

pub use salvo_cache as cache;cache

pub use salvo_compression as compression;compression

pub use salvo_cors as cors;cors

pub use salvo_csrf as csrf;csrf

pub use salvo_flash as flash;flash

pub use salvo_jwt_auth as jwt_auth;_jwt-auth

pub use salvo_proxy as proxy;proxy

pub use salvo_rate_limiter as rate_limiter;rate-limiter

pub use salvo_session as session;session

pub use salvo_serve_static as serve_static;serve-static

pub use salvo_otel as otel;otel

pub use salvo_acme as acme;acme

pub use salvo_oapi as oapi;oapi

pub use salvo_tus as tus;tus

pub use salvo_core as core;

pub use salvo_craft as craft;craft

Modules

affix_stateaffix-state

Middleware for adding shared application state to the request context.

basic_authbasic-auth

Middleware for HTTP Basic Authentication.

caching_headerscaching-headers

Middleware for handling ETag and Last-Modified headers.

catch_paniccatch-panic

Middleware that catches panics in handlers.

catcher

Error catching and custom error page handling.

concurrency_limiterconcurrency-limiter

Middleware for limiting concurrency.

conn

Connection and listener implementations for handling HTTP connections.

extract

Request extraction for deserializing request data into application types.

force_httpsforce-https

Middleware force redirect to https.

fs

Filesystem utilities for serving files in HTTP responses.

fuse

Low-overhead protection against stalled and abusive connections.

handler

Handler abstractions for processing Request values.

http

HTTP types, request/response handling, and protocol utilities.

hyper

hyper

logginglogging

A simple logging middleware.

macros

Procedural macros for the Salvo web framework.

prelude

A list of things that automatically imports into application use salvo.

proto

Http protocol supports.

request_idrequest-id

Request id middleware.

routing

Routing and filters.

rt

Runtime module.

serverserver

Server module

size_limitersize-limiter

Middleware for limiting request size.

ssesse

Middleware for Server-Sent Events (SSE)

testtest

Utilities for testing application.

timeouttimeout

Middleware for controlling requests timeout.

trailing_slashtrailing-slash

Trailing slash middleware.

websocketwebsocket

WebSocket implementation.

writing

Writer trait and its implementations.

Structs

ConnCtrl

Controls the lifetime of the transport connection serving a request.

Depot

Store temporary data for the current request.

FlowCtrl

Controls execution of a matched handler chain.

Request

Represents an HTTP request.

Response

Represents an HTTP response.

Router

Route request to different handlers.

Serverserver

HTTP Server.

Service

Service http request.

Enums

Error

The main error type used throughout Salvo.

Traits

Extractible

Describes how to extract a type from a request.

Handler

Processes a request and writes to a response.

Listener

A trait for types that can bind to an address and create an acceptor.

Scribe

Scribe is used to write data to Response.

Writer

Writer is used to write data to Response.

Type Aliases

BoxedError

A boxed error type for dynamic error handling.

Result

Result type which has salvo::Error as its error type.

Attribute Macros

async_trait

Re-export async_trait.

handler

Converts a function or impl block into a Salvo Handler.