#network #framework #async #futures

actix-utils

Actix utils - various actix net related services

14 unstable releases (3 breaking)

✓ Uses Rust 2018 edition

new 0.4.1 May 15, 2019
0.4.0 May 12, 2019
0.3.5 Apr 4, 2019
0.3.4 Mar 12, 2019
0.1.0 Dec 11, 2018

#148 in Network programming

Download history 16/week @ 2019-01-30 153/week @ 2019-02-06 64/week @ 2019-02-13 43/week @ 2019-02-20 272/week @ 2019-02-27 172/week @ 2019-03-06 220/week @ 2019-03-13 164/week @ 2019-03-20 452/week @ 2019-03-27 828/week @ 2019-04-03 1200/week @ 2019-04-10 1428/week @ 2019-04-17 1170/week @ 2019-04-24 1390/week @ 2019-05-01 2384/week @ 2019-05-08

3,351 downloads per month
Used in 25 crates (5 directly)

MIT/Apache

180KB
5.5K SLoC

Actix net Build Status codecov crates.io Join the chat at https://gitter.im/actix/actix

Actix net - framework for composable network services

Documentation & community resources

Example

fn main() -> io::Result<()> {
    // load ssl keys
    let mut builder = SslAcceptor::mozilla_intermediate(SslMethod::tls()).unwrap();
    builder.set_private_key_file("./examples/key.pem", SslFiletype::PEM).unwrap();
    builder.set_certificate_chain_file("./examples/cert.pem").unwrap();
    let acceptor = builder.build();

    let num = Arc::new(AtomicUsize::new(0));

    // bind socket address and start workers. By default server uses number of
    // available logical cpu as threads count. actix net start separate
    // instances of service pipeline in each worker.
    Server::build()
        .bind(
            // configure service pipeline
            "basic", "0.0.0.0:8443",
            move || {
                let num = num.clone();
                let acceptor = acceptor.clone();

                // service for converting incoming TcpStream to a SslStream<TcpStream>
                fn_service(move |stream: Io<tokio_tcp::TcpStream>| {
                    SslAcceptorExt::accept_async(&acceptor, stream.into_parts().0)
                        .map_err(|e| println!("Openssl error: {}", e))
                })
                // .and_then() combinator uses other service to convert incoming `Request` to a
                // `Response` and then uses that response as an input for next
                // service. in this case, on success we use `logger` service
                .and_then(fn_service(logger))
                // Next service counts number of connections
                .and_then(move |_| {
                    let num = num.fetch_add(1, Ordering::Relaxed);
                    println!("got ssl connection {:?}", num);
                    future::ok(())
                })
            },
        )?
        .run()
}

License

This project is licensed under either of

at your option.

Code of Conduct

Contribution to the actix-net crate is organized under the terms of the Contributor Covenant, the maintainer of actix-net, @fafhrd91, promises to intervene to uphold that code of conduct.

Dependencies

~1.5MB
~23K SLoC