mirror of https://github.com/actix/actix-web.git synced 2024-11-26 03:21:08 +00:00

History

Rob Ede 6f0a6bd1bb address clippy lints For intrepid commit message readers: The choice to add allows for the inlined format args lint instead of actually inlining them is not very clear because our actual real world MSRV is not clear. We currently claim 1.60 is our MSRV but this is mainly due to dependencies. I'm fairly sure that we could support < 1.58 if those deps are outdated in a users lockfile. We'll remove these allows again at some point soon.		2023-01-01 20:56:34 +00:00
..
benches	address clippy lints	2023-01-01 20:56:34 +00:00
examples	address clippy lints	2023-01-01 20:56:34 +00:00
src	address clippy lints	2023-01-01 20:56:34 +00:00
tests	address clippy lints	2023-01-01 20:56:34 +00:00
Cargo.toml	fix version requirement for futures_util	2022-12-18 01:34:48 +00:00
CHANGES.md	add Allow header to resource's default 405 handler (#2949 )	2022-12-21 20:28:45 +00:00
LICENSE-APACHE	move actix-web to own dir	2022-02-01 00:30:41 +00:00
LICENSE-MIT	move actix-web to own dir	2022-02-01 00:30:41 +00:00
MIGRATION-0.x.md	split migration file	2022-02-02 02:46:37 +00:00
MIGRATION-1.0.md	split migration file	2022-02-02 02:46:37 +00:00
MIGRATION-2.0.md	split migration file	2022-02-02 02:46:37 +00:00
MIGRATION-3.0.md	split migration file	2022-02-02 02:46:37 +00:00
MIGRATION-4.0.md	update migration guide	2022-03-26 13:26:12 +00:00
README.md	prepare actix-web release 4.2.1	2022-09-12 10:43:03 +01:00

README.md

Actix Web

Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust

Features

Supports HTTP/1.x and HTTP/2
Streaming and pipelining
Powerful request routing with optional macros
Full Tokio compatibility
Keep-alive and slow requests handling
Client/server WebSockets support
Transparent content compression/decompression (br, gzip, deflate, zstd)
Multipart streams
Static assets
SSL support using OpenSSL or Rustls
Middlewares (Logger, Session, CORS, etc)
Integrates with the awc HTTP client
Runs on stable Rust 1.59+

Documentation

Example

Dependencies:

[dependencies]
actix-web = "4"

Code:

use actix_web::{get, web, App, HttpServer, Responder};

#[get("/hello/{name}")]
async fn greet(name: web::Path<String>) -> impl Responder {
    format!("Hello {name}!")
}

#[actix_web::main] // or #[tokio::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new().service(greet)
    })
    .bind(("127.0.0.1", 8080))?
    .run()
    .await
}

More Examples

You may consider checking out this directory for more examples.

Benchmarks

One of the fastest web frameworks available according to the TechEmpower Framework Benchmark.

License

This project is licensed under either of the following licenses, at your option:

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])

Code of Conduct

Contribution to the actix-web repo is organized under the terms of the Contributor Covenant. The Actix team promises to intervene to uphold that code of conduct.