Struct MatcherValue 

pub struct MatcherValue {
    pub value: String,
    pub not: bool,
    pub optional: bool,
}

A single matcher value for a request header, query-string parameter, cookie or path parameter.

MockServer’s plain-string wire form encodes negation and optionality as leading markers — ! negates and ? marks optional — and the server strips them unconditionally when reading. A value whose own first character is ! or ? therefore cannot be sent as a bare string: header("X-Tag", "!foo") is read back as “X-Tag is anything but foo”, which matches almost every request, so the expectation silently passes for the wrong reason instead of failing.

MatcherValue keeps the value and the flags apart and serialises to the object form ({"not":false,"value":"!foo"}) only when the plain form would be misread. Every value that already round-trips through the plain form stays byte-identical on the wire, so existing expectations are unaffected.

Use literal for an exact value, not_literal to negate one, and optional_literal for an optional exact value:

use mockserver_client::{HttpRequest, MatcherValue};

let request = HttpRequest::new()
    .header_matcher("X-Tag", MatcherValue::literal("!foo"))   // X-Tag IS "!foo"
    .header_matcher("X-Env", MatcherValue::not_literal("dev")); // X-Env is NOT "dev"

Fields

value: String

The matcher text, taken verbatim — markers in it are not parsed.

not: bool

Negate the matcher ("not": true).

optional: bool

Mark the header/parameter/cookie as optional ("optional": true).

Implementations

impl MatcherValue

pub fn literal(value: impl Into<String>) -> Self

A matcher for exactly value, even when it starts with ! or ?.

pub fn not_literal(value: impl Into<String>) -> Self

A matcher that matches anything except exactly value.

pub fn optional_literal(value: impl Into<String>) -> Self

A matcher for exactly value that need not be present.

Trait Implementations

impl Clone for MatcherValue

fn clone(&self) -> MatcherValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MatcherValue

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

Formats the value using the given formatter.

impl Default for MatcherValue

fn default() -> MatcherValue

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MatcherValue

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MatcherValue

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

Formats the value using the given formatter.

impl Eq for MatcherValue

impl From<&str> for MatcherValue

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for MatcherValue

fn from(s: String) -> Self

Parse a plain wire string, so an existing "!foo" keeps meaning “not foo”. The meaning is preserved; only the representation changes.

impl PartialEq for MatcherValue

fn eq(&self, other: &MatcherValue) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for MatcherValue

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MatcherValue