mirror of https://github.com/fafhrd91/actix-web synced 2024-11-24 00:21:08 +01:00

Actix web is a small, pragmatic, and extremely fast rust web framework. https://actix.rs

Go to file

jrconlin aa1e75f071 feature: allow TestServer to open a websocket on any URL * added `TestServer::ws_at(uri_str)` * modified `TestServer::ws()` to call `self.ws_at("/")` to preserve behavior Closes #432		2018-07-31 16:21:18 -07:00
src	feature: allow TestServer to open a websocket on any URL	2018-07-31 16:21:18 -07:00
tests	use new gzdecoder, fixes gz streaming #228	2018-07-31 09:06:05 -07:00
.appveyor.yml	Lessen numbers of jobs for AppVeyor	2018-07-11 09:23:17 +03:00
.gitignore	start working on guide	2017-11-27 16:41:37 -08:00
.travis.yml	allocate buffer for request payload extractors	2018-07-16 00:40:22 +06:00
build.rs	add tests for ErrorXXX helpers	2018-05-10 09:13:26 -07:00
Cargo.toml	use new gzdecoder, fixes gz streaming #228	2018-07-31 09:06:05 -07:00
CHANGES.md	HttpRequest::url_for is not working with scopes #429	2018-07-31 15:40:52 -07:00
CODE_OF_CONDUCT.md	code of conduct	2018-01-21 15:29:02 -08:00
LICENSE-APACHE	add mit license	2017-12-17 10:08:44 -08:00
LICENSE-MIT	spelling check	2018-03-24 09:35:52 +03:00
Makefile	publish stable docs on actix.rs site	2018-07-21 04:19:02 -07:00
MIGRATION.md	update migration	2018-07-21 01:00:50 -07:00
README.md	fix changelog	2018-07-24 14:18:04 -07:00
rustfmt.toml	fix rustfmt formatting	2018-06-01 10:27:23 -07:00

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

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.