TechEmpower.FrameworkBenchmarks/frameworks/Rust/roa/README.md

Roa

Roa is an async web framework inspired by koajs, lightweight but powerful.

<a href="https://github.com/Hexilee/roa/tree/master/examples">Examples</a>
<span> | </span>
<a href="https://github.com/Hexilee/roa/wiki/Guide">Guide</a>
<span> | </span>
<a href="https://github.com/Hexilee/roa/wiki/Cookbook">Cookbook</a>

Feature highlights

• A lightweight, solid and well extensible core.
  • Supports HTTP/1.x and HTTP/2.0 protocols.
  • Full streaming.
  • Highly extensible middleware system.
  • Based on hyper, runtime-independent, you can chose async runtime as you like.
• Many useful extensions.
  • Official runtime schemes:
    • async-std runtime and TcpStream;
    • tokio runtime and TcpStream.
  • Transparent content compression (br, gzip, deflate, zstd).
  • Configurable and nestable router.
  • Named uri parameters(query and router parameter).
  • Cookie and jwt support.
  • HTTPS support.
  • WebSocket support.
  • Asynchronous multipart form support.
  • Other middlewares(logger, CORS .etc).
• Integrations
  • roa-diesel, integration with diesel.
  • roa-juniper, integration with juniper.
  • roa-pg, integration with tokio-postgres.
• Works on stable Rust.

Get start

# Cargo.toml

[dependencies]
roa = "0.5.0"
async-std = { version = "1.5", features = ["attributes"] }

use roa::App;
use roa::preload::*;
use std::error::Error as StdError;

#[async_std::main]
async fn main() -> Result<(), Box<dyn StdError>> {
    let app = App::new().end("Hello, World");
    app.listen("127.0.0.1:8000", |addr| {
        println!("Server is listening on {}", addr)
    })?
    .await?;
    Ok(())
}

Refer to wiki for more details.

Database

PostgreSQL.

• diesel \/ tokio-postgres \/ sqlx

Test URLs

Test 1: JSON Encoding

http://localhost:8080/json

Test 2: Single Row Query

http://localhost:8080/db

Test 3: Multi Row Query

http://localhost:8080/queries?q=20

Test 4: Fortunes (Template rendering)

http://localhost:8080/fortune

Test 5: Update Query

http://localhost:8080/updates?q=20

Test 6: Plaintext

http://localhost:8080/plaintext