mirror of
https://github.com/actix/actix-web.git
synced 2024-11-25 11:01:14 +00:00
Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust.
2e63ff5928
* Fix type confusion in some scenarios When the feature for rustls 0.22 is enabled, and rustls 0.23 is also present in a project, there suddently exist multiple paths for errors when building middleware chains due to the use of two consecutive `?` operators without specifying the intermediate error type. This commit addresses the issue by removing the first `?`, so that the first error type will always be known, and the second `?` always has a well defined implementation. * Add CHANGES entry about type confusion * actix-http: add rustls 0.23 support * actix-http: update ws example, tests for rustls 0.23 * actix-http: add rustls 0.23 to changelog * Update comments to mention 0.23 instead of 0.22 * awc: add rustls 0.23 support This also fixes certificate lookup when native-roots is enabled for rustls 0.22. * awc: update changelog for rustls 0.23 * awc: Add base rustls-0_23 feature without roots to better enable custom config * actix-test: add rustls-0.23 * actix-test: add rustls 0.23 to changelog * awc: update changelog with rustls 0.23 tweaks * actix-web: add rustls 0.23 * Add rustls-0_23 to CI * Update tls_rustls.rs * review nits * review nits part 2 * fix doc test --------- Co-authored-by: Rob Ede <robjtede@icloud.com> |
||
---|---|---|
.cargo | ||
.github | ||
actix-files | ||
actix-http | ||
actix-http-test | ||
actix-multipart | ||
actix-multipart-derive | ||
actix-router | ||
actix-test | ||
actix-web | ||
actix-web-actors | ||
actix-web-codegen | ||
awc | ||
docs/graphs | ||
scripts | ||
.codecov.yml | ||
.gitignore | ||
.prettierrc.yml | ||
.rustfmt.toml | ||
Cargo.toml | ||
CHANGES.md | ||
CODE_OF_CONDUCT.md | ||
justfile | ||
LICENSE-APACHE | ||
LICENSE-MIT | ||
README.md |
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.72+
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
- Hello World
- Basic Setup
- Application State
- JSON Handling
- Multipart Streams
- MongoDB Integration
- Diesel Integration
- SQLite Integration
- Postgres Integration
- Tera Templates
- Askama Templates
- HTTPS using Rustls
- HTTPS using OpenSSL
- Simple WebSocket
- WebSocket Chat
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.