actix-web/README.md

Actix web

Actix web is a simple, pragmatic and extremely fast web framework for Rust.

• Supported HTTP/1.x and HTTP/2.0 protocols
• Streaming and pipelining
• Keep-alive and slow requests handling
• Client/server WebSockets support
• Transparent content compression/decompression (br, gzip, deflate)
• Configurable request routing
• Graceful server shutdown
• Multipart streams
• Static assets
• SSL support with OpenSSL or native-tls
• Middlewares (Logger, Session, CORS, CSRF, etc)
• Includes an asynchronous HTTP client
• Built on top of Actix actor framework

Documentation & community resources

• User Guide
• API Documentation (Development)
• API Documentation (Releases)
• Chat on gitter
• Cargo package: actix-web
• Minimum supported Rust version: 1.26 or later

Example

extern crate actix_web;
use actix_web::{http, server, App, Path, Responder};

fn index(info: Path<(u32, String)>) -> impl Responder {
    format!("Hello {}! id:{}", info.1, info.0)
}

fn main() {
    server::new(
        || App::new()
            .route("/{id}/{name}/index.html", http::Method::GET, index))
        .bind("127.0.0.1:8080").unwrap()
        .run();
}

More examples

• Basics
• Stateful
• Protobuf support
• Multipart streams
• Simple websocket
• Tera / Askama templates
• Diesel integration
• r2d2
• SSL / HTTP/2.0
• Tcp/Websocket chat
• Json

You may consider checking out this directory for more examples.

Benchmarks

• TechEmpower Framework Benchmark

• Some basic benchmarks could be found in this repository.

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Code of Conduct

Contribution to the actix-web crate is organized under the terms of the Contributor Covenant, the maintainer of actix-web, @fafhrd91, promises to intervene to uphold that code of conduct.