run_test_suite_lib/
params.rs

1// Copyright 2022 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5use diagnostics_data::Severity;
6use fidl_fuchsia_diagnostics::LogInterestSelector;
7use fidl_fuchsia_test_manager as ftest_manager;
8use std::sync::Arc;
9use test_list::TestTag;
10
11/// Parameters that specify how a single test suite should be executed.
12#[derive(Clone, Debug, PartialEq, Default)]
13pub struct TestParams {
14    /// Test URL.
15    pub test_url: String,
16
17    /// Provided test realm.
18    pub realm: Arc<Option<crate::realm::Realm>>,
19
20    /// Test timeout. Must be more than zero.
21    pub timeout_seconds: Option<std::num::NonZeroU32>,
22
23    /// Filter tests based on glob pattern(s).
24    pub test_filters: Option<Vec<String>>,
25
26    /// Run disabled tests.
27    pub also_run_disabled_tests: bool,
28
29    /// Test concurrency count.
30    pub parallel: Option<u16>,
31
32    /// Arguments to pass to test using command line.
33    pub test_args: Vec<String>,
34
35    /// Maximum allowable log severity for the test.
36    pub max_severity_logs: Option<Severity>,
37
38    /// Minimum requested log severity to print for the test.
39    pub min_severity_logs: Vec<LogInterestSelector>,
40
41    /// List of tags to associate with this test's output.
42    pub tags: Vec<TestTag>,
43
44    /// Stop the test suite on the first test failure so a debugger can attach.
45    pub break_on_failure: bool,
46
47    /// Don't create exception channels, which may conflict with the exception channels created
48    /// by the test.
49    pub no_exception_channel: bool,
50}
51
52/// Parameters that specify how the overall test run should be executed.
53pub struct RunParams {
54    /// The behavior of the test run if a suite times out.
55    pub timeout_behavior: TimeoutBehavior,
56
57    /// Time in seconds to wait for events to drain after timeout.
58    pub timeout_grace_seconds: u32,
59
60    /// If set, stop executing tests after this number of normal test failures occur.
61    pub stop_after_failures: Option<std::num::NonZeroU32>,
62
63    /// If set, execute this number of test suites in parallel.
64    /// Server will use default value if this is zero.
65    pub experimental_parallel_execution: Option<u16>,
66
67    /// Whether or not to merge debug data from previous runs with new debug data collected
68    /// for this test run.
69    pub accumulate_debug_data: bool,
70
71    /// If set, set the protocol used to retrieve logs. If not set, an appropriate default
72    /// will be chosen by the implementation.
73    pub log_protocol: Option<ftest_manager::LogsIteratorOption>,
74
75    /// If set, specifies the minimum log severity to report. As it is an
76    /// option for output, it will likely soon be moved to a reporter.
77    pub min_severity_logs: Vec<LogInterestSelector>,
78
79    /// If true, shows the full moniker in logs.
80    pub show_full_moniker: bool,
81}
82
83/// Sets the behavior of the overall run if a suite terminates with a timeout.
84#[derive(PartialEq)]
85pub enum TimeoutBehavior {
86    /// Immediately terminate any suites that haven't started.
87    TerminateRemaining,
88    /// Continue executing any suites that haven't finished.
89    Continue,
90}
run_test_suite_lib/params.rs

run_test_suite_lib/
params.rs
