#network #framework #async #futures

actix-net

Actix net - framework for the compisible network services for Rust (experimental)

2 releases

0.1.1 Oct 10, 2018
0.1.0 Oct 9, 2018

#15 in Network programming

Download history 1487/week @ 2018-10-13 2165/week @ 2018-10-20 3009/week @ 2018-10-27 2338/week @ 2018-11-03 2707/week @ 2018-11-10 3838/week @ 2018-11-17 4677/week @ 2018-11-24

2,136 downloads per month
Used in 44 crates (4 directly)

MIT/Apache

218KB
6K SLoC

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

Actix net - framework for composable network services (experimental)

Documentation & community resources

Example

fn main() {
    let sys = actix::System::new("test");

    // 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::default()
        .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>
                (move |stream| {
                SslAcceptorExt::accept_async(&acceptor, stream)
                    .map_err(|e| println!("Openssl error: {}", e))
            })
            // convert closure to a `NewService`
            .into_new_service()

            // .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(logger)

            // Next service counts number of connections
            .and_then(move |req| {
                let num = num.fetch_add(1, Ordering::Relaxed);
                println!("processed {:?} connections", num);
                future::ok(())
            })
        }).unwrap()
        .start();

    sys.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

~13MB
~301K SLoC