Struct ExpectedStatusCodes

pub struct ExpectedStatusCodes { /* private fields */ }

Expected status codes for HTTP requests.

Supports multiple ranges and individual status codes for flexible validation.

Implementations

impl ExpectedStatusCodes

pub fn new() -> Self

Creates a new set of expected status codes with default range (200..500).

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

Adds a single status code as valid.

pub fn add_inclusive_range(self, range: RangeInclusive<u16>) -> Self

Adds an inclusive range of status codes.

pub fn add_exclusive_range(self, range: Range<u16>) -> Self

Adds an exclusive range of status codes.

pub fn from_inclusive_range(range: RangeInclusive<u16>) -> Self

Creates expected status codes from a single inclusive range.

Panics

Panics if the range contains invalid HTTP status codes (outside 100-599).

pub fn from_exclusive_range(range: Range<u16>) -> Self

Creates expected status codes from a single exclusive range.

Panics

Panics if the range contains invalid HTTP status codes (outside 100-599).

pub fn from_single(status: u16) -> Self

Creates expected status codes from a single status code.

Panics

Panics if the status code is invalid (outside 100-599).

pub fn from_status_code(status: StatusCode) -> Self

Creates expected status codes from a single http::StatusCode.

This method provides compile-time validation of status codes through the type system. Unlike the u16 variants, this method does not perform runtime validation since http::StatusCode guarantees valid HTTP status codes at compile time.

Example

use clawspec_core::ExpectedStatusCodes;
use http::StatusCode;

let codes = ExpectedStatusCodes::from_status_code(StatusCode::OK);
assert!(codes.contains(200));

pub fn from_status_code_range_inclusive( range: RangeInclusive<StatusCode>, ) -> Self

Creates expected status codes from an inclusive range of http::StatusCode.

This method provides compile-time validation of status codes through the type system. Unlike the u16 variants, this method does not perform runtime validation since http::StatusCode guarantees valid HTTP status codes at compile time.

Example

use clawspec_core::ExpectedStatusCodes;
use http::StatusCode;

let codes = ExpectedStatusCodes::from_status_code_range_inclusive(
    StatusCode::OK..=StatusCode::NO_CONTENT
);
assert!(codes.contains(200));
assert!(codes.contains(204));
assert!(!codes.contains(205));

pub fn from_status_code_range_exclusive(range: Range<StatusCode>) -> Self

Creates expected status codes from an exclusive range of http::StatusCode.

This method provides compile-time validation of status codes through the type system. Unlike the u16 variants, this method does not perform runtime validation since http::StatusCode guarantees valid HTTP status codes at compile time.

Example

use clawspec_core::ExpectedStatusCodes;
use http::StatusCode;

let codes = ExpectedStatusCodes::from_status_code_range_exclusive(
    StatusCode::OK..StatusCode::PARTIAL_CONTENT
);
assert!(codes.contains(200));
assert!(codes.contains(204));
assert!(!codes.contains(206));

pub fn contains(&self, status: u16) -> bool

Checks if a status code is expected/valid.

pub fn contains_status_code(&self, status: StatusCode) -> bool

Checks if an http::StatusCode is expected/valid.

This is a convenience method that accepts http::StatusCode directly.

Example

use clawspec_core::ExpectedStatusCodes;
use http::StatusCode;

let codes = ExpectedStatusCodes::from_status_code(StatusCode::OK);
assert!(codes.contains_status_code(StatusCode::OK));
assert!(!codes.contains_status_code(StatusCode::NOT_FOUND));

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

Adds a single expected status code (method used by ApiCall).

pub fn add_expected_range(self, range: RangeInclusive<u16>) -> Self

Adds an expected inclusive range of status codes (method used by ApiCall).

Trait Implementations

impl Clone for ExpectedStatusCodes

fn clone(&self) -> ExpectedStatusCodes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExpectedStatusCodes

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

Formats the value using the given formatter.

impl Default for ExpectedStatusCodes

fn default() -> Self

Returns the “default value” for a type.