Struct dockertest_server::test::TestInstance

pub struct TestInstance {
    pub configs: TypeMap,
    pub op: DockerOperations,
}

Represents a running instance of a Test.

Internally, this type keeps track of all Configs that were registered with a Test using a TypeMap. A Server can be fetched by calling the server method with the desired type that implements Server. See the associated method documentation for more details.

Fields

configs: TypeMap

op: DockerOperations

Implementations

impl TestInstance

pub fn new(configs: TypeMap, op: DockerOperations) -> Self

Returns a new TestInstance.

pub fn server<S: Server>(&self) -> S

Returns an instance of the requested type that implements Server.

Internally a TestInstance has a TypeMap which contains all of the Configs that were registered with a given Test. Since each Config has a one-to-one relationship with a Server, an instance of a Server can be created by simply having a copy of it’s associated Config. This method performs that mapping for you, looking for a Config of the type specified by Server::Config in the type map and then generating and returning a new instance of the Server using the Config and runtime data generated when the underlying container was brought up.

Note that it then follows this method will fail if the passed Server type did not have it’s associated Config registered when the Test was created.