Struct libcnb_test::TestRunner

pub struct TestRunner {}

Runner for libcnb integration tests.

Example

use libcnb_test::{assert_contains, assert_empty, BuildConfig, TestRunner};

TestRunner::default().build(
    BuildConfig::new("heroku/builder:22", "tests/fixtures/app"),
    |context| {
        assert_empty!(context.pack_stderr);
        assert_contains!(context.pack_stdout, "Expected build output");
    },
)

Implementations

impl TestRunner

pub fn build<C: Borrow<BuildConfig>, F: FnOnce(TestContext<'_>)>( &self, config: C, f: F )

Starts a new integration test build.

This function copies the application to a temporary directory (if necessary), cross-compiles the current crate, packages it as a buildpack and then invokes pack to build a new Docker image with the buildpacks specified by the passed BuildConfig.

After the passed test function has returned, the Docker image and volumes created by Pack are removed.

Since this function is supposed to only be used in integration tests, failures are not signalled via Result values. Instead, this function panics whenever an unexpected error occurred to simplify testing code.

Example

use libcnb_test::{assert_contains, assert_empty, BuildConfig, TestRunner};

TestRunner::default().build(
    BuildConfig::new("heroku/builder:22", "tests/fixtures/app"),
    |context| {
        assert_empty!(context.pack_stderr);
        assert_contains!(context.pack_stdout, "Expected build output");
    },
)

Trait Implementations

impl Default for TestRunner

fn default() -> TestRunner

Returns the “default value” for a type.