Crate stubr_attributes

Expand description

stubr-attributes

Macros for stubr

#[stubr::mock]

Starts a Stubr mock server and creates a stubr variable which can be used to call the server e.g. stubr.uri(). It supports both standard and async test functions.

use isahc;
use asserhttp::*; // optional

#[test]
#[stubr::mock] // <- takes stubs under crate's "tests/stubs" by default
fn simple_test() {
    isahc::get(stubr.uri()).expect_status_ok();
}

Can also be used for recording with #[stubr::record]. It will spawn a standalone proxy which will record all http exchanges.
A recorder variable is created so that you can interact with the proxy. You then need to configure your http client to use this proxy. With record-isahc or record-reqwest features you can get an http client configured to hit the recorder proxy. It supports both standard and async test functions.

use isahc;
use asserhttp::*; // optional

#[stubr::mock]
#[stubr::record] // <- takes stubs under crate's "tests/stubs" by default
#[test]
fn simple_test() {
    recorder.isahc_client().get(stubr.uri()).expect_status_ok();
    // a recorded stub has been created under 'target/stubs'
}

#[stubr::apps]

Starts a Stubr server for each remote app name supplied.
Those remote apps’ stubs are imported by stubr-build and will help you test your app’s dependencies over other apps/microservices using http.

use isahc;
use asserhttp::*; // optional

#[test]
#[stubr::apps("producer-a", "producer-b")] // <- start a server for each app
fn using_producers() {
    // a binding is created for each app supplied with the name of the app
    isahc::get(producer_a.uri()).expect_status_ok();
    isahc::get(producer_b.uri()).expect_status_ok();
}

Attribute Macros

apps

Starts a Stubr server for each remote app name supplied.

mock

Starts a Stubr mock server and creates a stubr variable which can be used to call the server e.g. stubr.uri(). It supports both standard and async test functions.

record

Starts a Stubr recorder server and creates a recorder variable which can be used to call the server e.g. stubr.isahc_client().