Cloud Tool Results API . testCases

Instance Methods

get(projectId=None, historyId=None, executionId=None, stepId=None, testCaseId=None, x__xgafv=None)

Gets details of a Test Case for a Step.

list(projectId=None, historyId=None, executionId=None, stepId=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Test Cases attached to a Step.

list_next(previous_request=*, previous_response=*)

Retrieves the next page of results.

Method Details

get(projectId=None, historyId=None, executionId=None, stepId=None, testCaseId=None, x__xgafv=None)
Gets details of a Test Case for a Step.
Experimental test cases API. Still in active development.

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
- NOT_FOUND - if the containing Test Case does not exist

Args:
  projectId: string, A Project id.

Required. (required)
  historyId: string, A History id.

Required. (required)
  executionId: string, A Execution id

Required. (required)
  stepId: string, A Step id.
Note: This step must include a TestExecutionStep.

Required. (required)
  testCaseId: string, A Test Case id.

Required. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
    "status": "A String", # The status of the test case.
        #
        # Required.
    "startTime": { # A Timestamp represents a point in time independent of any time zone or local # The start time of the test case.
        # 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.
    },
    "testCaseId": "A String", # A unique identifier within a Step for this Test Case.
    "elapsedTime": { #  # The elapsed run time of the test case.
        #
        # Required.
        # 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
    },
    "toolOutputs": [ # References to opaque files of any format output by the tool execution.
        #
        # @OutputOnly
      { # A reference to a ToolExecution output file.
        "testCase": { # A reference to a test case. # The test case to which this output file belongs.
            #
            # - In response: present if set by create/update request
            # - In create/update request: optional
            #
            # Test case references are canonically ordered lexicographically by these three
            # factors:
            # * First, by test_suite_name.
            # * Second, by class_name.
            # * Third, by name.
          "className": "A String", # The name of the class.
          "testSuiteName": "A String", # The name of the test suite to which this test case belongs.
          "name": "A String", # The name of the test case.
              #
              # Required.
        },
        "output": { # A reference to a file. # A FileReference to an output file.
            #
            # - In response: always set
            # - In create/update request: always set
          "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
        },
        "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # The creation time of the file.
            #
            # - In response: present if set by create/update request
            # - In create/update request: optional
            # 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.
        },
      },
    ],
    "testCaseReference": { # A reference to a test case. # Test case reference, e.g. name, class name and test suite name.
        #
        # Required.
        #
        # Test case references are canonically ordered lexicographically by these three
        # factors:
        # * First, by test_suite_name.
        # * Second, by class_name.
        # * Third, by name.
      "className": "A String", # The name of the class.
      "testSuiteName": "A String", # The name of the test suite to which this test case belongs.
      "name": "A String", # The name of the test case.
          #
          # Required.
    },
    "skippedMessage": "A String", # Why the test case was skipped.
        #
        # Present only for skipped test case
    "stackTraces": [ # The stack trace details if the test case failed or encountered an error.
        #
        # The maximum size of the stack traces is 100KiB, beyond which the stack
        # track will be truncated.
        #
        # Zero if the test case passed.
      { # A stacktrace.
        "exception": "A String", # The stack trace message.
            #
            # Required
      },
    ],
    "endTime": { # A Timestamp represents a point in time independent of any time zone or local # The end time of the test case.
        # 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.
    },
  }
list(projectId=None, historyId=None, executionId=None, stepId=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists Test Cases attached to a Step.
Experimental test cases API. Still in active development.

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
- NOT_FOUND - if the containing Step does not exist

Args:
  projectId: string, A Project id.

Required. (required)
  historyId: string, A History id.

Required. (required)
  executionId: string, A Execution id

Required. (required)
  stepId: string, A Step id.
Note: This step must include a TestExecutionStep.

Required. (required)
  pageSize: integer, The maximum number of TestCases to fetch.

Default value: 100. The server will use this default if the field is not
set or has a value of 0.

Optional.
  pageToken: string, A continuation token to resume the query at the next item.

Optional.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for StepService.ListTestCases.
    "nextPageToken": "A String",
    "testCases": [ # List of test cases.
      {
        "status": "A String", # The status of the test case.
            #
            # Required.
        "startTime": { # A Timestamp represents a point in time independent of any time zone or local # The start time of the test case.
            # 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.
        },
        "testCaseId": "A String", # A unique identifier within a Step for this Test Case.
        "elapsedTime": { #  # The elapsed run time of the test case.
            #
            # Required.
            # 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
        },
        "toolOutputs": [ # References to opaque files of any format output by the tool execution.
            #
            # @OutputOnly
          { # A reference to a ToolExecution output file.
            "testCase": { # A reference to a test case. # The test case to which this output file belongs.
                #
                # - In response: present if set by create/update request
                # - In create/update request: optional
                #
                # Test case references are canonically ordered lexicographically by these three
                # factors:
                # * First, by test_suite_name.
                # * Second, by class_name.
                # * Third, by name.
              "className": "A String", # The name of the class.
              "testSuiteName": "A String", # The name of the test suite to which this test case belongs.
              "name": "A String", # The name of the test case.
                  #
                  # Required.
            },
            "output": { # A reference to a file. # A FileReference to an output file.
                #
                # - In response: always set
                # - In create/update request: always set
              "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
            },
            "creationTime": { # A Timestamp represents a point in time independent of any time zone or local # The creation time of the file.
                #
                # - In response: present if set by create/update request
                # - In create/update request: optional
                # 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.
            },
          },
        ],
        "testCaseReference": { # A reference to a test case. # Test case reference, e.g. name, class name and test suite name.
            #
            # Required.
            #
            # Test case references are canonically ordered lexicographically by these three
            # factors:
            # * First, by test_suite_name.
            # * Second, by class_name.
            # * Third, by name.
          "className": "A String", # The name of the class.
          "testSuiteName": "A String", # The name of the test suite to which this test case belongs.
          "name": "A String", # The name of the test case.
              #
              # Required.
        },
        "skippedMessage": "A String", # Why the test case was skipped.
            #
            # Present only for skipped test case
        "stackTraces": [ # The stack trace details if the test case failed or encountered an error.
            #
            # The maximum size of the stack traces is 100KiB, beyond which the stack
            # track will be truncated.
            #
            # Zero if the test case passed.
          { # A stacktrace.
            "exception": "A String", # The stack trace message.
                #
                # Required
          },
        ],
        "endTime": { # A Timestamp represents a point in time independent of any time zone or local # The end time of the test case.
            # 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.
        },
      },
    ],
  }
list_next(previous_request=*, previous_response=*)
Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.