22 releases (3 stable)

✓ Uses Rust 2018 edition

2.0.0-alpha.3 May 7, 2020
2.0.0-alpha.2 Mar 8, 2020
1.0.2 Jan 15, 2020
1.0.1 Dec 15, 2019
0.1.1 Mar 15, 2019

#94 in Network programming

Download history 19210/week @ 2020-03-16 20092/week @ 2020-03-23 19904/week @ 2020-03-30 19034/week @ 2020-04-06 18494/week @ 2020-04-13 20399/week @ 2020-04-20 21008/week @ 2020-04-27 19419/week @ 2020-05-04 21308/week @ 2020-05-11 19869/week @ 2020-05-18 18088/week @ 2020-05-25 22202/week @ 2020-06-01 21837/week @ 2020-06-08 23641/week @ 2020-06-15 24485/week @ 2020-06-22 23630/week @ 2020-06-29

84,228 downloads per month
Used in 228 crates (8 directly)

MIT/Apache

260KB
7K SLoC

Actix net codecov Join the chat at https://gitter.im/actix/actix

Actix net - framework for composable network services

Build statuses

Platform Build Status
Linux build status
macOS build status
Windows build status
Windows (MinGW) build status

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();

                // construct transformation pipeline
                pipeline(
                    // service for converting incoming TcpStream to a SslStream<TcpStream>
                    fn_service(move |stream: actix_rt::net::TcpStream| async move {
                        SslAcceptorExt::accept_async(&acceptor, stream.into_parts().0).await
                            .map_err(|e| println!("Openssl error: {}", e))
                    }))
                // .and_then() combinator chains result of previos service call to argument
                /// for next service calll. in this case, on success we chain
                /// ssl stream to the `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

~7–11MB
~223K SLoC