ranvier-http 0.21.0

HTTP Ingress adapter for Ranvier - Hyper 1.0 native Service implementation
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

# Ranvier HTTP (`ranvier-http`)


> **The Ingress:** Tower-native HTTP adapter for Ranvier.

## 🎯 Purpose


`ranvier-http` bridges the gap between raw HTTP requests and Ranvier `Axon` circuits. It allows you to expose your business logic as a high-performance HTTP service with minimal boilerplate.

## 🔑 Key Components


- **`RanvierService`**: Implements `tower::Service`, making it compatible with Hyper, Axum, and other Tower ecosystems.
- **`Ranvier` Builder**: The entry point for the "Flat API" (`Ranvier::http()`).
- **Input Converters**: Logic to map incoming `http::Request` to your circuit's `Input` type.

## 🚀 Usage


```rust
use ranvier_http::Ranvier;

Ranvier::http()
    .bind("127.0.0.1:3000")
    .route("/", my_axon)
    .run()
    .await?;
```

## Examples


- [`hello-world`](../examples/hello-world/) — HTTP ingress baseline
- [`flat-api-demo`](../examples/flat-api-demo/) — Flat API routing
- [`routing-demo`](../examples/routing-demo/) — Route branching patterns
- [`routing-params-demo`](../examples/routing-params-demo/) — Route parameter extraction

## MSRV


- Rust `1.93.0` or newer (Edition 2024).