actix-website/layouts/index.html

{{ 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-r20&hw=ph&test=fortune">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</a></li>
          <li class="actix-feature-selector"><a href="#extractors">powerful extractors</a></li>
          <li class="actix-feature-selector"><a href="#forms">easy form handling</a></li>
          <li class="actix-feature-selector"><a href="#routing">request routing</a></li>
        </ul>
      </div>
    </div>
  </div>
</div>

{{ partial "footer" . }}