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
81
82
83
84
85
86
87
88
//! # 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"));
//!
//! ```
//!
//! ## Features
//!
//! There is no default features set.
//!
//! * `pretty_log`: add pretty_env_logger dependency.
//!
//! If set, pretty_env_logger is initalize for the CLI command,
//! it has no effect as using cabot as a library.
//!
//! Usage:
//!
//! RUST_LOG=cabot cargo run --features=pretty_log -- <url>
//!
//!
//! * `json`: add `serde_json` dependency.
//!
//! If set, the [RequestBuilder](request/struct.RequestBuilder.html) struct
//! as a method `set_body_as_json()`, in order to
//! serialize a struct that implement serde `Serialize` using `serde_json`,
//! and the [Response](response/struct.Response.html) structure a method `json()`
//! that deserialize a json to an object implementing serde Deserialize
//! using serde_json.
//!
//! ## Why cabot ?
//!
//! To get a simple rust native https client. No binding to OpenSSL.
//!
//! # License
//!
//! BSD 3-Clause License
//!
extern crate log;
extern crate rustls;
extern crate url;
extern crate webpki;
extern crate webpki_roots;
// Rexport
pub use Client;
pub use RequestBuilder;