Struct Drive 

pub struct Drive { /* private fields */ }

The handle a test drives the app with. Every method awaits the op and fails the test with the step’s own message when the op fails after its retry window.

Implementations

impl Drive

pub fn new(backend: Rc<dyn DriveBackend>) -> Self

A drive over backend; the engine and the mock harness build one per test.

pub fn tap(&self, id: &str) -> OpFuture

pub fn input(&self, id: &str, text: &str) -> OpFuture

Type text into the field, replacing what it holds.

pub fn toggle(&self, id: &str, on: bool) -> OpFuture

pub fn set_value(&self, id: &str, value: f64) -> OpFuture

pub fn select(&self, id: &str, index: usize) -> OpFuture

pub fn focus(&self, id: &str) -> OpFuture

pub fn submit(&self, id: &str) -> OpFuture

pub fn navigate(&self, route: &str) -> OpFuture

pub fn wait_idle(&self) -> OpFuture

Let native transitions settle.

pub fn pause(&self, secs: f64) -> OpFuture

pub fn shot(&self, name: &str) -> OpFuture

Capture the window as name; the capture rides the test’s record to the runner.

pub fn assert_text(&self, id: &str, text: &str) -> OpFuture

pub fn assert_visible(&self, id: &str) -> OpFuture

pub fn assert_missing(&self, id: &str) -> OpFuture

pub fn hover(&self, id: &str, at: Option<(f64, f64)>) -> OpFuture

The pointer entering id at (x, y) in its coordinates (its center for None).

pub fn hover_leave(&self, id: &str) -> OpFuture

The pointer leaving id.

pub fn pan(&self, id: &str, dx: f64, dy: f64) -> OpFuture

A two-finger pan over id by (dx, dy) in total.

pub fn pinch(&self, id: &str, scale: f64) -> OpFuture

A pinch over id to scale (cumulative; 1 = unchanged).

pub fn drag(&self, id: &str, from: (f64, f64), to: (f64, f64)) -> OpFuture

A pointer drag over id from from to to, in its coordinates.

pub fn tap_at(&self, id: &str, x: f64, y: f64) -> OpFuture

A tap at (x, y) in id’s coordinates.

pub fn key(&self, id: Option<&str>, key: &str) -> OpFuture

A key press (web KeyboardEvent.key names: "Enter", "ArrowRight", "a") to id, or to whatever holds focus for None.

pub fn assert_announced(&self, text: &str) -> OpFuture

That the app announced text to the screen reader during the run.

pub fn assert_hidden(&self, id: &str) -> OpFuture

That an element is not on screen: missing, with an empty frame, or hidden natively (a collapsed pane a toolkit keeps built).

pub fn assert_value(&self, id: &str, value: f64) -> OpFuture

pub fn assert_on(&self, id: &str, on: bool) -> OpFuture

A toggle’s on/off state.

pub fn assert_focused(&self, id: &str, focused: bool) -> OpFuture

pub fn assert_route(&self, route: &str) -> OpFuture

pub fn a11y_audit(&self, id: Option<&str>) -> OpFuture

Diff the native accessibility tree against Day’s expectation for id (all id’d nodes when None), where the toolkit can read its tree back.

pub fn assert_native(&self, id: &str, expect: NativeExpect) -> OpFuture

The native widget’s own state, as the platform reports it (docs/testing.md). A field the toolkit cannot read is recorded in the report as unread rather than failed. In a conformance run assert_text, assert_value and assert_on check the native widget too; this is for what they do not cover.

pub fn assert_frame(&self, id: &str, expect: FrameExpect) -> OpFuture

The element’s frame in Day’s layout and, where the toolkit reads it back, natively.

pub fn assert_size(&self, id: &str, width: f64, height: f64) -> OpFuture

The element’s size, the common case of Drive::assert_frame.

pub fn sample_pixel(&self, id: &str, x: f64, y: f64, color: &str) -> OpFuture

The color drawn at (x, y), fractions of the element’s frame, as #rrggbb. Passes as unread where the toolkit has no capture.

pub fn assert_opened_url(&self, url: &str) -> OpFuture

That the app asked to open url (a link, day::open_url) during the run; in a run nothing actually opens.

pub fn assert_enabled(&self, id: &str, enabled: bool) -> OpFuture

Whether the element takes input, in Day’s tree and in the native widget.

pub fn activate(&self, id: &str, index: usize) -> OpFuture

Activate a list’s row by position: what a double click, Return or a phone’s tap commits.

pub fn reorder(&self, id: &str, from: usize, to: usize) -> OpFuture

Move a list’s row from from to to, as a native drag-to-reorder commits it.

pub fn delete_row(&self, id: &str, row: usize) -> OpFuture

Delete a list’s row, as the platform’s delete gesture commits it.

pub fn swipe_row( &self, id: &str, row: usize, leading: bool, action: usize, ) -> OpFuture

Press the actionth swipe action on a list row’s leading or trailing edge.

pub fn scroll_to(&self, id: &str, edge: &str) -> OpFuture

Scroll a scroll view or list to an edge: "top", "bottom", "leading", "trailing".

pub fn expand(&self, id: &str, row: &str, expanded: bool) -> OpFuture

Expand or collapse a tree’s row, named by its row id.

pub fn nav_back(&self) -> OpFuture

Go back one page in the innermost navigation stack.

pub fn tree_move( &self, id: &str, row: &str, parent: Option<&str>, index: Option<usize>, ) -> OpFuture

Move a tree’s row (by row id) under parent (None = the root level), at index among its new siblings (None = last), as a native drag commits it.

pub fn context_menu(&self, id: &str, item: &str) -> OpFuture

Choose the item labeled item from id’s context menu, as a right click (or long press) and a choice would.

pub fn menu(&self, item_id: &str) -> OpFuture

Choose an app-menu item by the id the app gave it (MenuEntry::id).

pub fn toolbar_press(&self, item: &str) -> OpFuture

Press the toolbar button item.

pub fn toolbar_toggle(&self, item: &str, on: bool) -> OpFuture

Turn the toolbar toggle item on or off.

pub fn dialogs_scripted(&self, scripted: bool) -> OpFuture

Show presentations natively (false, the default) or hold them for Drive::respond without any native dialog (true). In native mode respond still answers, and the toolkit dismisses the dialog it showed.

pub fn assert_presented(&self, title: Option<&str>) -> OpFuture

That a dialog or picker is pending, titled title where one is given.

pub fn respond(&self, button: Option<usize>) -> OpFuture

Answer the pending dialog with the button at button (presentation order), or dismiss it for None.

pub fn respond_text(&self, text: &str) -> OpFuture

Confirm a pending text prompt.

pub fn check(&self, ok: bool, what: &str) -> TestResult

A plain assertion for a headless test: fails with what when ok is false.

pub fn check_eq<T: PartialEq + Debug>(&self, got: T, want: T) -> TestResult

Equality for a headless test, naming both sides on a mismatch.

Trait Implementations

impl Clone for Drive

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.