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
//! # cabot
//!
//! cabot is a command line tool and a rust library for sending HTTP query.
//! It is a simple implementation of HTTP based on the rust standard library
//! to perform TCP and DNS query, and use rustls for handling HTTPS connection.
//! No tiers library are used for HTTP protocol.
//!
//! cabot is inspired by the cURL command line tool, but focus on the
//! http protocol which is the referent in HTTP client library.
//!
//! # Examples:
//!
//! ## Command Line:
//!
//! ```bash
//! $ cargo run -- https://www.rust-lang.org/ 2>&1| head -n 20 | grep 'name="description"'
//!     <meta name="description" content="A language empowering everyone to build reliable and efficient software.">
//! ```
//! ## Library:
//!
//! ```
//! use async_std::task;
//! use cabot::{RequestBuilder, Client};
//!
//! let request = RequestBuilder::new("https://www.rust-lang.org/")
//!     .build()
//!     .unwrap();
//! let client = Client::new();
//! let response = task::block_on(async {client.execute(&request).await.unwrap()});
//! assert!(response.body_as_string().unwrap().contains("Rust is blazingly fast and memory-efficient"));
//!
//! ```
//!
//! # Why cabot ?
//!
//! To get a simple rust native https client. No binding to OpenSSL.
//!
//! # License
//!
//! BSD 3-Clause License
//!

#[macro_use]
extern crate log;

extern crate rustls;
extern crate url;
extern crate webpki;
extern crate webpki_roots;

mod dns;

mod asynctls;

pub mod client;
pub mod constants;
pub mod errors;
pub mod http;
pub mod request;
pub mod response;
pub mod results;

// Rexport
pub use client::Client;
pub use request::RequestBuilder;