sylvia-iot-broker 0.2.0

The message broker module of the Sylvia-IoT platform.
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

[![crates.io](https://img.shields.io/crates/v/sylvia-iot-broker)](https://crates.io/crates/sylvia-iot-broker)
[![Documentation](https://docs.rs/sylvia-iot-broker/badge.svg)](https://docs.rs/sylvia-iot-broker)
![CI](https://github.com/woofdogtw/sylvia-iot-core/actions/workflows/build-test.yaml/badge.svg)
[![Coverage](https://raw.githubusercontent.com/woofdogtw/sylvia-iot-core/gh-pages/docs/coverage/sylvia-iot-broker/badges/flat.svg)](https://woofdogtw.github.io/sylvia-iot-core/coverage/sylvia-iot-broker/)
[![Docker](https://img.shields.io/docker/v/woofdogtw/sylvia-iot-broker?label=docker&logo=docker)](https://hub.docker.com/r/woofdogtw/sylvia-iot-broker)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](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

- [HTTP APIs](doc/api.md)
- [Messages](doc/message.md)

# Mount sylvia-iot-broker in your axum App

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

```rust
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`](src/bin/sylvia-iot-broker.rs) to get the real world example.