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
//! async-curl: An asynchronous implementation to perform curl operations with tokio.
//! This requires a dependency with the [curl](https://crates.io/crates/curl) and [tokio](https://crates.io/crates/tokio) crates
//!
//! ## perform Curl Easy2 asynchronously
//! ```rust
//! pub mod actor;
//! pub mod error;
//!
//! use async_curl::actor::{Actor, CurlActor};
//! use curl::easy::{Easy2, Handler, WriteError};
//!
//! #[derive(Debug, Clone, Default)]
//! pub struct ResponseHandler {
//!     data: Vec<u8>,
//! }
//!
//! impl Handler for ResponseHandler {
//!     /// This will store the response from the server
//!     /// to the data vector.
//!     fn write(&mut self, data: &[u8]) -> Result<usize, WriteError> {
//!         self.data.extend_from_slice(data);
//!         Ok(data.len())
//!     }
//! }
//!
//! impl ResponseHandler {
//!     /// Instantiation of the ResponseHandler
//!     /// and initialize the data vector.
//!     pub fn new() -> Self {
//!         Self::default()
//!     }
//!
//!     /// This will consumed the object and
//!     /// give the data to the caller
//!     pub fn get_data(self) -> Vec<u8> {
//!         self.data
//!     }
//! }
//!
//! #[tokio::main(flavor = "current_thread")]
//! async fn main() {
//!     let actor = CurlActor::new();
//!
//!     let mut easy2 = Easy2::new(ResponseHandler::new());
//!     easy2.url("https://www.rust-lang.org/").unwrap();
//!     easy2.get(true).unwrap();
//!
//!     let actor1 = actor.clone();
//!     let spawn1 = tokio::spawn(async move {
//!     let mut result = actor1.send_request(easy2).await.unwrap();
//!
//!         let response = result.get_ref().to_owned().get_data();
//!         let status = result.response_code().unwrap();
//!
//!         println!("Response: {:?}", response);
//!         println!("Status: {:?}", status);
//!     });
//!
//!     let mut easy2 = Easy2::new(ResponseHandler::new());
//!     easy2.url("https://www.rust-lang.org/").unwrap();
//!     easy2.get(true).unwrap();
//!
//!     let spawn2 = tokio::spawn(async move {
//!         let mut result = actor.send_request(easy2).await.unwrap();
//!
//!         let response = result.get_ref().to_owned().get_data();
//!         let status = result.response_code().unwrap();
//!
//!         println!("Response: {:?}", response);
//!         println!("Status: {:?}", status);
//!     });
//!
//!     let (_, _) = tokio::join!(spawn1, spawn2);
//! }
//! ```
pub mod actor;
pub mod curl;
pub mod error;
#[cfg(test)]
mod tests;