feat(lib): add shortcut request methods

Author: 0x676e67

examples/form.rs

@@ -5,8 +5,7 @@
 // `tokio = { version = "1", features = ["full"] }`
 #[tokio::main]
 async fn main() {
-    let response = wreq::Client::new()
-        .post("http://www.baidu.com")
+    let response = wreq::post("http://www.baidu.com")
         .form(&[("one", "1")])
         .send()
         .await

examples/http1_websocket.rs

@@ -1,23 +1,14 @@
-use std::time::Duration;
-
 use futures_util::{SinkExt, StreamExt, TryStreamExt};
-use wreq::{Client, header, ws::message::Message};
+use wreq::{header, ws::message::Message};
 
 #[tokio::main]
 async fn main() -> wreq::Result<()> {
     tracing_subscriber::fmt()
         .with_max_level(tracing::Level::TRACE)
         .init();
 
-    // Build a client
-    let client = Client::builder()
-        .cert_verification(false)
-        .connect_timeout(Duration::from_secs(10))
-        .build()?;
-
     // Use the API you're already familiar with
-    let resp = client
-        .websocket("wss://echo.websocket.org")
+    let resp = wreq::websocket("wss://echo.websocket.org")
         .header(header::USER_AGENT, env!("CARGO_PKG_NAME"))
         .read_buffer_size(1024 * 1024)
         .send()

examples/http2_websocket.rs

@@ -5,26 +5,17 @@
 //! cargo run -p example-websockets-http2
 //! ```
 
-use std::time::Duration;
-
 use futures_util::{SinkExt, StreamExt, TryStreamExt};
-use wreq::{Client, header, ws::message::Message};
+use wreq::{header, ws::message::Message};
 
 #[tokio::main]
 async fn main() -> wreq::Result<()> {
     tracing_subscriber::fmt()
         .with_max_level(tracing::Level::TRACE)
         .init();
 
-    // Build a client
-    let client = Client::builder()
-        .connect_timeout(Duration::from_secs(10))
-        .cert_verification(false)
-        .build()?;
-
     // Use the API you're already familiar with
-    let resp = client
-        .websocket("wss://127.0.0.1:3000/ws")
+    let resp = wreq::websocket("wss://127.0.0.1:3000/ws")
         .force_http2()
         .header(header::USER_AGENT, env!("CARGO_PKG_NAME"))
         .read_buffer_size(1024 * 1024)

examples/json_dynamic.rs

@@ -9,8 +9,7 @@
 // `tokio = { version = "1", features = ["full"] }`
 #[tokio::main]
 async fn main() -> wreq::Result<()> {
-    let echo_json: serde_json::Value = wreq::Client::new()
-        .post("https://jsonplaceholder.typicode.com/posts")
+    let echo_json: serde_json::Value = wreq::post("https://jsonplaceholder.typicode.com/posts")
         .json(&serde_json::json!({
             "title": "wreq.rs",
             "body": "https://docs.rs/wreq",

examples/json_typed.rs

@@ -27,8 +27,7 @@ async fn main() -> wreq::Result<()> {
         body: "https://docs.rs/wreq".into(),
         user_id: 1,
     };
-    let new_post: Post = wreq::Client::new()
-        .post("https://jsonplaceholder.typicode.com/posts")
+    let new_post: Post = wreq::post("https://jsonplaceholder.typicode.com/posts")
         .json(&new_post)
         .send()
         .await?

examples/request_with_emulation.rs

@@ -105,10 +105,7 @@ async fn main() -> wreq::Result<()> {
         .build();
 
     // Use the API you're already familiar with
-    let resp = Client::builder()
-        .cert_verification(false)
-        .build()?
-        .post("https://tls.peet.ws/api/all")
+    let resp = wreq::post("https://tls.peet.ws/api/all")
         .emulation(emulation)
         .send()
         .await?;

examples/request_with_interface.rs

@@ -17,8 +17,7 @@ async fn main() -> wreq::Result<()> {
         .init();
 
     // Use the API you're already familiar with
-    let resp = wreq::Client::new()
-        .get("https://api.ip.sb/ip")
+    let resp = wreq::get("https://api.ip.sb/ip")
         .interface("utun4")
         .send()
         .await?;

examples/request_with_local_address.rs

@@ -9,8 +9,7 @@ async fn main() -> wreq::Result<()> {
         .init();
 
     // Use the API you're already familiar with
-    let resp = wreq::Client::new()
-        .get("http://www.baidu.com")
+    let resp = wreq::get("http://www.baidu.com")
         .redirect(Policy::default())
         .local_address(IpAddr::from([192, 168, 1, 226]))
         .send()

examples/request_with_redirect.rs

@@ -7,8 +7,7 @@ async fn main() -> wreq::Result<()> {
         .init();
 
     // Use the API you're already familiar with
-    let resp = wreq::Client::new()
-        .get("http://google.com/")
+    let resp = wreq::get("http://google.com/")
         .redirect(Policy::default())
         .send()
         .await?;

examples/request_with_version.rs

@@ -7,8 +7,7 @@ async fn main() -> wreq::Result<()> {
         .init();
 
     // Use the API you're already familiar with
-    let resp = wreq::Client::new()
-        .get("https://www.google.com")
+    let resp = wreq::get("https://www.google.com")
         .version(Version::HTTP_11)
         .send()
         .await?;