Struct RunOptions

pub struct RunOptions {
    pub run_disabled_tests: Option<bool>,
    pub parallel: Option<u16>,
    pub arguments: Option<Vec<String>>,
    pub timeout: Option<i64>,
    pub case_filters_to_run: Option<Vec<String>>,
    pub log_iterator: Option<LogsIteratorOption>,
    pub log_interest: Option<Vec<LogInterestSelector>>,
    pub break_on_failure: Option<bool>,
    pub no_exception_channel: Option<bool>,
    /* private fields */
}

Optional additional instructions for executing a test suite.

Fields

run_disabled_tests: Option<bool>

If set to true, test cases that have been disabled by the test author will nonetheless be executed. Defaults to false.

parallel: Option<u16>

Defines maximum number of test cases to run simultaneously. If unspecified, the default behavior is chosen by the Suite implementation.

arguments: Option<Vec<String>>

Optional arguments to pass to the test. Test runners will decide how to pass these arguments to tests.

timeout: Option<i64>

Timeout in seconds for the entire suite.

case_filters_to_run: Option<Vec<String>>

glob case filter. This filter will match based on glob pattern [https://en.wikipedia.org/wiki/Glob_(programming)]. Only test cases matching at least one pattern will be run. In addition, negative filters may be specified by prepending ‘-’. When negative filters are specified, test cases matching the negative filter are excluded. The behavior of combinations of these filters is as follows:

• When no filters are specified, all test cases are run.
• When only positive filters are specified, test cases that match at least one filter are run.
• When only negative filters are specified, test cases that match none of the filters are run.
• When both positive and negative filters are specified, test cases that match at least one positive filter, but do not match any negative filters, are run.

For example, given that a suite has the test cases Foo.Test1, Foo.Test2, Bar.Test1, and Bar.Test2:

• The filters ["Foo.*"] will execute Foo.Test1 and Foo.Test2.
• The filters ["-Foo.*"] will execute Bar.Test1 and Bar.Test2.
• The filters ["Foo.*", "-*.Test1"] will execute Foo.Test2.

log_iterator: Option<LogsIteratorOption>

Defines what kind of log iterator the client supports. Default value is Batch iterator.

log_interest: Option<Vec<LogInterestSelector>>

Configures the minimum severity for the components under test.

break_on_failure: Option<bool>

If true, the test runner should halt (if supported) the test suite when a failure is encountered such that a debugger may attach to the process in the future. Test runners may safely ignore this if they do not support stopping running test suites.

no_exception_channel: Option<bool>

If true, indicates the test creates an exception channel. In this case, the test manager will refrain from creating its own exception channels to avoid conflicts. Default value is false.

Trait Implementations

impl Clone for RunOptions

fn clone(&self) -> RunOptions

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RunOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<D: ResourceDialect> Decode<RunOptions, D> for RunOptions

fn new_empty() -> Self

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, D>, offset: usize, depth: Depth, ) -> Result<()>

Decodes an object of type T from the decoder’s buffers into self.

impl Default for RunOptions

fn default() -> RunOptions

Returns the “default value” for a type.

impl<D: ResourceDialect> Encode<RunOptions, D> for &RunOptions

unsafe fn encode( self, encoder: &mut Encoder<'_, D>, offset: usize, depth: Depth, ) -> Result<()>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl PartialEq for RunOptions

fn eq(&self, other: &RunOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TypeMarker for RunOptions

type Owned = RunOptions

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl ValueTypeMarker for RunOptions

type Borrowed<'a> = &'a RunOptions

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &Self::Owned. There are three cases:

fn borrow(value: &<Self as TypeMarker>::Owned) -> Self::Borrowed<'_>

Cheaply converts from &Self::Owned to Self::Borrowed.

impl Persistable for RunOptions

impl StructuralPartialEq for RunOptions