Struct HttpIngress 

pub struct HttpIngress<R = ()> { /* private fields */ }

HTTP Ingress Circuit Builder.

Wires HTTP inputs to Ranvier Circuits. This is NOT a web server—it’s a circuit wiring tool.

Ingress is part of Schematic (separate layer: Ingress → Circuit → Egress)

Implementations

impl<R> HttpIngress<R>

where R: ResourceRequirement + Clone + Send + Sync + 'static,

pub fn new() -> Self

Create a new empty HttpIngress builder.

pub fn bind(self, addr: impl Into<String>) -> Self

Set the bind address for the server.

pub fn route<E>( self, path: impl Into<String>, circuit: Axon<(), String, E, R>, ) -> Self

where E: Send + 'static + Debug,

Register a route with a circuit.

pub fn route_method<E>( self, method: Method, path: impl Into<String>, circuit: Axon<(), String, E, R>, ) -> Self

where E: Send + 'static + Debug,

Register a route with a specific HTTP method.

Example

Ranvier::http()
    .route_method(Method::POST, "/users", create_user_circuit)

pub fn fallback<E>(self, circuit: Axon<(), String, E, R>) -> Self

where E: Send + 'static + Debug,

Set a fallback circuit for unmatched routes.

Example

let not_found = Axon::new("NotFound").then(|_| async { "404 Not Found" });
Ranvier::http()
    .route("/", home)
    .fallback(not_found)

pub async fn run(self, resources: R) -> Result<(), Box<dyn Error + Send + Sync>>

Run the HTTP server with required resources.

pub fn into_raw_service(self, resources: R) -> RawIngressService<R>

Convert to a raw Tower Service for integration with existing Tower stacks.

This is the “escape hatch” per Discussion 193:

“Raw API는 Flat API의 탈출구다.”

Example

let ingress = Ranvier::http()
    .bind(":3000")
    .route("/", circuit);

let raw_service = ingress.into_raw_service();
// Use raw_service with existing Tower infrastructure

Trait Implementations

impl<R> Default for HttpIngress<R>

where R: ResourceRequirement + Clone + Send + Sync + 'static,

fn default() -> Self

Returns the “default value” for a type.