Struct google_api_proto::google::devtools::testing::v1::test_execution_service_client::TestExecutionServiceClient

pub struct TestExecutionServiceClient<T> { /* private fields */ }

A service for requesting test executions and querying their status.

This service is part of Firebase Test Lab. To learn about how to use the product, and how to integrate it with your system, visit https://firebase.google.com/docs/test-lab.

Each test execution will wait for available capacity. It will then be invoked as described. The test may be invoked multiple times if an infrastructure failure is detected. Results and other files generated by the test will be stored in an external storage system.

The TestExecutionService models this behavior using two resource types:

• TestMatrix: a group of one or more TestExecutions, built by taking a product of values over a pre-defined set of axes. In the case of Android Tests, for example, device model and OS version are two axes of the matrix.

• TestExecution: a single execution of one or more test targets on a single device. These are created automatically when a TestMatrix is created.

This service returns any error codes from the canonical error space (i.e. google.rpc.Code). The errors which may be returned are specified on each method. In addition, any method may return UNAVAILABLE or INTERNAL.

Implementations

impl<T> TestExecutionServiceClient<T>

where T: GrpcService<BoxBody>, T::Error: Into<StdError>, T::ResponseBody: Body<Data = Bytes> + Send + 'static, <T::ResponseBody as Body>::Error: Into<StdError> + Send,

pub fn new(inner: T) -> Self

pub fn with_origin(inner: T, origin: Uri) -> Self

pub fn with_interceptor<F>( inner: T, interceptor: F ) -> TestExecutionServiceClient<InterceptedService<T, F>>

where F: Interceptor, T::ResponseBody: Default, T: Service<Request<BoxBody>, Response = Response<<T as GrpcService<BoxBody>>::ResponseBody>>, <T as Service<Request<BoxBody>>>::Error: Into<StdError> + Send + Sync,

pub fn send_compressed(self, encoding: CompressionEncoding) -> Self

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

pub fn accept_compressed(self, encoding: CompressionEncoding) -> Self

Enable decompressing responses.

pub fn max_decoding_message_size(self, limit: usize) -> Self

Limits the maximum size of a decoded message.

Default: 4MB

pub fn max_encoding_message_size(self, limit: usize) -> Self

Limits the maximum size of an encoded message.

Default: usize::MAX

pub async fn create_test_matrix( &mut self, request: impl IntoRequest<CreateTestMatrixRequest> ) -> Result<Response<TestMatrix>, Status>

Creates and runs a matrix of tests according to the given specifications. Unsupported environments will be returned in the state UNSUPPORTED. A test matrix is limited to use at most 2000 devices in parallel.

The returned matrix will not yet contain the executions that will be created for this matrix. Execution creation happens later on and will require a call to GetTestMatrix.

May return any of the following canonical error codes:

• PERMISSION_DENIED - if the user is not authorized to write to project
• INVALID_ARGUMENT - if the request is malformed or if the matrix tries to use too many simultaneous devices.

pub async fn get_test_matrix( &mut self, request: impl IntoRequest<GetTestMatrixRequest> ) -> Result<Response<TestMatrix>, Status>

Checks the status of a test matrix and the executions once they are created.

The test matrix will contain the list of test executions to run if and only if the resultStorage.toolResultsExecution fields have been populated.

Note: Flaky test executions may be added to the matrix at a later stage.

May return any of the following canonical error codes:

• PERMISSION_DENIED - if the user is not authorized to read project
• INVALID_ARGUMENT - if the request is malformed
• NOT_FOUND - if the Test Matrix does not exist

pub async fn cancel_test_matrix( &mut self, request: impl IntoRequest<CancelTestMatrixRequest> ) -> Result<Response<CancelTestMatrixResponse>, Status>

Cancels unfinished test executions in a test matrix. This call returns immediately and cancellation proceeds asynchronously. If the matrix is already final, this operation will have no effect.

May return any of the following canonical error codes:

• PERMISSION_DENIED - if the user is not authorized to read project
• INVALID_ARGUMENT - if the request is malformed
• NOT_FOUND - if the Test Matrix does not exist

Trait Implementations

impl<T: Clone> Clone for TestExecutionServiceClient<T>

fn clone(&self) -> TestExecutionServiceClient<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for TestExecutionServiceClient<T>

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

Formats the value using the given formatter.