Struct AppTester 

pub struct AppTester<App>
where
    App: App,
{ /* private fields */ }

👎Deprecated since 0.17.0: AppTester has been deprecated and is left for backwards compatibility of test suites only. Apps can be tested without it using the Command API.

AppTester is a simplified execution environment for Crux apps for use in tests.

Please note that the AppTester is strictly no longer required now that Crux has a new Command API. To test apps without the AppTester, you can call the update method on your app directly, and then inspect the effects returned by the command. For examples of how to do this, consult any of the examples in the Crux repository. The AppTester is still provided for backwards compatibility, and to allow you to migrate to the new API without changing the tests, giving you increased confidence in your refactor.

Create an instance of AppTester with your App and an Effect type using AppTester::default.

for example:

let app = AppTester::<ExampleApp, ExampleEffect>::default();

Implementations

impl<App> AppTester<App>

where App: App + Default, App::Model: Default,

pub fn new(app: App) -> Self

Create an AppTester instance for an existing app instance. This can be used if your App has a constructor other than Default, for example when used as a child app and expecting configuration from the parent

pub fn update( &self, event: App::Event, model: &mut App::Model, ) -> Update<App::Effect, App::Event>

Run the app’s update function with an event and a model state

You can use the resulting Update to inspect the effects which were requested and potential further events dispatched by capabilities.

Panics

May panic when the internal lock is poisoned

pub fn resolve<Output>( &self, request: &mut impl Resolvable<Output>, value: Output, ) -> Result<Update<App::Effect, App::Event>>

Resolve an effect request from previous update with an operation output.

This potentially runs the app’s update function if the effect is completed, and produce another Update.

Errors

Errors if the request cannot (or should not) be resolved.

Panics

May panic when the internal lock is poisoned

pub fn resolve_to_event_then_update<Op: Operation>( &self, request: &mut Request<Op>, value: Op::Output, model: &mut App::Model, ) -> Update<App::Effect, App::Event>

Resolve an effect request from previous update, then run the resulting event

This helper is useful for the common case where one expects the effect to resolve to exactly one event, which should then be run by the app.

Panics

Panics if the request cannot be resolved.

pub fn view(&self, model: &App::Model) -> App::ViewModel

Run the app’s view function with a model state

Trait Implementations

impl<App> Default for AppTester<App>

where App: App + Default, App::Model: Default,

fn default() -> Self

Returns the “default value” for a type.