test_runners_lib/
errors.rs

1// Copyright 2020 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
5//! Type definitions for common errors related to running component or tests.
6
7use crate::elf::{ComponentError, KernelError};
8use crate::launch::LaunchError;
9use crate::logs::LogError;
10
11use namespace::NamespaceError;
12use std::sync::Arc;
13use thiserror::Error;
14
15/// Error encountered while enumerating test.
16///
17/// This must be `Clone`-able because enumeration futures are memoized.
18#[derive(Debug, Error, Clone)]
19pub enum EnumerationError {
20    #[error("{:?}", _0)]
21    Namespace(#[source] Arc<NamespaceError>),
22
23    #[error("error launching test: {:?}", _0)]
24    LaunchTest(#[source] Arc<LaunchError>),
25
26    #[error("{:?}", _0)]
27    Io(#[source] Arc<IoError>),
28
29    #[error("can't get test list")]
30    ListTest,
31
32    #[error("can't get test list: {:?}", _0)]
33    JsonParse(#[source] Arc<serde_json::error::Error>),
34
35    #[error("can't convert to string, refer https://fxbug.dev/42122698: {:?}", _0)]
36    Utf8ToString(#[from] std::str::Utf8Error),
37
38    #[error("{:?}", _0)]
39    Log(#[from] Arc<LogError>),
40
41    #[error("{:?}", _0)]
42    Kernel(#[from] Arc<KernelError>),
43
44    #[error("{:?}", _0)]
45    Component(#[from] Arc<ComponentError>),
46}
47
48impl From<NamespaceError> for EnumerationError {
49    fn from(e: NamespaceError) -> Self {
50        EnumerationError::Namespace(Arc::new(e))
51    }
52}
53
54impl From<KernelError> for EnumerationError {
55    fn from(e: KernelError) -> Self {
56        EnumerationError::Kernel(Arc::new(e))
57    }
58}
59
60impl From<LaunchError> for EnumerationError {
61    fn from(e: LaunchError) -> Self {
62        EnumerationError::LaunchTest(Arc::new(e))
63    }
64}
65
66impl From<IoError> for EnumerationError {
67    fn from(e: IoError) -> Self {
68        EnumerationError::Io(Arc::new(e))
69    }
70}
71
72impl From<serde_json::error::Error> for EnumerationError {
73    fn from(e: serde_json::error::Error) -> Self {
74        EnumerationError::JsonParse(Arc::new(e))
75    }
76}
77
78impl From<LogError> for EnumerationError {
79    fn from(e: LogError) -> Self {
80        EnumerationError::Log(Arc::new(e))
81    }
82}
83
84impl From<ComponentError> for EnumerationError {
85    fn from(e: ComponentError) -> Self {
86        EnumerationError::Component(Arc::new(e))
87    }
88}
89
90/// Error encountered while working with fuchsia::io
91#[derive(Debug, Error)]
92pub enum IoError {
93    #[error("cannot clone proxy: {:?}", _0)]
94    CloneProxy(#[source] anyhow::Error),
95
96    #[error("can't read file: {:?}", _0)]
97    File(#[source] anyhow::Error),
98}
99
100/// Error returned when validating arguments.
101#[derive(Debug, Error)]
102pub enum ArgumentError {
103    #[error("Restricted argument passed: {}.\nSee https://fuchsia.dev/fuchsia-src/concepts/testing/v2/test_runner_framework#passing_arguments to learn more.", _0)]
104    RestrictedArg(String),
105}
106
107/// Error encountered while running test.
108#[derive(Debug, Error)]
109pub enum RunTestError {
110    #[error("{:?}", _0)]
111    Namespace(#[from] NamespaceError),
112
113    #[error("error launching test: {:?}", _0)]
114    LaunchTest(#[from] LaunchError),
115
116    #[error("{:?}", _0)]
117    Io(#[from] IoError),
118
119    #[error("{:?}", _0)]
120    Log(#[from] LogError),
121
122    #[error("can't convert to string, refer https://fxbug.dev/42122698: {:?}", _0)]
123    Utf8ToString(#[from] std::str::Utf8Error),
124
125    #[error("cannot send start event: {:?}", _0)]
126    SendStart(#[source] fidl::Error),
127
128    #[error("cannot send finish event: {:?}", _0)]
129    SendFinish(#[source] fidl::Error),
130
131    #[error("cannot send on_finished event: {:?}", _0)]
132    SendFinishAllTests(#[source] fidl::Error),
133
134    #[error("Received unexpected exit code {} from test process.", _0)]
135    UnexpectedReturnCode(i64),
136
137    #[error("can't get test result: {:?}", _0)]
138    JsonParse(#[from] serde_json::error::Error),
139
140    #[error("Cannot get test process info: {}", _0)]
141    ProcessInfo(#[source] zx::Status),
142
143    #[error("Name in invocation cannot be null")]
144    TestCaseName,
145
146    #[error("error reloading list of tests: {:?}", _0)]
147    EnumerationError(#[from] EnumerationError),
148
149    #[error("{:?}", _0)]
150    Component(#[from] Arc<ComponentError>),
151}
152
153impl From<ComponentError> for RunTestError {
154    fn from(e: ComponentError) -> Self {
155        RunTestError::Component(Arc::new(e))
156    }
157}
test_runners_lib/errors.rs

test_runners_lib/
errors.rs
