hydroflow 0.10.0

Hydro's low-level dataflow runtime and IR
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

use std::net::SocketAddr;

use clap::{Parser, ValueEnum};
use client::run_client;
use hydroflow::util::{bind_udp_lines, ipv4_resolve};
use server::run_server;

mod client;
mod helpers;
mod protocol;
mod server;

#[derive(Clone, ValueEnum, Debug)]
enum Role {
    Client,
    Server,
}

#[derive(Parser, Debug)]
struct Opts {
    #[clap(value_enum, long)]
    role: Role,
    #[clap(long, value_parser = ipv4_resolve)]
    client_addr: Option<SocketAddr>,
    #[clap(long, value_parser = ipv4_resolve)]
    server_addr: Option<SocketAddr>,
}

#[hydroflow::main]
async fn main() {
    // parse command line arguments
    let opts = Opts::parse();
    let server_addr = opts.server_addr.unwrap();

    // depending on the role, pass in arguments to the right function
    match opts.role {
        Role::Server => {
            // allocate `outbound` and `inbound` sockets
            let (outbound, inbound, _) = bind_udp_lines(server_addr).await;
            println!("Listening on {:?}", server_addr);
            run_server(outbound, inbound).await;
        }
        Role::Client => {
            // allocate `outbound` sink and `inbound` stream
            let client_addr = opts
                .client_addr
                .unwrap_or_else(|| ipv4_resolve("localhost:0").unwrap());
            let (outbound, inbound, client_addr) = bind_udp_lines(client_addr).await;
            println!(
                "Client is bound to {:?}, connecting to Server at {:?}",
                client_addr, server_addr
            );
            // run the client
            run_client(outbound, inbound, server_addr).await;
        }
    }
}

#[test]
fn test() {
    use std::io::Write;

    use hydroflow::util::{run_cargo_example, wait_for_process_output};

    let (_server, _, mut server_output) = run_cargo_example(
        "echo_serde_json",
        "--role server --server-addr 127.0.0.1:2049",
    );

    let (_client, mut client_input, mut client_output) = run_cargo_example(
        "echo_serde_json",
        "--role client --server-addr 127.0.0.1:2049",
    );

    let mut server_output_so_far = String::new();
    let mut client_output_so_far = String::new();

    wait_for_process_output(
        &mut server_output_so_far,
        &mut server_output,
        "Server live!\n",
    );
    wait_for_process_output(
        &mut client_output_so_far,
        &mut client_output,
        "Client live!\n",
    );

    client_input.write_all(b"Hello\n").unwrap();

    wait_for_process_output(
        &mut client_output_so_far,
        &mut client_output,
        "EchoMsg \\{ payload: \"Hello\", ts: .* \\}",
    );
}