#iot #networking #platform #broker #unit #routes #applications

bin+lib sylvia-iot-broker

The message broker module of the Sylvia-IoT platform

51 releases

0.1.15 Sep 27, 2024
0.1.12 Aug 31, 2024
0.1.6 Jul 30, 2024
0.0.36 Feb 16, 2024
0.0.6 Mar 31, 2023

#110 in HTTP server


Used in 3 crates

MIT license

1MB
22K SLoC

crates.io Documentation CI Coverage Docker License

sylvia-iot-broker

The message broker module of the Sylvia-IoT platform.

This module provides:

  • Unit management for each owner, including
    • Applications
    • Private networks
    • Devices
    • Device routes to applications
    • Private network routes to applications
  • Public network management

Documentation

Mount sylvia-iot-broker in your axum App

You can simply mount sylvia-iot-broker into your axum App:

use axum::Router;
use clap::App as ClapApp;
use std::net::SocketAddr;
use sylvia_iot_broker::{libs, routes};
use tokio::{self, net::TcpListener};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let args = ClapApp::new("your-project-name").get_matches();

    let conf = libs::config::read_args(&args);
    let broker_state = match routes::new_state("/broker", &conf).await {
        Err(e) => {
            println!("Error: {}", e);
            return Ok(());
        },
        Ok(state) => state,
    };
    let app = Router::new().merge(routes::new_service(&broker_state));
    let listener = match TcpListener::bind("0.0.0.0:1080").await.unwrap();
    axum::serve(listener, app.into_make_service_with_connect_info::<SocketAddr>()).await
}

Please see src/bin/sylvia-iot-broker.rs to get the real world example.

Dependencies

~79MB
~1.5M SLoC