rama 0.3.0

modular service framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! A simple example demonstrating `OctetStream` responses for binary data.
//!
//! This example will create a server that listens on `127.0.0.1:62056`.
//!
//! # Run the example
//!
//! ```sh
//! cargo run --example http_octet_stream --features=http-full
//! ```
//!
//! # Test the endpoints
//!
//! ```sh
//! # Simple binary data
//! curl http://127.0.0.1:62056/data -o output.bin
//!
//! # Download with filename
//! curl -O -J http://127.0.0.1:62056/download
//! ```

#![expect(
    clippy::expect_used,
    reason = "example/test/bench: panic-on-error and print-for-output are the standard patterns for demos and harnesses"
)]

use rama::http::layer::trace::TraceLayer;
use rama::http::service::web::WebService;
use rama::http::service::web::response::{IntoResponse, OctetStream};
use rama::stream::io::ReaderStream;
use rama::{Layer, http::server::HttpServer};

#[tokio::main]
async fn main() {
    HttpServer::default()
        .listen(
            "127.0.0.1:62056",
            TraceLayer::new_for_http().layer(
                WebService::default()
                    .with_get("/data", serve_binary_data)
                    .with_get("/download", serve_download),
            ),
        )
        .await
        .expect("failed to run service");
}

/// Example 1: Simple binary response
async fn serve_binary_data() -> impl IntoResponse {
    let data = b"Hello";
    let cursor = std::io::Cursor::new(data);
    let stream = ReaderStream::new(cursor);
    OctetStream::new(stream)
}

/// Example 2: Binary download with Content-Disposition
async fn serve_download() -> impl IntoResponse {
    let data = b"Binary file content";
    let cursor = std::io::Cursor::new(data);
    let stream = ReaderStream::new(cursor);
    OctetStream::new(stream).with_file_name("file.bin".to_owned())
}