actix-web/README.md

Actix web

Actix web is a simple, pragmatic, 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, Redis sessions, DefaultHeaders, CORS, CSRF)
• Built on top of Actix actor framework.

Documentation

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

Example

extern crate actix_web;
use actix_web::{App, HttpServer, Path};

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

fn main() {
    HttpServer::new(
        || App::new()
            .resource("/{name}/{id}/index.html", |r| r.with(index)))
        .bind("127.0.0.1:8080").unwrap()
        .run();
}

More examples

• Basics
• Stateful
• Protobuf support
• Multipart streams
• Simple websocket session
• Tera templates
• Diesel integration
• 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.