Struct TestHarness 

pub struct TestHarness<D> { /* private fields */ }

The main test harness for running a driver unit test.

Implementations

impl<D: Driver> TestHarness<D>

pub fn new() -> Self

Creates a new TestHarness without a customized driver incoming ServiceFs.

pub fn set_driver_incoming( self, driver_incoming: ServiceFs<ServiceObj<'static, ()>>, ) -> Self

Sets the driver incoming ServiceFs. Consumes and returns self to allow chaining.

pub fn set_config(self, config: Vmo) -> Self

Sets the configuration vmo for the driver. Consumes and returns self to allow chaining.

pub fn set_url(self, url: &str) -> Self

Sets the url for the driver. Consumes and returns self to allow chaining.

pub fn set_node_name(self, name: impl Into<String>) -> Self

Sets the node name for the driver. Consumes and returns self to allow chaining.

pub fn add_offer(self, offer: Offer) -> Self

Adds an offer to the driver’s start args. Consumes and returns self to allow chaining.

pub fn set_power_element_args(self, args: impl IntoPowerElementArgs) -> Self

Sets the power element args for the driver. Accepts both fidl_next_fuchsia_driver_framework::PowerElementArgs and, for drivers that haven’t migrated yet, the legacy fidl_fuchsia_driver_framework::PowerElementArgs. Consumes and returns self to allow chaining.

pub fn set_node_token(self, token: Event) -> Self

Sets the node token for the driver. Consumes and returns self to allow chaining.

pub fn set_power_element_token(self, token: Event) -> Self

Sets the power element dependency token for the driver, as returned by crate::DriverContext::take_power_element_token. This only populates the token of the power element args; use Self::set_power_element_args to also provide the power broker endpoints. Consumes and returns self to allow chaining.

pub fn add_node_property( self, parent: &str, key: impl Into<String>, value: impl Into<PropertyValue>, ) -> Self

Adds a property of the parent node named parent to the driver’s start args, as reported by crate::DriverContext::node_properties. Drivers bound to a single node see their properties under the parent name default. Consumes and returns self to allow chaining.

pub fn dispatcher(&self) -> AsyncDispatcher

Gets a driver dispatcher that can be used to run test side driver transport client/servers.

pub async fn start_driver(&mut self) -> Result<DriverUnderTest<'_, D>, Status>

Starts the driver under test.

Trait Implementations

impl<D: Driver> Default for TestHarness<D>

fn default() -> Self

Returns the “default value” for a type.

impl<D> Drop for TestHarness<D>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.