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
698 699 700 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 698 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
602 603 604 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 602 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
659 660 661 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 659 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
666 667 668 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 666 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
671 672 673 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 671 def outcome @outcome end |
#specification ⇒ Google::Apis::ToolresultsV1beta3::Specification
The details about how to run the execution.
Corresponds to the JSON property specification
676 677 678 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 676 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
689 690 691 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 689 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
696 697 698 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 696 def test_execution_matrix_id @test_execution_matrix_id end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
703 704 705 706 707 708 709 710 711 |
# File 'generated/google/apis/toolresults_v1beta3/classes.rb', line 703 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 |