firebase_functions.test_lab_fn module

Cloud functions to handle Test Lab events.

Classes

ClientInfo

classfirebase_functions.test_lab_fn.ClientInfo(client:str,details:dict[str,str])

Bases:object

Information about the client which invoked the test.

client:str

Client name, such as "gcloud".

details:dict[str,str]

Map of detailed information about the client.

OutcomeSummary

classfirebase_functions.test_lab_fn.OutcomeSummary(value)

Bases:str,Enum

Outcome summary for a finished test matrix.

FAILURE='FAILURE'

A run failed, for instance:- One or more test case failed.- A test timed out.- The application under test crashed.

INCONCLUSIVE='INCONCLUSIVE'

Something unexpected happened. The test run should still be consideredunsuccessful but this is likely a transient problem and re-running thetest might be successful.

OUTCOME_SUMMARY_UNSPECIFIED='OUTCOME_SUMMARY_UNSPECIFIED'

The default value. This value is used if the state is omitted.

SKIPPED='SKIPPED'

All tests were skipped.

SUCCESS='SUCCESS'

The test matrix run was successful, for instance:- All test cases passed.- No crash of the application under test was detected.

ResultStorage

classfirebase_functions.test_lab_fn.ResultStorage(tool_results_history:str,results_uri:str,gcs_path:str,tool_results_execution:str|None=None)

Bases:object

Locations where test results are stored.

gcs_path:str

Location in Google Cloud Storage where test results are written to.In the form "gs://bucket/path/to/somewhere".

results_uri:str

URI to the test results in the Firebase Web Console.

tool_results_execution:str|None=None

Tool Results execution resource containing test results. Format isprojects/{project_id}/histories/{history_id}/executions/{execution_id}.Optional, can be omitted in erroneous test states.Seehttps://firebase.google.com/docs/test-lab/reference/toolresults/restfor more information.

tool_results_history:str

Tool Results history resource containing test results. Format isprojects/{project_id}/histories/{history_id}.Seehttps://firebase.google.com/docs/test-lab/reference/toolresults/restfor more information.

TestMatrixCompletedData

classfirebase_functions.test_lab_fn.TestMatrixCompletedData(create_time:datetime,state:TestState,invalid_matrix_details:str|None,outcome_summary:OutcomeSummary,result_storage:ResultStorage,client_info:ClientInfo,test_matrix_id:str)

Bases:object

The data within all Firebase test matrix completed events.

client_info:ClientInfo

Information provided by the client that created the test matrix.

create_time:datetime

Time the test matrix was created.

invalid_matrix_details:str|None

Code that describes why the test matrix is considered invalid. Only set formatrices in the INVALID state.

outcome_summary:OutcomeSummary

Outcome summary of the test matrix.

result_storage:ResultStorage

Locations where test results are stored.

state:TestState

State of the test matrix.

test_matrix_id:str

ID of the test matrix this event belongs to.

TestState

classfirebase_functions.test_lab_fn.TestState(value)

Bases:str,Enum

Possible test states for a test matrix.

ERROR='ERROR'

The test matrix has completed because of an infrastructure failure.

FINISHED='FINISHED'

The test matrix has completed normally.

INVALID='INVALID'

The test matrix was not run because the provided inputs are not valid.

PENDING='PENDING'

The test matrix is waiting for resources to become available.

TEST_STATE_UNSPECIFIED='TEST_STATE_UNSPECIFIED'

The default value. This value is used if the state is omitted.

VALIDATING='VALIDATING'

The test matrix is being validated.

Functions

on_test_matrix_completed

firebase_functions.test_lab_fn.on_test_matrix_completed(**kwargs)Callable[[Callable[[CloudEvent[TestMatrixCompletedData]],None]],Callable[[CloudEvent[TestMatrixCompletedData]],None]]

Event handler which triggers when a Firebase test matrix completes.

Example:

@on_test_matrix_completed()defexample(event:CloudEvent[ConfigUpdateData])->None:pass
Parameters:

**kwargs (asfirebase_functions.options.EventHandlerOptions) -- Options.

Return type:

typing.Callable[ [firebase_functions.core.CloudEvent [firebase_functions.test_lab_fn.TestMatrixCompletedData [typing.Any ] ] ],None ]A function that takes a CloudEvent and returns None.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-11-06 UTC.