docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/toolresults_v1beta3.environments.html b/docs/dyn/toolresults_v1beta3.environments.html
index 0149b98..bd21250 100644
--- a/docs/dyn/toolresults_v1beta3.environments.html
+++ b/docs/dyn/toolresults_v1beta3.environments.html
@@ -113,192 +113,6 @@
# because of features like sharding (splitting up a test suite to run in
# parallel across devices) and reruns (running a test multiple times to check
# for different outcomes).
- "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.
- # calendar, encoded as a count of seconds and fractions of seconds at
- # nanosecond resolution. The count is relative to an epoch at UTC midnight on
- # January 1, 1970, in the proleptic Gregorian calendar which extends the
- # Gregorian calendar backwards to year one.
- #
- # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
- # second table is needed for interpretation, using a [24-hour linear
- # smear](https://developers.google.com/time/smear).
- #
- # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
- # restricting to that range, we ensure that we can convert to and from [RFC
- # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
- "nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative
- # second values with fractions must still have non-negative nanos values
- # that count forward in time. Must be from 0 to 999,999,999
- # inclusive.
- "seconds": "A String", # Represents seconds of UTC time since Unix epoch
- # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
- # 9999-12-31T23:59:59Z inclusive.
- },
- "environmentResult": { # Merged test result for environment. # Merged result of the environment.
- #
- # If the environment has only one step (no reruns or shards), then the merged
- # result is the same as the step result. If the environment has multiple shards
- # and/or reruns, then the results of shards and reruns that belong to the same
- # environment are merged into one environment result.
- "testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part
- # of this environment.
- #
- # Combining:
- # When the test cases from a suite are run in different steps (sharding),
- # the results are added back together in one overview. (e.g., if shard1 has
- # 2 failures and shard2 has 1 failure than the overview failure_count = 3).
- #
- # Rollup:
- # When test cases from the same suite are run multiple times (flaky), the
- # results are combined (e.g., if testcase1.run1 fails, testcase1.run2
- # passes, and both testcase2.run1 and testcase2.run2 fail then the overview
- # flaky_count = 1 and failure_count = 1).
- { # A summary of a test suite result either parsed from XML or uploaded
- # directly by a user.
- #
- # Note: the API related comments are for StepService only. This message is
- # also being used in ExecutionService in a read only mode for the corresponding
- # step.
- "name": "A String", # The name of the test suite.
- #
- # - In create/response: always set
- # - In update request: never
- "elapsedTime": { # # Elapsed time of test suite.
- # A Duration represents a signed, fixed-length span of time represented
- # as a count of seconds and fractions of seconds at nanosecond
- # resolution. It is independent of any calendar and concepts like "day"
- # or "month". It is related to Timestamp in that the difference between
- # two Timestamp values is a Duration and it can be added or subtracted
- # from a Timestamp. Range is approximately +-10,000 years.
- "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
- # of time. Durations less than one second are represented with a 0
- # `seconds` field and a positive or negative `nanos` field. For durations
- # of one second or more, a non-zero value for the `nanos` field must be
- # of the same sign as the `seconds` field. Must be from -999,999,999
- # to +999,999,999 inclusive.
- "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
- # to +315,576,000,000 inclusive. Note: these bounds are computed from:
- # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
- },
- "flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
- # attempts.
- #
- # Present only for rollup test suite overview at environment level. A step
- # cannot have flaky test cases.
- "errorCount": 42, # Number of test cases in error, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "totalCount": 42, # Number of test cases, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original
- # XML file is stored.
- #
- # Note: Multiple test suites can share the same xml_source
- #
- # Returns INVALID_ARGUMENT if the uri format is not supported.
- #
- # - In create/response: optional
- # - In update request: never
- "fileUri": "A String", # The URI of a file stored in Google Cloud Storage.
- #
- # For example: http://storage.googleapis.com/mybucket/path/to/test.xml
- # or in gsutil format: gs://mybucket/path/to/test.xml
- # with version-specific info,
- # gs://mybucket/path/to/test.xml#1360383693690000
- #
- # An INVALID_ARGUMENT error will be returned if the URI format is not
- # supported.
- #
- # - In response: always set
- # - In create/update request: always set
- },
- "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
- # xml_source. May also be set by the user.
- #
- # - In create/response: always set
- # - In update request: never
- },
- ],
- "state": "A String", # State of the resource
- "outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
- "summary": "A String", # The simplest way to interpret a result.
- #
- # Required
- "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not FAILURE.
- #
- # Optional
- "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
- # start.
- "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
- # This might be caused by trying to run a test on an unsupported platform.
- "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
- "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
- "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
- },
- "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not INCONCLUSIVE.
- #
- # Optional
- "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
- # infrastructure failures
- "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
- # depends on a component other than the system under test which failed.
- #
- # For example, a mobile test requires provisioning a device where the test
- # executes, and that provisioning can fail.
- "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
- # determined.
- # For example, the user pressed ctrl-c which sent a kill signal to the test
- # runner while the test was running.
- },
- "successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not SUCCESS.
- #
- # Optional
- # LINT.IfChange
- "otherNativeCrash": True or False, # If a native process other than the app crashed.
- },
- "skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not SKIPPED.
- #
- # Optional
- "incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.
- "incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
- "incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
- },
- },
- },
- "dimensionValue": [ # Dimension values describing the environment. Dimension values always
- # consist of "Model", "Version", "Locale", and "Orientation".
- #
- # - In response: always set
- # - In create request: always set
- # - In update request: never set
- {
- "value": "A String",
- "key": "A String",
- },
- ],
- "projectId": "A String", # Output only. A Project id.
"completionTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment status was set to complete.
#
# This value will be set automatically when state transitions to
@@ -360,6 +174,11 @@
# Note: the API related comments are for StepService only. This message is
# also being used in ExecutionService in a read only mode for the corresponding
# step.
+ "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
+ # xml_source. May also be set by the user.
+ #
+ # - In create/response: always set
+ # - In update request: never
"name": "A String", # The name of the test suite.
#
# - In create/response: always set
@@ -371,15 +190,15 @@
# or "month". It is related to Timestamp in that the difference between
# two Timestamp values is a Duration and it can be added or subtracted
# from a Timestamp. Range is approximately +-10,000 years.
+ "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
+ # to +315,576,000,000 inclusive. Note: these bounds are computed from:
+ # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
# of time. Durations less than one second are represented with a 0
# `seconds` field and a positive or negative `nanos` field. For durations
# of one second or more, a non-zero value for the `nanos` field must be
# of the same sign as the `seconds` field. Must be from -999,999,999
# to +999,999,999 inclusive.
- "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
- # to +315,576,000,000 inclusive. Note: these bounds are computed from:
- # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
},
"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
# attempts.
@@ -423,50 +242,10 @@
# - In response: always set
# - In create/update request: always set
},
- "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
- # xml_source. May also be set by the user.
- #
- # - In create/response: always set
- # - In update request: never
},
],
"state": "A String", # State of the resource
"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
- "summary": "A String", # The simplest way to interpret a result.
- #
- # Required
- "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not FAILURE.
- #
- # Optional
- "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
- # start.
- "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
- # This might be caused by trying to run a test on an unsupported platform.
- "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
- "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
- "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
- },
- "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not INCONCLUSIVE.
- #
- # Optional
- "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
- # infrastructure failures
- "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
- # depends on a component other than the system under test which failed.
- #
- # For example, a mobile test requires provisioning a device where the test
- # executes, and that provisioning can fail.
- "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
- # determined.
- # For example, the user pressed ctrl-c which sent a kill signal to the test
- # runner while the test was running.
- },
"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
#
# Returns INVALID_ARGUMENT if this field is set
@@ -486,6 +265,41 @@
"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
},
+ "summary": "A String", # The simplest way to interpret a result.
+ #
+ # Required
+ "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not FAILURE.
+ #
+ # Optional
+ "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
+ "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
+ # start.
+ "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
+ # This might be caused by trying to run a test on an unsupported platform.
+ "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
+ "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
+ },
+ "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not INCONCLUSIVE.
+ #
+ # Optional
+ "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
+ # infrastructure failures
+ "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
+ # depends on a component other than the system under test which failed.
+ #
+ # For example, a mobile test requires provisioning a device where the test
+ # executes, and that provisioning can fail.
+ "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
+ # determined.
+ # For example, the user pressed ctrl-c which sent a kill signal to the test
+ # runner while the test was running.
+ },
},
},
},
@@ -526,6 +340,192 @@
# For example: Nexus 5, API 27.
"historyId": "A String", # Output only. A History id.
"environmentId": "A String", # Output only. An Environment id.
+ "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.
+ # calendar, encoded as a count of seconds and fractions of seconds at
+ # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+ # January 1, 1970, in the proleptic Gregorian calendar which extends the
+ # Gregorian calendar backwards to year one.
+ #
+ # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+ # second table is needed for interpretation, using a [24-hour linear
+ # smear](https://developers.google.com/time/smear).
+ #
+ # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+ # restricting to that range, we ensure that we can convert to and from [RFC
+ # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
+ "nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative
+ # second values with fractions must still have non-negative nanos values
+ # that count forward in time. Must be from 0 to 999,999,999
+ # inclusive.
+ "seconds": "A String", # Represents seconds of UTC time since Unix epoch
+ # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+ # 9999-12-31T23:59:59Z inclusive.
+ },
+ "environmentResult": { # Merged test result for environment. # Merged result of the environment.
+ #
+ # If the environment has only one step (no reruns or shards), then the merged
+ # result is the same as the step result. If the environment has multiple shards
+ # and/or reruns, then the results of shards and reruns that belong to the same
+ # environment are merged into one environment result.
+ "testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part
+ # of this environment.
+ #
+ # Combining:
+ # When the test cases from a suite are run in different steps (sharding),
+ # the results are added back together in one overview. (e.g., if shard1 has
+ # 2 failures and shard2 has 1 failure than the overview failure_count = 3).
+ #
+ # Rollup:
+ # When test cases from the same suite are run multiple times (flaky), the
+ # results are combined (e.g., if testcase1.run1 fails, testcase1.run2
+ # passes, and both testcase2.run1 and testcase2.run2 fail then the overview
+ # flaky_count = 1 and failure_count = 1).
+ { # A summary of a test suite result either parsed from XML or uploaded
+ # directly by a user.
+ #
+ # Note: the API related comments are for StepService only. This message is
+ # also being used in ExecutionService in a read only mode for the corresponding
+ # step.
+ "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
+ # xml_source. May also be set by the user.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "name": "A String", # The name of the test suite.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "elapsedTime": { # # Elapsed time of test suite.
+ # A Duration represents a signed, fixed-length span of time represented
+ # as a count of seconds and fractions of seconds at nanosecond
+ # resolution. It is independent of any calendar and concepts like "day"
+ # or "month". It is related to Timestamp in that the difference between
+ # two Timestamp values is a Duration and it can be added or subtracted
+ # from a Timestamp. Range is approximately +-10,000 years.
+ "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
+ # to +315,576,000,000 inclusive. Note: these bounds are computed from:
+ # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+ "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
+ # of time. Durations less than one second are represented with a 0
+ # `seconds` field and a positive or negative `nanos` field. For durations
+ # of one second or more, a non-zero value for the `nanos` field must be
+ # of the same sign as the `seconds` field. Must be from -999,999,999
+ # to +999,999,999 inclusive.
+ },
+ "flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
+ # attempts.
+ #
+ # Present only for rollup test suite overview at environment level. A step
+ # cannot have flaky test cases.
+ "errorCount": 42, # Number of test cases in error, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "totalCount": 42, # Number of test cases, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original
+ # XML file is stored.
+ #
+ # Note: Multiple test suites can share the same xml_source
+ #
+ # Returns INVALID_ARGUMENT if the uri format is not supported.
+ #
+ # - In create/response: optional
+ # - In update request: never
+ "fileUri": "A String", # The URI of a file stored in Google Cloud Storage.
+ #
+ # For example: http://storage.googleapis.com/mybucket/path/to/test.xml
+ # or in gsutil format: gs://mybucket/path/to/test.xml
+ # with version-specific info,
+ # gs://mybucket/path/to/test.xml#1360383693690000
+ #
+ # An INVALID_ARGUMENT error will be returned if the URI format is not
+ # supported.
+ #
+ # - In response: always set
+ # - In create/update request: always set
+ },
+ },
+ ],
+ "state": "A String", # State of the resource
+ "outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
+ "successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not SUCCESS.
+ #
+ # Optional
+ # LINT.IfChange
+ "otherNativeCrash": True or False, # If a native process other than the app crashed.
+ },
+ "skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not SKIPPED.
+ #
+ # Optional
+ "incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.
+ "incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
+ "incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
+ },
+ "summary": "A String", # The simplest way to interpret a result.
+ #
+ # Required
+ "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not FAILURE.
+ #
+ # Optional
+ "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
+ "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
+ # start.
+ "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
+ # This might be caused by trying to run a test on an unsupported platform.
+ "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
+ "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
+ },
+ "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not INCONCLUSIVE.
+ #
+ # Optional
+ "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
+ # infrastructure failures
+ "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
+ # depends on a component other than the system under test which failed.
+ #
+ # For example, a mobile test requires provisioning a device where the test
+ # executes, and that provisioning can fail.
+ "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
+ # determined.
+ # For example, the user pressed ctrl-c which sent a kill signal to the test
+ # runner while the test was running.
+ },
+ },
+ },
+ "dimensionValue": [ # Dimension values describing the environment. Dimension values always
+ # consist of "Model", "Version", "Locale", and "Orientation".
+ #
+ # - In response: always set
+ # - In create request: always set
+ # - In update request: never set
+ {
+ "value": "A String",
+ "key": "A String",
+ },
+ ],
+ "projectId": "A String", # Output only. A Project id.
}</pre>
</div>
@@ -559,6 +559,12 @@
An object of the form:
{ # Response message for EnvironmentService.ListEnvironments.
+ "projectId": "A String", # A Project id.
+ #
+ # Always set.
+ "historyId": "A String", # A History id.
+ #
+ # Always set.
"executionId": "A String", # A Execution id
#
# Always set.
@@ -574,192 +580,6 @@
# because of features like sharding (splitting up a test suite to run in
# parallel across devices) and reruns (running a test multiple times to check
# for different outcomes).
- "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.
- # calendar, encoded as a count of seconds and fractions of seconds at
- # nanosecond resolution. The count is relative to an epoch at UTC midnight on
- # January 1, 1970, in the proleptic Gregorian calendar which extends the
- # Gregorian calendar backwards to year one.
- #
- # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
- # second table is needed for interpretation, using a [24-hour linear
- # smear](https://developers.google.com/time/smear).
- #
- # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
- # restricting to that range, we ensure that we can convert to and from [RFC
- # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
- "nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative
- # second values with fractions must still have non-negative nanos values
- # that count forward in time. Must be from 0 to 999,999,999
- # inclusive.
- "seconds": "A String", # Represents seconds of UTC time since Unix epoch
- # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
- # 9999-12-31T23:59:59Z inclusive.
- },
- "environmentResult": { # Merged test result for environment. # Merged result of the environment.
- #
- # If the environment has only one step (no reruns or shards), then the merged
- # result is the same as the step result. If the environment has multiple shards
- # and/or reruns, then the results of shards and reruns that belong to the same
- # environment are merged into one environment result.
- "testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part
- # of this environment.
- #
- # Combining:
- # When the test cases from a suite are run in different steps (sharding),
- # the results are added back together in one overview. (e.g., if shard1 has
- # 2 failures and shard2 has 1 failure than the overview failure_count = 3).
- #
- # Rollup:
- # When test cases from the same suite are run multiple times (flaky), the
- # results are combined (e.g., if testcase1.run1 fails, testcase1.run2
- # passes, and both testcase2.run1 and testcase2.run2 fail then the overview
- # flaky_count = 1 and failure_count = 1).
- { # A summary of a test suite result either parsed from XML or uploaded
- # directly by a user.
- #
- # Note: the API related comments are for StepService only. This message is
- # also being used in ExecutionService in a read only mode for the corresponding
- # step.
- "name": "A String", # The name of the test suite.
- #
- # - In create/response: always set
- # - In update request: never
- "elapsedTime": { # # Elapsed time of test suite.
- # A Duration represents a signed, fixed-length span of time represented
- # as a count of seconds and fractions of seconds at nanosecond
- # resolution. It is independent of any calendar and concepts like "day"
- # or "month". It is related to Timestamp in that the difference between
- # two Timestamp values is a Duration and it can be added or subtracted
- # from a Timestamp. Range is approximately +-10,000 years.
- "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
- # of time. Durations less than one second are represented with a 0
- # `seconds` field and a positive or negative `nanos` field. For durations
- # of one second or more, a non-zero value for the `nanos` field must be
- # of the same sign as the `seconds` field. Must be from -999,999,999
- # to +999,999,999 inclusive.
- "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
- # to +315,576,000,000 inclusive. Note: these bounds are computed from:
- # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
- },
- "flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
- # attempts.
- #
- # Present only for rollup test suite overview at environment level. A step
- # cannot have flaky test cases.
- "errorCount": 42, # Number of test cases in error, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "totalCount": 42, # Number of test cases, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the
- # xml_source.
- #
- # - In create/response: always set
- # - In update request: never
- "xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original
- # XML file is stored.
- #
- # Note: Multiple test suites can share the same xml_source
- #
- # Returns INVALID_ARGUMENT if the uri format is not supported.
- #
- # - In create/response: optional
- # - In update request: never
- "fileUri": "A String", # The URI of a file stored in Google Cloud Storage.
- #
- # For example: http://storage.googleapis.com/mybucket/path/to/test.xml
- # or in gsutil format: gs://mybucket/path/to/test.xml
- # with version-specific info,
- # gs://mybucket/path/to/test.xml#1360383693690000
- #
- # An INVALID_ARGUMENT error will be returned if the URI format is not
- # supported.
- #
- # - In response: always set
- # - In create/update request: always set
- },
- "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
- # xml_source. May also be set by the user.
- #
- # - In create/response: always set
- # - In update request: never
- },
- ],
- "state": "A String", # State of the resource
- "outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
- "summary": "A String", # The simplest way to interpret a result.
- #
- # Required
- "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not FAILURE.
- #
- # Optional
- "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
- # start.
- "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
- # This might be caused by trying to run a test on an unsupported platform.
- "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
- "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
- "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
- },
- "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not INCONCLUSIVE.
- #
- # Optional
- "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
- # infrastructure failures
- "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
- # depends on a component other than the system under test which failed.
- #
- # For example, a mobile test requires provisioning a device where the test
- # executes, and that provisioning can fail.
- "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
- # determined.
- # For example, the user pressed ctrl-c which sent a kill signal to the test
- # runner while the test was running.
- },
- "successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not SUCCESS.
- #
- # Optional
- # LINT.IfChange
- "otherNativeCrash": True or False, # If a native process other than the app crashed.
- },
- "skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not SKIPPED.
- #
- # Optional
- "incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.
- "incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
- "incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
- },
- },
- },
- "dimensionValue": [ # Dimension values describing the environment. Dimension values always
- # consist of "Model", "Version", "Locale", and "Orientation".
- #
- # - In response: always set
- # - In create request: always set
- # - In update request: never set
- {
- "value": "A String",
- "key": "A String",
- },
- ],
- "projectId": "A String", # Output only. A Project id.
"completionTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment status was set to complete.
#
# This value will be set automatically when state transitions to
@@ -821,6 +641,11 @@
# Note: the API related comments are for StepService only. This message is
# also being used in ExecutionService in a read only mode for the corresponding
# step.
+ "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
+ # xml_source. May also be set by the user.
+ #
+ # - In create/response: always set
+ # - In update request: never
"name": "A String", # The name of the test suite.
#
# - In create/response: always set
@@ -832,15 +657,15 @@
# or "month". It is related to Timestamp in that the difference between
# two Timestamp values is a Duration and it can be added or subtracted
# from a Timestamp. Range is approximately +-10,000 years.
+ "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
+ # to +315,576,000,000 inclusive. Note: these bounds are computed from:
+ # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
# of time. Durations less than one second are represented with a 0
# `seconds` field and a positive or negative `nanos` field. For durations
# of one second or more, a non-zero value for the `nanos` field must be
# of the same sign as the `seconds` field. Must be from -999,999,999
# to +999,999,999 inclusive.
- "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
- # to +315,576,000,000 inclusive. Note: these bounds are computed from:
- # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
},
"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
# attempts.
@@ -884,50 +709,10 @@
# - In response: always set
# - In create/update request: always set
},
- "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
- # xml_source. May also be set by the user.
- #
- # - In create/response: always set
- # - In update request: never
},
],
"state": "A String", # State of the resource
"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
- "summary": "A String", # The simplest way to interpret a result.
- #
- # Required
- "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not FAILURE.
- #
- # Optional
- "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
- # start.
- "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
- # This might be caused by trying to run a test on an unsupported platform.
- "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
- "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
- "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
- },
- "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
- #
- # Returns INVALID_ARGUMENT if this field is set
- # but the summary is not INCONCLUSIVE.
- #
- # Optional
- "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
- # infrastructure failures
- "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
- # depends on a component other than the system under test which failed.
- #
- # For example, a mobile test requires provisioning a device where the test
- # executes, and that provisioning can fail.
- "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
- # determined.
- # For example, the user pressed ctrl-c which sent a kill signal to the test
- # runner while the test was running.
- },
"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
#
# Returns INVALID_ARGUMENT if this field is set
@@ -947,6 +732,41 @@
"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
},
+ "summary": "A String", # The simplest way to interpret a result.
+ #
+ # Required
+ "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not FAILURE.
+ #
+ # Optional
+ "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
+ "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
+ # start.
+ "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
+ # This might be caused by trying to run a test on an unsupported platform.
+ "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
+ "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
+ },
+ "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not INCONCLUSIVE.
+ #
+ # Optional
+ "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
+ # infrastructure failures
+ "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
+ # depends on a component other than the system under test which failed.
+ #
+ # For example, a mobile test requires provisioning a device where the test
+ # executes, and that provisioning can fail.
+ "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
+ # determined.
+ # For example, the user pressed ctrl-c which sent a kill signal to the test
+ # runner while the test was running.
+ },
},
},
},
@@ -987,14 +807,194 @@
# For example: Nexus 5, API 27.
"historyId": "A String", # Output only. A History id.
"environmentId": "A String", # Output only. An Environment id.
+ "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.
+ # calendar, encoded as a count of seconds and fractions of seconds at
+ # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+ # January 1, 1970, in the proleptic Gregorian calendar which extends the
+ # Gregorian calendar backwards to year one.
+ #
+ # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+ # second table is needed for interpretation, using a [24-hour linear
+ # smear](https://developers.google.com/time/smear).
+ #
+ # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+ # restricting to that range, we ensure that we can convert to and from [RFC
+ # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
+ "nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative
+ # second values with fractions must still have non-negative nanos values
+ # that count forward in time. Must be from 0 to 999,999,999
+ # inclusive.
+ "seconds": "A String", # Represents seconds of UTC time since Unix epoch
+ # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+ # 9999-12-31T23:59:59Z inclusive.
+ },
+ "environmentResult": { # Merged test result for environment. # Merged result of the environment.
+ #
+ # If the environment has only one step (no reruns or shards), then the merged
+ # result is the same as the step result. If the environment has multiple shards
+ # and/or reruns, then the results of shards and reruns that belong to the same
+ # environment are merged into one environment result.
+ "testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part
+ # of this environment.
+ #
+ # Combining:
+ # When the test cases from a suite are run in different steps (sharding),
+ # the results are added back together in one overview. (e.g., if shard1 has
+ # 2 failures and shard2 has 1 failure than the overview failure_count = 3).
+ #
+ # Rollup:
+ # When test cases from the same suite are run multiple times (flaky), the
+ # results are combined (e.g., if testcase1.run1 fails, testcase1.run2
+ # passes, and both testcase2.run1 and testcase2.run2 fail then the overview
+ # flaky_count = 1 and failure_count = 1).
+ { # A summary of a test suite result either parsed from XML or uploaded
+ # directly by a user.
+ #
+ # Note: the API related comments are for StepService only. This message is
+ # also being used in ExecutionService in a read only mode for the corresponding
+ # step.
+ "failureCount": 42, # Number of failed test cases, typically set by the service by parsing the
+ # xml_source. May also be set by the user.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "name": "A String", # The name of the test suite.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "elapsedTime": { # # Elapsed time of test suite.
+ # A Duration represents a signed, fixed-length span of time represented
+ # as a count of seconds and fractions of seconds at nanosecond
+ # resolution. It is independent of any calendar and concepts like "day"
+ # or "month". It is related to Timestamp in that the difference between
+ # two Timestamp values is a Duration and it can be added or subtracted
+ # from a Timestamp. Range is approximately +-10,000 years.
+ "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000
+ # to +315,576,000,000 inclusive. Note: these bounds are computed from:
+ # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+ "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span
+ # of time. Durations less than one second are represented with a 0
+ # `seconds` field and a positive or negative `nanos` field. For durations
+ # of one second or more, a non-zero value for the `nanos` field must be
+ # of the same sign as the `seconds` field. Must be from -999,999,999
+ # to +999,999,999 inclusive.
+ },
+ "flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test
+ # attempts.
+ #
+ # Present only for rollup test suite overview at environment level. A step
+ # cannot have flaky test cases.
+ "errorCount": 42, # Number of test cases in error, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "totalCount": 42, # Number of test cases, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the
+ # xml_source.
+ #
+ # - In create/response: always set
+ # - In update request: never
+ "xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original
+ # XML file is stored.
+ #
+ # Note: Multiple test suites can share the same xml_source
+ #
+ # Returns INVALID_ARGUMENT if the uri format is not supported.
+ #
+ # - In create/response: optional
+ # - In update request: never
+ "fileUri": "A String", # The URI of a file stored in Google Cloud Storage.
+ #
+ # For example: http://storage.googleapis.com/mybucket/path/to/test.xml
+ # or in gsutil format: gs://mybucket/path/to/test.xml
+ # with version-specific info,
+ # gs://mybucket/path/to/test.xml#1360383693690000
+ #
+ # An INVALID_ARGUMENT error will be returned if the URI format is not
+ # supported.
+ #
+ # - In response: always set
+ # - In create/update request: always set
+ },
+ },
+ ],
+ "state": "A String", # State of the resource
+ "outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource
+ "successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not SUCCESS.
+ #
+ # Optional
+ # LINT.IfChange
+ "otherNativeCrash": True or False, # If a native process other than the app crashed.
+ },
+ "skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not SKIPPED.
+ #
+ # Optional
+ "incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.
+ "incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.
+ "incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.
+ },
+ "summary": "A String", # The simplest way to interpret a result.
+ #
+ # Required
+ "failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not FAILURE.
+ #
+ # Optional
+ "crashed": True or False, # If the failure was severe because the system (app) under test crashed.
+ "unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not
+ # start.
+ "notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.
+ # This might be caused by trying to run a test on an unsupported platform.
+ "timedOut": True or False, # If the test overran some time limit, and that is why it failed.
+ "otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.
+ },
+ "inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.
+ #
+ # Returns INVALID_ARGUMENT if this field is set
+ # but the summary is not INCONCLUSIVE.
+ #
+ # Optional
+ "hasErrorLogs": True or False, # If results are being provided to the user in certain cases of
+ # infrastructure failures
+ "infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test
+ # depends on a component other than the system under test which failed.
+ #
+ # For example, a mobile test requires provisioning a device where the test
+ # executes, and that provisioning can fail.
+ "abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be
+ # determined.
+ # For example, the user pressed ctrl-c which sent a kill signal to the test
+ # runner while the test was running.
+ },
+ },
+ },
+ "dimensionValue": [ # Dimension values describing the environment. Dimension values always
+ # consist of "Model", "Version", "Locale", and "Orientation".
+ #
+ # - In response: always set
+ # - In create request: always set
+ # - In update request: never set
+ {
+ "value": "A String",
+ "key": "A String",
+ },
+ ],
+ "projectId": "A String", # Output only. A Project id.
},
],
- "projectId": "A String", # A Project id.
- #
- # Always set.
- "historyId": "A String", # A History id.
- #
- # Always set.
}</pre>
</div>