{{ partial "header" . }} <div id="act-home"> <div class="jumbotron"> <div class="actix-jumbotron"> <img src="/img/logo-large.png" class="align-middle actix-logo" alt=""> <p class="lead"> A powerful, pragmatic, and extremely fast web framework for Rust </p> <a href="/docs/getting-started/" class="btn btn-secondary actix-jumbotron-install"> Get Started </a> </div> </div> <div class="container actix-home"> <div class="row"> <div class="col-md-4"> <div class="actix-features"> <h2> <i class="fa fa-fw fa-shield" aria-hidden="true"></i> Type Safe </h2> <p>Forget about stringly typed objects, from request to response, everything has types.</p> <h2> <i class="fa fa-fw fa-battery-full" aria-hidden="true"></i> Feature Rich </h2> <p>Actix provides a lot of features out of box. HTTP/2, logging, etc.</p> <h2> <i class="fa fa-fw fa-puzzle-piece" aria-hidden="true"></i> Extensible </h2> <p>Easily create your own libraries that any Actix application can use.</p> <h2> <i class="fa fa-fw fa-dashboard" aria-hidden="true"></i> Blazingly Fast </h2> <p>Actix is blazingly fast. Don't take our word for it -- <a href="https://www.techempower.com/benchmarks/#section=data-r19">see for yourself!</a></p> </div> </div> <div class="col-md-8"> <div class="actix-content"> {{ highlight `use actix_web::{web, App, HttpRequest, HttpServer, Responder}; async fn greet(req: HttpRequest) -> impl Responder { let name = req.match_info().get("name").unwrap_or("World"); format!("Hello {}!", &name) } #[actix_web::main] async fn main() -> std::io::Result<()> { HttpServer::new(|| { App::new() .route("/", web::get().to(greet)) .route("/{name}", web::get().to(greet)) }) .bind("127.0.0.1:8080")? .run() .await }` "rust" "" }} </div> </div> </div> <div class="actix-showcase"> <div class="col-md-9"> <div class="actix-feature" id="responders"> <h2>Flexible Responders</h2> <p> Handler functions in actix can return a wide range of objects that implement the <code>Responder</code> trait. This makes it a breeze to return consistent responses from your APIs. </p> {{ highlight `#[derive(Serialize)] struct Measurement { temperature: f32, } async fn hello_world() -> impl Responder { "Hello World!" } async fn current_temperature() -> impl Responder { web::Json(Measurement { temperature: 42.3 }) }` "rust" "" }} </div> <div class="actix-feature" id="extractors"> <h2>Powerful Extractors</h2> <p> Actix comes with a powerful extractor system that extracts data from the incoming HTTP request and passes it to your view functions. Not only does this make for a convenient API but it also means that your view functions can be synchronous code and still benefit from asynchronous IO handling. </p> {{ highlight `#[derive(Deserialize, Serialize)] struct Event { id: Option<i32>, timestamp: f64, kind: String, tags: Vec<String>, } async fn capture_event(evt: web::Json<Event>) -> impl Responder { let new_event = store_in_db(evt.timestamp, &evt.kind, &evt.tags); format!("got event {}", new_event.id.unwrap()) }` "rust" "" }} </div> <div class="actix-feature" id="forms"> <h2>Easy Form Handling</h2> <p> Handling multipart/urlencoded form data is easy. Just define a structure that can be deserialized and actix will handle the rest. </p> {{ highlight `#[derive(Deserialize)] struct Register { username: String, country: String, } async fn register(form: web::Form<Register>) -> impl Responder { format!("Hello {} from {}!", form.username, form.country) }` "rust" "" }} </div> <div class="actix-feature" id="routing"> <h2>Request Routing</h2> <p> An actix app comes with a URL routing system that lets you match on URLs and invoke individual handlers. For extra flexibility, scopes can be used. </p> {{ highlight `#[get("/")] async fn index(_req: HttpRequest) -> impl Responder { "Hello from the index page!" } async fn hello(path: web::Path<String>) -> impl Responder { format!("Hello {}!", &path) } let app = App::new() .service(index) .route("/{name}", web::get().to(hello)); ` "rust" "" }} </div> </div> <div class="col-md-3 actix-feature-selectors"> <ul> <li class="actix-feature-selector"><a href="#responders">flexible responders</label> <li class="actix-feature-selector"><a href="#extractors">powerful extractors</label> <li class="actix-feature-selector"><a href="#forms">easy form handling</label> <li class="actix-feature-selector"><a href="#routing">request routing</label> </ul> </div> </div> </div> </div> {{ partial "footer" . }}