Struct Response

pub struct Response {
    pub headers: HeaderMap,
    pub status: StatusCode,
    pub text: String,
    pub url: Url,
}

HTTP response wrapper with enhanced testing capabilities.

This struct wraps HTTP response data and provides convenient methods for accessing response information in tests. All data is captured for logging and debugging purposes.

Examples

use tanu::{check_eq, http::Client};

#[tanu::test]
async fn test_response() -> eyre::Result<()> {
    let client = Client::new();
    let response = client.get("https://api.example.com").send().await?;
     
    // Check status
    check_eq!(200, response.status().as_u16());
     
    // Access headers
    let content_type = response.headers().get("content-type");
     
    // Parse JSON
    let data: serde_json::Value = response.json().await?;
     
    Ok(())
}

Fields

headers: HeaderMap

status: StatusCode

text: String

url: Url

Implementations

impl Response

pub fn status(&self) -> StatusCode

Returns the HTTP status code of the response.

Examples

let status = response.status();
check_eq!(200, status.as_u16());
check!(status.is_success());

pub fn headers(&self) -> &HeaderMap

Returns a reference to the response headers.

Examples

let headers = response.headers();
let content_type = headers.get("content-type").unwrap();
check_str_eq!("application/json", content_type.to_str().unwrap());

pub fn url(&self) -> &Url

Returns the final URL of the response, after following redirects.

Examples

let url = response.url();
check!(url.host_str().unwrap().contains("example.com"));

pub async fn text(self) -> Result<String, Error>

Consumes the response and returns the response body as a string.

Examples

let body = response.text().await?;
check!(body.contains("expected content"));

pub async fn json<T: DeserializeOwned>(self) -> Result<T, Error>

Consumes the response and deserializes the JSON body into the given type.

Examples

// Parse as serde_json::Value
let data: serde_json::Value = response.json().await?;
check_eq!("John", data["name"]);

// Parse into custom struct
#[derive(serde::Deserialize)]
struct User { name: String, id: u64 }
let user: User = response.json().await?;
check_eq!("John", user.name);

Trait Implementations

impl Clone for Response

fn clone(&self) -> Response

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Response

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.