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
#![deny(missing_docs)] #![doc(html_root_url = "https://docs.rs/lapin-futures-openssl/0.2.0/")] //! lapin-futures-openssl //! //! This library offers a nice integration of `openssl` with the `lapin-futures` library. //! It uses `amq-protocol` URI parsing feature and adds a `connect` method to `AMQPUri` //! which will provide you with a `lapin_futures::client::Client` wrapped in a `Future`. //! //! It autodetects whether you're using `amqp` or `amqps` and opens either a raw `TcpStream` //! or a `TlsStream` using `openssl` as the SSL engine. //! //! ## Connecting and opening a channel //! //! ```rust,no_run //! extern crate env_logger; //! extern crate futures; //! extern crate lapin_futures_openssl; //! extern crate tokio; //! //! use lapin_futures_openssl::lapin; //! //! use futures::future::Future; //! use lapin::channel::ConfirmSelectOptions; //! use lapin_futures_openssl::AMQPConnectionOpensslExt; //! //! fn main() { //! env_logger::init(); //! //! tokio::run( //! "amqps://user:pass@host/vhost?heartbeat=10".connect(|err| { //! eprintln!("heartbeat error: {:?}", err); //! }).and_then(|(client, heartbeat_handle)| { //! println!("Connected!"); //! client.create_confirm_channel(ConfirmSelectOptions::default()).map(|channel| (channel, heartbeat_handle)) //! }).and_then(|(channel, heartbeat_handle)| { //! println!("Stopping heartbeat."); //! heartbeat_handle.stop(); //! println!("Closing channel."); //! channel.close(200, "Bye") //! }).map_err(|err| { //! eprintln!("amqp error: {:?}", err); //! }) //! ); //! } //! ``` extern crate futures; extern crate lapin_futures_tls_api; extern crate tls_api_openssl; /// Reexport of the `lapin_futures` crate pub mod lapin; /// Reexport of the `uri` module from the `amq_protocol` crate pub mod uri; use std::io; use futures::future::Future; use lapin_futures_tls_api::{AMQPConnectionExt, AMQPStream}; use uri::AMQPUri; /// Add a connect method providing a `lapin_futures::client::Client` wrapped in a `Future`. pub trait AMQPConnectionOpensslExt<F: FnOnce(io::Error) + Send + 'static>: AMQPConnectionExt<F> where Self: Sized { /// Method providing a `lapin_futures::client::Client` wrapped in a `Future` fn connect(self, heartbeat_error_handler: F) -> Box<Future<Item = (lapin::client::Client<AMQPStream>, lapin::client::HeartbeatHandle), Error = io::Error> + Send + 'static> { AMQPConnectionExt::connect::<tls_api_openssl::TlsConnector>(self, heartbeat_error_handler) } } impl<F: FnOnce(io::Error) + Send + 'static> AMQPConnectionOpensslExt<F> for AMQPUri {} impl<'a, F: FnOnce(io::Error) + Send + 'static> AMQPConnectionOpensslExt<F> for &'a str {}