Class: Google::Apis::ToolresultsV1beta3::Execution
- Inherits:
-
Object
- Object
- Google::Apis::ToolresultsV1beta3::Execution
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/toolresults_v1beta3/classes.rb,
generated/google/apis/toolresults_v1beta3/representations.rb,
generated/google/apis/toolresults_v1beta3/representations.rb
Overview
An Execution represents a collection of Steps. For instance, it could represent: - a mobile test executed across a range of device configurations - a jenkins job with a build step followed by a test step The maximum size of an execution message is 1 MiB. An Execution can be updated until its state is set to COMPLETE at which point it becomes immutable.
Instance Attribute Summary collapse
-
#completion_time ⇒ Google::Apis::ToolresultsV1beta3::Timestamp
A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution.
-
#creation_time ⇒ Google::Apis::ToolresultsV1beta3::Timestamp
A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution.
-
#execution_id ⇒ String
A unique identifier within a History for this Execution.
-
#outcome ⇒ Google::Apis::ToolresultsV1beta3::Outcome
Interprets a result so that humans and machines can act on it.
-
#specification ⇒ Google::Apis::ToolresultsV1beta3::Specification
The details about how to run the execution.
-
#state ⇒ String
The initial state is IN_PROGRESS.
-
#test_execution_matrix_id ⇒ String
TestExecution Matrix ID that the TestExecutionService uses.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Execution
constructor
A new instance of Execution.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Core::JsonObjectSupport
Methods included from Core::Hashable
Constructor Details
#initialize(**args) ⇒ Execution
Returns a new instance of Execution.
921 922 923 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 921 def initialize(**args) update!(**args) end |
Instance Attribute Details
#completion_time ⇒ Google::Apis::ToolresultsV1beta3::Timestamp
A Timestamp represents a point in time independent of any time zone or local 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. 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 date strings.
Examples
Example 1: Compute Timestamp from POSIX time()
.
Timestamp timestamp; timestamp.set_seconds(time(NULL)); timestamp.set_nanos(0);
Example 2: Compute Timestamp from POSIX gettimeofday()
.
struct timeval tv; gettimeofday(&tv, NULL);
Timestamp timestamp; timestamp.set_seconds(tv.tv_sec); timestamp.set_nanos(tv.
tv_usec * 1000);
Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime()
.
FILETIME ft; GetSystemTimeAsFileTime(&ft); UINT64 ticks = (((UINT64)ft.
dwHighDateTime) << 32) | ft.dwLowDateTime;
// A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z // is
11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z. Timestamp
timestamp; timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
Example 4: Compute Timestamp from Java System.currentTimeMillis()
.
long millis = System.currentTimeMillis();
Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000) .
setNanos((int) ((millis % 1000) * 1000000)).build();
Example 5: Compute Timestamp from current time in Python.
timestamp = Timestamp() timestamp.GetCurrentTime()
JSON Mapping
In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is "year
-
month
-day
Thour
:min
:sec
[.frac_sec
]Z" where year
is always
expressed using four digits while month
, day
, hour
, min
, and sec
are
zero-padded to two digits each. The fractional seconds, which can go up to 9
digits (i.e. up to 1 nanosecond resolution), are optional. The "Z" suffix
indicates the timezone ("UTC"); the timezone is required. A proto3 JSON
serializer should always use UTC (as indicated by "Z") when printing the
Timestamp type and a proto3 JSON parser should be able to accept both UTC and
other timezones (as indicated by an offset).
For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past 01:30 UTC on
January 15, 2017.
In JavaScript, one can convert a Date object to this format using the standard
toISOString() method. In Python, a standard
datetime.datetime
object can be converted to this format using strftime
with the time
format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use the Joda
Time's ISODateTimeFormat.dateTime()
to obtain a
formatter capable of generating timestamps in this format.
Corresponds to the JSON property completionTime
825 826 827 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 825 def completion_time @completion_time end |
#creation_time ⇒ Google::Apis::ToolresultsV1beta3::Timestamp
A Timestamp represents a point in time independent of any time zone or local 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. 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 date strings.
Examples
Example 1: Compute Timestamp from POSIX time()
.
Timestamp timestamp; timestamp.set_seconds(time(NULL)); timestamp.set_nanos(0);
Example 2: Compute Timestamp from POSIX gettimeofday()
.
struct timeval tv; gettimeofday(&tv, NULL);
Timestamp timestamp; timestamp.set_seconds(tv.tv_sec); timestamp.set_nanos(tv.
tv_usec * 1000);
Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime()
.
FILETIME ft; GetSystemTimeAsFileTime(&ft); UINT64 ticks = (((UINT64)ft.
dwHighDateTime) << 32) | ft.dwLowDateTime;
// A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z // is
11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z. Timestamp
timestamp; timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
Example 4: Compute Timestamp from Java System.currentTimeMillis()
.
long millis = System.currentTimeMillis();
Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000) .
setNanos((int) ((millis % 1000) * 1000000)).build();
Example 5: Compute Timestamp from current time in Python.
timestamp = Timestamp() timestamp.GetCurrentTime()
JSON Mapping
In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is "year
-
month
-day
Thour
:min
:sec
[.frac_sec
]Z" where year
is always
expressed using four digits while month
, day
, hour
, min
, and sec
are
zero-padded to two digits each. The fractional seconds, which can go up to 9
digits (i.e. up to 1 nanosecond resolution), are optional. The "Z" suffix
indicates the timezone ("UTC"); the timezone is required. A proto3 JSON
serializer should always use UTC (as indicated by "Z") when printing the
Timestamp type and a proto3 JSON parser should be able to accept both UTC and
other timezones (as indicated by an offset).
For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past 01:30 UTC on
January 15, 2017.
In JavaScript, one can convert a Date object to this format using the standard
toISOString() method. In Python, a standard
datetime.datetime
object can be converted to this format using strftime
with the time
format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use the Joda
Time's ISODateTimeFormat.dateTime()
to obtain a
formatter capable of generating timestamps in this format.
Corresponds to the JSON property creationTime
882 883 884 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 882 def creation_time @creation_time end |
#execution_id ⇒ String
A unique identifier within a History for this Execution. Returns INVALID_ARGUMENT if this field is set or overwritten by the caller.
- In response always set - In create/update request: never set
Corresponds to the JSON property
executionId
889 890 891 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 889 def execution_id @execution_id end |
#outcome ⇒ Google::Apis::ToolresultsV1beta3::Outcome
Interprets a result so that humans and machines can act on it.
Corresponds to the JSON property outcome
894 895 896 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 894 def outcome @outcome end |
#specification ⇒ Google::Apis::ToolresultsV1beta3::Specification
The details about how to run the execution.
Corresponds to the JSON property specification
899 900 901 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 899 def specification @specification end |
#state ⇒ String
The initial state is IN_PROGRESS. The only legal state transitions is from IN_PROGRESS to COMPLETE. A PRECONDITION_FAILED will be returned if an invalid transition is requested. The state can only be set to COMPLETE once. A FAILED_PRECONDITION will be returned if the state is set to COMPLETE multiple times. If the state is set to COMPLETE, all the in-progress steps within the execution will be set as COMPLETE. If the outcome of the step is not set, the outcome will be set to INCONCLUSIVE.
- In response always set - In create/update request: optional
Corresponds to the JSON property
state
912 913 914 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 912 def state @state end |
#test_execution_matrix_id ⇒ String
TestExecution Matrix ID that the TestExecutionService uses.
- In response: present if set by create - In create: optional - In update:
never set
Corresponds to the JSON property
testExecutionMatrixId
919 920 921 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 919 def test_execution_matrix_id @test_execution_matrix_id end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
926 927 928 929 930 931 932 933 934 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 926 def update!(**args) @completion_time = args[:completion_time] if args.key?(:completion_time) @creation_time = args[:creation_time] if args.key?(:creation_time) @execution_id = args[:execution_id] if args.key?(:execution_id) @outcome = args[:outcome] if args.key?(:outcome) @specification = args[:specification] if args.key?(:specification) @state = args[:state] if args.key?(:state) @test_execution_matrix_id = args[:test_execution_matrix_id] if args.key?(:test_execution_matrix_id) end |