Struct OmbracServer 

pub struct OmbracServer { /* private fields */ }

OmbracServer provides a simple, easy-to-use API for starting and managing the ombrac server using QUIC transport.

This struct hides all transport-specific implementation details and provides a clean interface for external users.

Example

use ombrac_server::{OmbracServer, ServiceConfig};
use std::sync::Arc;

let config = Arc::new(ServiceConfig {
    secret: "my-secret".to_string(),
    listen: "0.0.0.0:8080".parse()?,
    transport: Default::default(),
    connection: Default::default(),
    logging: Default::default(),
});

let server = OmbracServer::build(config).await?;
// ... use server ...
server.shutdown().await;

Implementations

impl OmbracServer

pub async fn build(config: Arc<ServiceConfig>) -> Result<Self>

Builds a new server instance from the configuration.

This method:

1. Creates a QUIC server from the transport configuration
2. Sets up connection validation using the secret
3. Spawns the accept loop in a background task
4. Returns an OmbracServer handle for lifecycle management

Arguments

• config - The service configuration containing transport, connection, and secret settings

Returns

A configured OmbracServer instance ready to accept connections, or an error if configuration is invalid or server setup fails.

pub async fn shutdown(self)

Gracefully shuts down the server.

This method will:

1. Send a shutdown signal to stop accepting new connections
2. Wait for the accept loop to finish gracefully
3. Wait for existing connections to close

Example

server.shutdown().await;