Struct Http 

pub struct Http;

The outbound HTTP client.

A facade over whichever Transport is installed, so fake swaps what every call in the process does — the same way rebinding a service swaps what a Rainier facade sees.

Implementations

impl Http

pub fn get(url: impl Into<String>) -> PendingRequest

GET url.

pub fn post(url: impl Into<String>) -> PendingRequest

POST url.

pub fn put(url: impl Into<String>) -> PendingRequest

PUT url.

pub fn patch(url: impl Into<String>) -> PendingRequest

PATCH url.

pub fn delete(url: impl Into<String>) -> PendingRequest

DELETE url.

pub fn request( method: impl Into<String>, url: impl Into<String>, ) -> PendingRequest

A request with any method.

pub fn install(transport: Arc<dyn Transport>)

Install the transport every call uses.

Called once at boot. Calling it again replaces the binding, which is what fake does.

pub fn fake() -> Arc<FakeTransport>

Record every outbound call instead of making it.

Returns the fake, so a test can queue answers:

Http::fake().responding(200, r#"{"ok":true}"#);

Nothing reaches the network afterwards, which is the other half of the point: a suite that accidentally calls a real endpoint is a suite that fails when somebody runs it on a train.

pub fn fake_globally() -> Arc<FakeTransport>

Record every outbound call in the whole process.

For code that spawns: a task started by the code under test inherits no thread scope, so fake would not catch its calls.

The trade is that two tests doing this at once overwrite each other, so a suite using it has to run those tests one at a time.

pub fn faking() -> Arc<FakeTransport>

The installed fake.

Panics

If nothing is faking. Every Rainier double refuses to let an assertion pass vacuously, and this is the same rule: an assert_sent that silently passed because somebody forgot fake is the most dangerous test in a suite.

pub fn assert_sent(matches: impl Fn(&RecordedRequest) -> bool)

Panic unless a matching request was sent. See FakeTransport::assert_sent.

Panics

If none matched, or if nothing is faking.

pub fn assert_not_sent(matches: impl Fn(&RecordedRequest) -> bool)

Panic if a matching request was sent.

Panics

If one was, or if nothing is faking.

pub fn assert_nothing_sent()

Panic unless nothing was sent.

Panics

If anything was, or if nothing is faking.

pub fn clear()

Stop faking, and install nothing in its place.

Clears both the thread scope and the process-wide binding.