Struct Response 

pub struct Response {
    pub status: u16,
    pub headers: Vec<(String, String)>,
    pub body: String,
}

A response in a request test, with chainable assertions (Rails’ assert_response, assert_redirected_to, assert_match).

Assertions panic with the status and the start of the body, and return the response so they chain.

Examples

let mut client = ocre::testing::Client::new();
client.get("/posts").assert_status(200).assert_contains("<h1>Posts</h1>");

Fields

status: u16

HTTP status code.

headers: Vec<(String, String)>

Headers in the order received, names lowercase.

body: String

Body as text (invalid UTF-8 replaced); empty for HEAD, 204 and 304.

Implementations

impl Response

pub fn header(&self, name: &str) -> Option<&str>

The first value of the header name (any case).

Examples

let response = ocre::testing::Response { status: 200, headers: vec![("content-type".into(), "text/html".into())], body: String::new() };
assert_eq!(response.header("Content-Type"), Some("text/html"));

pub fn location(&self) -> Option<&str>

The Location header of a redirect.

Examples

let response = ocre::testing::Response { status: 303, headers: vec![("location".into(), "/posts/1".into())], body: String::new() };
assert_eq!(response.location(), Some("/posts/1"));

pub fn json<T: DeserializeOwned>(&self) -> T

The body parsed as JSON (Rails’ response.parsed_body).

Panics

When the body is not JSON of type T.

Examples

let response = ocre::testing::Response { status: 200, headers: vec![], body: r#"{"id":1}"#.into() };
assert_eq!(response.json::<ocre::serde_json::Value>()["id"], 1);

pub fn assert_status(&self, status: u16) -> &Self

Asserts the status code (Rails’ assert_response 201).

Examples

let response = ocre::testing::Response { status: 404, headers: vec![], body: String::new() };
response.assert_status(404);

pub fn assert_success(&self) -> &Self

Asserts a 2xx status (Rails’ assert_response :success).

Examples

let response = ocre::testing::Response { status: 204, headers: vec![], body: String::new() };
response.assert_success();

pub fn assert_redirect_to(&self, location: &str) -> &Self

Asserts a 3xx redirect to location (Rails’ assert_redirected_to).

Examples

let response = ocre::testing::Response { status: 303, headers: vec![("location".into(), "/posts/1".into())], body: String::new() };
response.assert_redirect_to("/posts/1");

pub fn assert_contains(&self, text: &str) -> &Self

Asserts the body contains text (HTML-escaped as templates escape it: ' is ').

Examples

let response = ocre::testing::Response { status: 200, headers: vec![], body: "<h1>Posts</h1>".into() };
response.assert_contains("<h1>Posts</h1>");

pub fn assert_not_contains(&self, text: &str) -> &Self

Asserts the body does not contain text.

Examples

let response = ocre::testing::Response { status: 200, headers: vec![], body: "<h1>Posts</h1>".into() };
response.assert_not_contains("Error");

pub fn assert_header(&self, name: &str, value: &str) -> &Self

Asserts the header name has value.

Examples

let response = ocre::testing::Response { status: 200, headers: vec![("content-type".into(), "application/json".into())], body: String::new() };
response.assert_header("Content-Type", "application/json");

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.