Struct SimpleTest 

pub struct SimpleTest<A, F> {
    pub host_requirements: Option<TestCaseRequirements>,
    /* private fields */
}

A test defined by an artifact resolver function and a run function.

Fields

host_requirements: Option<TestCaseRequirements>

Optional test requirements

Implementations

impl<A, AR, F, E> SimpleTest<A, F>

where A: 'static + Send + Fn(&ArtifactResolver<'_>) -> Option<AR>, F: 'static + Send + AsyncFn(PetriTestParams<'_>, DefaultDriver, AR) -> Result<(), E>, E: Into<Error>,

pub fn new_async( leaf_name: &'static str, resolve: A, run: F, ) -> SimpleTest<A, impl 'static + Send + Fn(PetriTestParams<'_>, AR) -> Result<(), E>>

Returns a new test with the given leaf_name, resolve, and run functions, whose run function is async, running it on a task pool owned by petri.

The test defaults to stable, not ignored, with no host requirements and a RemoteAccess::LocalOnly policy. Use the builder methods (requirements, unstable, ignore, remote_access) to override these.

impl<A, AR, F, E> SimpleTest<A, F>

where A: 'static + Send + Fn(&ArtifactResolver<'_>) -> Option<AR>, F: 'static + Send + Fn(PetriTestParams<'_>, AR) -> Result<(), E>, E: Into<Error>,

pub fn new_sync(leaf_name: &'static str, resolve: A, run: F) -> Self

Returns a new test with the given leaf_name, resolve, and run functions.

Use new_async instead if the test constructs a PetriVm; its diagnostics on failure rely on petri owning the task pool.

The test defaults to stable, not ignored, with no host requirements and a RemoteAccess::LocalOnly policy. Use the builder methods (requirements, unstable, ignore, remote_access) to override these.

impl<A, F> SimpleTest<A, F>

pub fn requirements(self, requirements: TestCaseRequirements) -> Self

Sets the host requirements that must be satisfied for this test to run.

pub fn unstable(self, reason: &'static str) -> Self

Marks this test as unstable. When PETRI_IGNORE_UNSTABLE_FAILURES is set (as it is in CI), a failure of this test is logged and ignored rather than failing the run; otherwise it fails like any other test.

reason documents why the test is unstable and is logged when an unstable failure is ignored.

pub fn unstable_on( self, reason: &'static str, requirement: TestRequirement, ) -> Self

Marks this test as unstable only on hosts that satisfy requirement.

On other hosts the test still runs, but failures remain gating. This does not change the test’s host eligibility requirements.

pub fn ignore(self) -> Self

Marks this test as ignored: it is skipped by default and only runs when explicitly requested (like a libtest #[ignore] test).

pub fn remote_access(self, policy: RemoteAccess) -> Self

Sets the remote-access policy used when resolving artifacts.

Trait Implementations

impl<A, AR, F, E> RunTest for SimpleTest<A, F>

where A: 'static + Send + Fn(&ArtifactResolver<'_>) -> Option<AR>, F: 'static + Send + Fn(PetriTestParams<'_>, AR) -> Result<(), E>, E: Into<Error>,

type Artifacts = AR

The type of artifacts required by the test.

fn leaf_name(&self) -> &str

The leaf name of the test.

fn resolve(&self, resolver: ArtifactResolver<'_>) -> Option<Self::Artifacts>

Returns the artifacts required by the test.

fn run( &self, params: PetriTestParams<'_>, artifacts: Self::Artifacts, ) -> Result<()>

Runs the test, which has been assigned name, with the given artifacts.

fn host_requirements(&self) -> Option<&TestCaseRequirements>

Returns the host requirements of the current test, if any.

fn unstable(&self, host_context: &HostContext) -> Option<&str>

Returns the reason this test is unstable on this host, or None if stable.

fn ignored(&self) -> bool

Whether this test is ignored (skipped by default, like a libtest #[ignore] test).