barehttp 0.0.1

A minimal, explicit HTTP client for Rust with no_std support and blocking I/O
Documentation 
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

//! Configuration example
//!
//! Demonstrates how to configure the HTTP client with custom settings.

use barehttp::config::{ConfigBuilder, HttpStatusHandling, RedirectPolicy};
use barehttp::response::ResponseExt;
use barehttp::{Error, HttpClient};
use core::time::Duration;

fn main() -> Result<(), Error> {
  println!("=== Configuration Examples ===\n");

  // Example 1: Custom timeout
  println!("1. Client with custom timeout:");
  let config = ConfigBuilder::new()
    .timeout(Duration::from_secs(10))
    .user_agent("barehttp-config-example/1.0")
    .build();

  let client = HttpClient::with_config(config)?;

  let response = client.get("http://httpbin.org/delay/2").call()?;
  println!("✓ Request completed with timeout setting");
  println!("Status: {}\n", response.status_code);

  // Example 2: Disable automatic redirects
  println!("2. Client with no redirect following:");
  let config = ConfigBuilder::new()
    .redirect_policy(RedirectPolicy::NoFollow)
    .build();

  let client = HttpClient::with_config(config)?;

  let response = client.get("http://httpbin.org/redirect/1").call()?;
  println!("Status: {} (redirect not followed)", response.status_code);
  if let Some(location) = response.get_header("Location") {
    println!("Location header: {}\n", location);
  }

  // Example 3: Treat HTTP errors as responses (not errors)
  println!("3. HTTP status codes as responses:");
  let config = ConfigBuilder::new()
    .http_status_handling(HttpStatusHandling::AsResponse)
    .build();

  let client = HttpClient::with_config(config)?;

  let response = client.get("http://httpbin.org/status/404").call()?;
  println!("Status: {} (returned as response, not error)", response.status_code);
  println!("Is client error: {}\n", response.is_client_error());

  // Example 4: Limit redirects
  println!("4. Limit maximum redirects:");
  let config = ConfigBuilder::new()
    .max_redirects(2)
    .redirect_policy(RedirectPolicy::Follow)
    .build();

  let client = HttpClient::with_config(config)?;

  let response = client.get("http://httpbin.org/redirect/1").call()?;
  println!("✓ Followed redirect (max 2)");
  println!("Final status: {}\n", response.status_code);

  Ok(())
}