Blame - docs/dyn/toolresults_v1beta3.environments.html - platform/external/python/google-api-python-client

"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.

117

#

118

# This value will be set automatically when state transitions to

119

# COMPLETE.

120

# calendar, encoded as a count of seconds and fractions of seconds at

121

# nanosecond resolution. The count is relative to an epoch at UTC midnight on

122

# January 1, 1970, in the proleptic Gregorian calendar which extends the

123

# Gregorian calendar backwards to year one.

124

#

125

# All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap

126

# second table is needed for interpretation, using a [24-hour linear

127

# smear](https://developers.google.com/time/smear).

128

#

129

# The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By

130

# restricting to that range, we ensure that we can convert to and from [RFC

131

# 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.

132

"nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative

133

# second values with fractions must still have non-negative nanos values

134

# that count forward in time. Must be from 0 to 999,999,999

135

# inclusive.

136

"seconds": "A String", # Represents seconds of UTC time since Unix epoch

137

# 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to

138

# 9999-12-31T23:59:59Z inclusive.

139

},

140

"shardSummaries": [ # Output only. Summaries of shards.

141

#

142

# Only one shard will present unless sharding feature is enabled in

143

# TestExecutionService.

144

{ # Result summary for a shard in an environment.

145

"runs": [ # Summaries of the steps belonging to the shard.

146

#

147

# With flaky_test_attempts enabled from TestExecutionService, more than one

148

# run (Step) can present. And the runs will be sorted by multistep_number.

149

{ # Lightweight summary of a step within this execution.

150

},

151

],

152

"shardResult": { # Merged test result for environment. # Merged result of the shard.

153

#

154

# If the environment has only one step (no reruns or shards), then the merged

155

# result is the same as the step result. If the environment has multiple shards

156

# and/or reruns, then the results of shards and reruns that belong to the same

157

# environment are merged into one environment result.

158

"testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part

159

# of this environment.

160

#

161

# Combining:

162

# When the test cases from a suite are run in different steps (sharding),

163

# the results are added back together in one overview. (e.g., if shard1 has

164

# 2 failures and shard2 has 1 failure than the overview failure_count = 3).

165

#

166

# Rollup:

167

# When test cases from the same suite are run multiple times (flaky), the

168

# results are combined (e.g., if testcase1.run1 fails, testcase1.run2

169

# passes, and both testcase2.run1 and testcase2.run2 fail then the overview

170

# flaky_count = 1 and failure_count = 1).

171

{ # A summary of a test suite result either parsed from XML or uploaded

172

# directly by a user.

173

#

174

# Note: the API related comments are for StepService only. This message is

175

# also being used in ExecutionService in a read only mode for the corresponding

176

# step.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

177

"failureCount": 42, # Number of failed test cases, typically set by the service by parsing the

178

# xml_source. May also be set by the user.

179

#

180

# - In create/response: always set

181

# - In update request: never

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

182

"name": "A String", # The name of the test suite.

183

#

184

# - In create/response: always set

185

# - In update request: never

186

"elapsedTime": { # # Elapsed time of test suite.

187

# A Duration represents a signed, fixed-length span of time represented

188

# as a count of seconds and fractions of seconds at nanosecond

189

# resolution. It is independent of any calendar and concepts like "day"

190

# or "month". It is related to Timestamp in that the difference between

191

# two Timestamp values is a Duration and it can be added or subtracted

192

# from a Timestamp. Range is approximately +-10,000 years.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

193

"seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000

194

# to +315,576,000,000 inclusive. Note: these bounds are computed from:

195

# 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

196

"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span

197

# of time. Durations less than one second are represented with a 0

198

# `seconds` field and a positive or negative `nanos` field. For durations

199

# of one second or more, a non-zero value for the `nanos` field must be

200

# of the same sign as the `seconds` field. Must be from -999,999,999

201

# to +999,999,999 inclusive.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

202

},

203

"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test

204

# attempts.

205

#

206

# Present only for rollup test suite overview at environment level. A step

207

# cannot have flaky test cases.

208

"errorCount": 42, # Number of test cases in error, typically set by the service by parsing the

209

# xml_source.

210

#

211

# - In create/response: always set

212

# - In update request: never

213

"totalCount": 42, # Number of test cases, typically set by the service by parsing the

214

# xml_source.

215

#

216

# - In create/response: always set

217

# - In update request: never

218

"skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the

219

# xml_source.

220

#

221

# - In create/response: always set

222

# - In update request: never

223

"xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original

224

# XML file is stored.

225

#

226

# Note: Multiple test suites can share the same xml_source

227

#

228

# Returns INVALID_ARGUMENT if the uri format is not supported.

229

#

230

# - In create/response: optional

231

# - In update request: never

232

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

233

#

234

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

235

# or in gsutil format: gs://mybucket/path/to/test.xml

236

# with version-specific info,

237

# gs://mybucket/path/to/test.xml#1360383693690000

238

#

239

# An INVALID_ARGUMENT error will be returned if the URI format is not

240

# supported.

241

#

242

# - In response: always set

243

# - In create/update request: always set

244

},

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

245

},

246

],

247

"state": "A String", # State of the resource

248

"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

249

"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.

250

#

251

# Returns INVALID_ARGUMENT if this field is set

252

# but the summary is not SUCCESS.

#

# Optional

# LINT.IfChange

"otherNativeCrash": True or False, # If a native process other than the app crashed.

257

},

258

"skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.

259

#

260

# Returns INVALID_ARGUMENT if this field is set

261

# but the summary is not SKIPPED.

262

#

263

# Optional

264

"incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.

265

"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.

266

"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.

267

},

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

268

"summary": "A String", # The simplest way to interpret a result.

269

#

270

# Required

271

"failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.

272

#

273

# Returns INVALID_ARGUMENT if this field is set

274

# but the summary is not FAILURE.

275

#

276

# Optional

277

"crashed": True or False, # If the failure was severe because the system (app) under test crashed.

278

"unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not

279

# start.

280

"notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.

281

# This might be caused by trying to run a test on an unsupported platform.

282

"timedOut": True or False, # If the test overran some time limit, and that is why it failed.

283

"otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.

284

},

285

"inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.

286

#

287

# Returns INVALID_ARGUMENT if this field is set

288

# but the summary is not INCONCLUSIVE.

289

#

290

# Optional

291

"hasErrorLogs": True or False, # If results are being provided to the user in certain cases of

292

# infrastructure failures

293

"infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test

294

# depends on a component other than the system under test which failed.

295

#

296

# For example, a mobile test requires provisioning a device where the test

297

# executes, and that provisioning can fail.

298

"abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be

299

# determined.

300

# For example, the user pressed ctrl-c which sent a kill signal to the test

301

# runner while the test was running.

302

},

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

},

},

},

],

"executionId": "A String", # Output only. An Execution id.

308

"resultsStorage": { # The storage for test results. # The location where output files are stored in the user bucket.

309

"resultsStoragePath": { # A reference to a file. # The root directory for test results.

310

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

311

#

312

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

313

# or in gsutil format: gs://mybucket/path/to/test.xml

314

# with version-specific info,

315

# gs://mybucket/path/to/test.xml#1360383693690000

316

#

317

# An INVALID_ARGUMENT error will be returned if the URI format is not

318

# supported.

319

#

320

# - In response: always set

321

# - In create/update request: always set

322

},

323

"xunitXmlFile": { # A reference to a file. # The path to the Xunit XML file.

324

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

325

#

326

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

327

# or in gsutil format: gs://mybucket/path/to/test.xml

328

# with version-specific info,

329

# gs://mybucket/path/to/test.xml#1360383693690000

330

#

331

# An INVALID_ARGUMENT error will be returned if the URI format is not

332

# supported.

333

#

334

# - In response: always set

335

# - In create/update request: always set

336

},

337

},

338

"displayName": "A String", # A short human-readable name to display in the UI.

339

# Maximum of 100 characters.

340

# For example: Nexus 5, API 27.

341

"historyId": "A String", # Output only. A History id.

342

"environmentId": "A String", # Output only. An Environment id.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

343

"creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.

344

# calendar, encoded as a count of seconds and fractions of seconds at

345

# nanosecond resolution. The count is relative to an epoch at UTC midnight on

346

# January 1, 1970, in the proleptic Gregorian calendar which extends the

347

# Gregorian calendar backwards to year one.

348

#

349

# All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap

350

# second table is needed for interpretation, using a [24-hour linear

351

# smear](https://developers.google.com/time/smear).

352

#

353

# The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By

354

# restricting to that range, we ensure that we can convert to and from [RFC

355

# 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.

356

"nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative

357

# second values with fractions must still have non-negative nanos values

358

# that count forward in time. Must be from 0 to 999,999,999

359

# inclusive.

360

"seconds": "A String", # Represents seconds of UTC time since Unix epoch

361

# 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to

362

# 9999-12-31T23:59:59Z inclusive.

363

},

364

"environmentResult": { # Merged test result for environment. # Merged result of the environment.

365

#

366

# If the environment has only one step (no reruns or shards), then the merged

367

# result is the same as the step result. If the environment has multiple shards

368

# and/or reruns, then the results of shards and reruns that belong to the same

369

# environment are merged into one environment result.

370

"testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part

371

# of this environment.

372

#

373

# Combining:

374

# When the test cases from a suite are run in different steps (sharding),

375

# the results are added back together in one overview. (e.g., if shard1 has

376

# 2 failures and shard2 has 1 failure than the overview failure_count = 3).

377

#

378

# Rollup:

379

# When test cases from the same suite are run multiple times (flaky), the

380

# results are combined (e.g., if testcase1.run1 fails, testcase1.run2

381

# passes, and both testcase2.run1 and testcase2.run2 fail then the overview

382

# flaky_count = 1 and failure_count = 1).

383

{ # A summary of a test suite result either parsed from XML or uploaded

384

# directly by a user.

385

#

386

# Note: the API related comments are for StepService only. This message is

387

# also being used in ExecutionService in a read only mode for the corresponding

388

# step.

389

"failureCount": 42, # Number of failed test cases, typically set by the service by parsing the

390

# xml_source. May also be set by the user.

391

#

392

# - In create/response: always set

393

# - In update request: never

394

"name": "A String", # The name of the test suite.

395

#

396

# - In create/response: always set

397

# - In update request: never

398

"elapsedTime": { # # Elapsed time of test suite.

399

# A Duration represents a signed, fixed-length span of time represented

400

# as a count of seconds and fractions of seconds at nanosecond

401

# resolution. It is independent of any calendar and concepts like "day"

402

# or "month". It is related to Timestamp in that the difference between

403

# two Timestamp values is a Duration and it can be added or subtracted

404

# from a Timestamp. Range is approximately +-10,000 years.

405

"seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000

406

# to +315,576,000,000 inclusive. Note: these bounds are computed from:

407

# 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

408

"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span

409

# of time. Durations less than one second are represented with a 0

410

# `seconds` field and a positive or negative `nanos` field. For durations

411

# of one second or more, a non-zero value for the `nanos` field must be

412

# of the same sign as the `seconds` field. Must be from -999,999,999

413

# to +999,999,999 inclusive.

414

},

415

"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test

416

# attempts.

417

#

418

# Present only for rollup test suite overview at environment level. A step

419

# cannot have flaky test cases.

420

"errorCount": 42, # Number of test cases in error, typically set by the service by parsing the

421

# xml_source.

422

#

423

# - In create/response: always set

424

# - In update request: never

425

"totalCount": 42, # Number of test cases, typically set by the service by parsing the

426

# xml_source.

427

#

428

# - In create/response: always set

429

# - In update request: never

430

"skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the

431

# xml_source.

432

#

433

# - In create/response: always set

434

# - In update request: never

435

"xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original

436

# XML file is stored.

437

#

438

# Note: Multiple test suites can share the same xml_source

439

#

440

# Returns INVALID_ARGUMENT if the uri format is not supported.

441

#

442

# - In create/response: optional

443

# - In update request: never

444

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

445

#

446

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

447

# or in gsutil format: gs://mybucket/path/to/test.xml

448

# with version-specific info,

449

# gs://mybucket/path/to/test.xml#1360383693690000

450

#

451

# An INVALID_ARGUMENT error will be returned if the URI format is not

452

# supported.

453

#

454

# - In response: always set

455

# - In create/update request: always set

},

},

],

"state": "A String", # State of the resource

460

"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource

461

"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.

462

#

463

# Returns INVALID_ARGUMENT if this field is set

464

# but the summary is not SUCCESS.

#

# Optional

# LINT.IfChange

"otherNativeCrash": True or False, # If a native process other than the app crashed.

469

},

470

"skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.

471

#

472

# Returns INVALID_ARGUMENT if this field is set

473

# but the summary is not SKIPPED.

474

#

475

# Optional

476

"incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.

477

"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.

478

"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.

479

},

480

"summary": "A String", # The simplest way to interpret a result.

481

#

482

# Required

483

"failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.

484

#

485

# Returns INVALID_ARGUMENT if this field is set

486

# but the summary is not FAILURE.

487

#

488

# Optional

489

"crashed": True or False, # If the failure was severe because the system (app) under test crashed.

490

"unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not

491

# start.

492

"notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.

493

# This might be caused by trying to run a test on an unsupported platform.

494

"timedOut": True or False, # If the test overran some time limit, and that is why it failed.

495

"otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.

496

},

497

"inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.

498

#

499

# Returns INVALID_ARGUMENT if this field is set

500

# but the summary is not INCONCLUSIVE.

501

#

502

# Optional

503

"hasErrorLogs": True or False, # If results are being provided to the user in certain cases of

504

# infrastructure failures

505

"infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test

506

# depends on a component other than the system under test which failed.

507

#

508

# For example, a mobile test requires provisioning a device where the test

509

# executes, and that provisioning can fail.

510

"abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be

511

# determined.

512

# For example, the user pressed ctrl-c which sent a kill signal to the test

513

# runner while the test was running.

},

},

},

"dimensionValue": [ # Dimension values describing the environment. Dimension values always

518

# consist of "Model", "Version", "Locale", and "Orientation".

519

#

520

# - In response: always set

521

# - In create request: always set

522

# - In update request: never set

{

"value": "A String",

"key": "A String",

},

],

"projectId": "A String", # Output only. A Project id.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list">list(projectId, historyId, executionId, pageToken=None, pageSize=None, x__xgafv=None)</code>

534

<pre>Lists Environments for a given Execution.

535

536

The Environments are sorted by display name.

537

538

May return any of the following canonical error codes:

539

540

- PERMISSION_DENIED - if the user is not authorized to read project

541

- INVALID_ARGUMENT - if the request is malformed

542

- NOT_FOUND - if the containing Execution does not exist

543

544

Args:

545

projectId: string, Required. A Project id. (required)

546

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

547

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

548

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

549

pageSize: integer, The maximum number of Environments to fetch.

550

551

Default value: 25. The server will use this default if the field is not set

552

or has a value of 0.

553

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

560

561

{ # Response message for EnvironmentService.ListEnvironments.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

562

"projectId": "A String", # A Project id.

563

#

564

# Always set.

565

"historyId": "A String", # A History id.

566

#

567

# Always set.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

568

"executionId": "A String", # A Execution id

569

#

570

# Always set.

571

"nextPageToken": "A String", # A continuation token to resume the query at the next item.

572

#

573

# Will only be set if there are more Environments to fetch.

574

"environments": [ # Environments.

575

#

576

# Always set.

577

{ # An Environment represents the set of test runs (Steps) from the parent

578

# Execution that are configured with the same set of dimensions (Model,

579

# Version, Locale, and Orientation). Multiple such runs occur particularly

580

# because of features like sharding (splitting up a test suite to run in

581

# parallel across devices) and reruns (running a test multiple times to check

582

# for different outcomes).

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

583

"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.

584

#

585

# This value will be set automatically when state transitions to

586

# COMPLETE.

587

# calendar, encoded as a count of seconds and fractions of seconds at

588

# nanosecond resolution. The count is relative to an epoch at UTC midnight on

589

# January 1, 1970, in the proleptic Gregorian calendar which extends the

590

# Gregorian calendar backwards to year one.

591

#

592

# All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap

593

# second table is needed for interpretation, using a [24-hour linear

594

# smear](https://developers.google.com/time/smear).

595

#

596

# The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By

597

# restricting to that range, we ensure that we can convert to and from [RFC

598

# 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.

599

"nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative

600

# second values with fractions must still have non-negative nanos values

601

# that count forward in time. Must be from 0 to 999,999,999

602

# inclusive.

603

"seconds": "A String", # Represents seconds of UTC time since Unix epoch

604

# 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to

605

# 9999-12-31T23:59:59Z inclusive.

606

},

607

"shardSummaries": [ # Output only. Summaries of shards.

608

#

609

# Only one shard will present unless sharding feature is enabled in

610

# TestExecutionService.

611

{ # Result summary for a shard in an environment.

612

"runs": [ # Summaries of the steps belonging to the shard.

613

#

614

# With flaky_test_attempts enabled from TestExecutionService, more than one

615

# run (Step) can present. And the runs will be sorted by multistep_number.

616

{ # Lightweight summary of a step within this execution.

617

},

618

],

619

"shardResult": { # Merged test result for environment. # Merged result of the shard.

620

#

621

# If the environment has only one step (no reruns or shards), then the merged

622

# result is the same as the step result. If the environment has multiple shards

623

# and/or reruns, then the results of shards and reruns that belong to the same

624

# environment are merged into one environment result.

625

"testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part

626

# of this environment.

627

#

628

# Combining:

629

# When the test cases from a suite are run in different steps (sharding),

630

# the results are added back together in one overview. (e.g., if shard1 has

631

# 2 failures and shard2 has 1 failure than the overview failure_count = 3).

632

#

633

# Rollup:

634

# When test cases from the same suite are run multiple times (flaky), the

635

# results are combined (e.g., if testcase1.run1 fails, testcase1.run2

636

# passes, and both testcase2.run1 and testcase2.run2 fail then the overview

637

# flaky_count = 1 and failure_count = 1).

638

{ # A summary of a test suite result either parsed from XML or uploaded

639

# directly by a user.

640

#

641

# Note: the API related comments are for StepService only. This message is

642

# also being used in ExecutionService in a read only mode for the corresponding

643

# step.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

644

"failureCount": 42, # Number of failed test cases, typically set by the service by parsing the

645

# xml_source. May also be set by the user.

646

#

647

# - In create/response: always set

648

# - In update request: never

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

649

"name": "A String", # The name of the test suite.

650

#

651

# - In create/response: always set

652

# - In update request: never

653

"elapsedTime": { # # Elapsed time of test suite.

654

# A Duration represents a signed, fixed-length span of time represented

655

# as a count of seconds and fractions of seconds at nanosecond

656

# resolution. It is independent of any calendar and concepts like "day"

657

# or "month". It is related to Timestamp in that the difference between

658

# two Timestamp values is a Duration and it can be added or subtracted

659

# from a Timestamp. Range is approximately +-10,000 years.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

660

"seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000

661

# to +315,576,000,000 inclusive. Note: these bounds are computed from:

662

# 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

663

"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span

664

# of time. Durations less than one second are represented with a 0

665

# `seconds` field and a positive or negative `nanos` field. For durations

666

# of one second or more, a non-zero value for the `nanos` field must be

667

# of the same sign as the `seconds` field. Must be from -999,999,999

668

# to +999,999,999 inclusive.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

669

},

670

"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test

671

# attempts.

672

#

673

# Present only for rollup test suite overview at environment level. A step

674

# cannot have flaky test cases.

675

"errorCount": 42, # Number of test cases in error, typically set by the service by parsing the

676

# xml_source.

677

#

678

# - In create/response: always set

679

# - In update request: never

680

"totalCount": 42, # Number of test cases, typically set by the service by parsing the

681

# xml_source.

682

#

683

# - In create/response: always set

684

# - In update request: never

685

"skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the

686

# xml_source.

687

#

688

# - In create/response: always set

689

# - In update request: never

690

"xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original

691

# XML file is stored.

692

#

693

# Note: Multiple test suites can share the same xml_source

694

#

695

# Returns INVALID_ARGUMENT if the uri format is not supported.

696

#

697

# - In create/response: optional

698

# - In update request: never

699

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

700

#

701

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

702

# or in gsutil format: gs://mybucket/path/to/test.xml

703

# with version-specific info,

704

# gs://mybucket/path/to/test.xml#1360383693690000

705

#

706

# An INVALID_ARGUMENT error will be returned if the URI format is not

707

# supported.

708

#

709

# - In response: always set

710

# - In create/update request: always set

711

},

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

712

},

713

],

714

"state": "A String", # State of the resource

715

"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

716

"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.

717

#

718

# Returns INVALID_ARGUMENT if this field is set

719

# but the summary is not SUCCESS.

#

# Optional

# LINT.IfChange

"otherNativeCrash": True or False, # If a native process other than the app crashed.

724

},

725

"skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.

726

#

727

# Returns INVALID_ARGUMENT if this field is set

728

# but the summary is not SKIPPED.

729

#

730

# Optional

731

"incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.

732

"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.

733

"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.

734

},

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

735

"summary": "A String", # The simplest way to interpret a result.

736

#

737

# Required

738

"failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.

739

#

740

# Returns INVALID_ARGUMENT if this field is set

741

# but the summary is not FAILURE.

742

#

743

# Optional

744

"crashed": True or False, # If the failure was severe because the system (app) under test crashed.

745

"unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not

746

# start.

747

"notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.

748

# This might be caused by trying to run a test on an unsupported platform.

749

"timedOut": True or False, # If the test overran some time limit, and that is why it failed.

750

"otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.

751

},

752

"inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.

753

#

754

# Returns INVALID_ARGUMENT if this field is set

755

# but the summary is not INCONCLUSIVE.

756

#

757

# Optional

758

"hasErrorLogs": True or False, # If results are being provided to the user in certain cases of

759

# infrastructure failures

760

"infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test

761

# depends on a component other than the system under test which failed.

762

#

763

# For example, a mobile test requires provisioning a device where the test

764

# executes, and that provisioning can fail.

765

"abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be

766

# determined.

767

# For example, the user pressed ctrl-c which sent a kill signal to the test

768

# runner while the test was running.

769

},

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

},

},

},

],

"executionId": "A String", # Output only. An Execution id.

775

"resultsStorage": { # The storage for test results. # The location where output files are stored in the user bucket.

776

"resultsStoragePath": { # A reference to a file. # The root directory for test results.

777

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

778

#

779

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

780

# or in gsutil format: gs://mybucket/path/to/test.xml

781

# with version-specific info,

782

# gs://mybucket/path/to/test.xml#1360383693690000

783

#

784

# An INVALID_ARGUMENT error will be returned if the URI format is not

785

# supported.

786

#

787

# - In response: always set

788

# - In create/update request: always set

789

},

790

"xunitXmlFile": { # A reference to a file. # The path to the Xunit XML file.

791

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

792

#

793

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

794

# or in gsutil format: gs://mybucket/path/to/test.xml

795

# with version-specific info,

796

# gs://mybucket/path/to/test.xml#1360383693690000

797

#

798

# An INVALID_ARGUMENT error will be returned if the URI format is not

799

# supported.

800

#

801

# - In response: always set

802

# - In create/update request: always set

803

},

804

},

805

"displayName": "A String", # A short human-readable name to display in the UI.

806

# Maximum of 100 characters.

807

# For example: Nexus 5, API 27.

808

"historyId": "A String", # Output only. A History id.

809

"environmentId": "A String", # Output only. An Environment id.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

810

"creationTime": { # A Timestamp represents a point in time independent of any time zone or local # Output only. The time when the Environment was created.

811

# calendar, encoded as a count of seconds and fractions of seconds at

812

# nanosecond resolution. The count is relative to an epoch at UTC midnight on

813

# January 1, 1970, in the proleptic Gregorian calendar which extends the

814

# Gregorian calendar backwards to year one.

815

#

816

# All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap

817

# second table is needed for interpretation, using a [24-hour linear

818

# smear](https://developers.google.com/time/smear).

819

#

820

# The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By

821

# restricting to that range, we ensure that we can convert to and from [RFC

822

# 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.

823

"nanos": 42, # Non-negative fractions of a second at nanosecond resolution. Negative

824

# second values with fractions must still have non-negative nanos values

825

# that count forward in time. Must be from 0 to 999,999,999

826

# inclusive.

827

"seconds": "A String", # Represents seconds of UTC time since Unix epoch

828

# 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to

829

# 9999-12-31T23:59:59Z inclusive.

830

},

831

"environmentResult": { # Merged test result for environment. # Merged result of the environment.

832

#

833

# If the environment has only one step (no reruns or shards), then the merged

834

# result is the same as the step result. If the environment has multiple shards

835

# and/or reruns, then the results of shards and reruns that belong to the same

836

# environment are merged into one environment result.

837

"testSuiteOverviews": [ # The combined and rolled-up result of each test suite that was run as part

838

# of this environment.

839

#

840

# Combining:

841

# When the test cases from a suite are run in different steps (sharding),

842

# the results are added back together in one overview. (e.g., if shard1 has

843

# 2 failures and shard2 has 1 failure than the overview failure_count = 3).

844

#

845

# Rollup:

846

# When test cases from the same suite are run multiple times (flaky), the

847

# results are combined (e.g., if testcase1.run1 fails, testcase1.run2

848

# passes, and both testcase2.run1 and testcase2.run2 fail then the overview

849

# flaky_count = 1 and failure_count = 1).

850

{ # A summary of a test suite result either parsed from XML or uploaded

851

# directly by a user.

852

#

853

# Note: the API related comments are for StepService only. This message is

854

# also being used in ExecutionService in a read only mode for the corresponding

855

# step.

856

"failureCount": 42, # Number of failed test cases, typically set by the service by parsing the

857

# xml_source. May also be set by the user.

858

#

859

# - In create/response: always set

860

# - In update request: never

861

"name": "A String", # The name of the test suite.

862

#

863

# - In create/response: always set

864

# - In update request: never

865

"elapsedTime": { # # Elapsed time of test suite.

866

# A Duration represents a signed, fixed-length span of time represented

867

# as a count of seconds and fractions of seconds at nanosecond

868

# resolution. It is independent of any calendar and concepts like "day"

869

# or "month". It is related to Timestamp in that the difference between

870

# two Timestamp values is a Duration and it can be added or subtracted

871

# from a Timestamp. Range is approximately +-10,000 years.

872

"seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000

873

# to +315,576,000,000 inclusive. Note: these bounds are computed from:

874

# 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

875

"nanos": 42, # Signed fractions of a second at nanosecond resolution of the span

876

# of time. Durations less than one second are represented with a 0

877

# `seconds` field and a positive or negative `nanos` field. For durations

878

# of one second or more, a non-zero value for the `nanos` field must be

879

# of the same sign as the `seconds` field. Must be from -999,999,999

880

# to +999,999,999 inclusive.

881

},

882

"flakyCount": 42, # Number of flaky test cases, set by the service by rolling up flaky test

883

# attempts.

884

#

885

# Present only for rollup test suite overview at environment level. A step

886

# cannot have flaky test cases.

887

"errorCount": 42, # Number of test cases in error, typically set by the service by parsing the

888

# xml_source.

889

#

890

# - In create/response: always set

891

# - In update request: never

892

"totalCount": 42, # Number of test cases, typically set by the service by parsing the

893

# xml_source.

894

#

895

# - In create/response: always set

896

# - In update request: never

897

"skippedCount": 42, # Number of test cases not run, typically set by the service by parsing the

898

# xml_source.

899

#

900

# - In create/response: always set

901

# - In update request: never

902

"xmlSource": { # A reference to a file. # If this test suite was parsed from XML, this is the URI where the original

903

# XML file is stored.

904

#

905

# Note: Multiple test suites can share the same xml_source

906

#

907

# Returns INVALID_ARGUMENT if the uri format is not supported.

908

#

909

# - In create/response: optional

910

# - In update request: never

911

"fileUri": "A String", # The URI of a file stored in Google Cloud Storage.

912

#

913

# For example: http://storage.googleapis.com/mybucket/path/to/test.xml

914

# or in gsutil format: gs://mybucket/path/to/test.xml

915

# with version-specific info,

916

# gs://mybucket/path/to/test.xml#1360383693690000

917

#

918

# An INVALID_ARGUMENT error will be returned if the URI format is not

919

# supported.

920

#

921

# - In response: always set

922

# - In create/update request: always set

},

},

],

"state": "A String", # State of the resource

927

"outcome": { # Interprets a result so that humans and machines can act on it. # Outcome of the resource

928

"successDetail": { # Details for an outcome with a SUCCESS outcome summary. # More information about a SUCCESS outcome.

929

#

930

# Returns INVALID_ARGUMENT if this field is set

931

# but the summary is not SUCCESS.

#

# Optional

# LINT.IfChange

"otherNativeCrash": True or False, # If a native process other than the app crashed.

936

},

937

"skippedDetail": { # Details for an outcome with a SKIPPED outcome summary. # More information about a SKIPPED outcome.

938

#

939

# Returns INVALID_ARGUMENT if this field is set

940

# but the summary is not SKIPPED.

941

#

942

# Optional

943

"incompatibleAppVersion": True or False, # If the App doesn't support the specific API level.

944

"incompatibleDevice": True or False, # If the requested OS version doesn't run on the specific device model.

945

"incompatibleArchitecture": True or False, # If the App doesn't run on the specific architecture, for example, x86.

946

},

947

"summary": "A String", # The simplest way to interpret a result.

948

#

949

# Required

950

"failureDetail": { # Details for an outcome with a FAILURE outcome summary. # More information about a FAILURE outcome.

951

#

952

# Returns INVALID_ARGUMENT if this field is set

953

# but the summary is not FAILURE.

954

#

955

# Optional

956

"crashed": True or False, # If the failure was severe because the system (app) under test crashed.

957

"unableToCrawl": True or False, # If the robo was unable to crawl the app; perhaps because the app did not

958

# start.

959

"notInstalled": True or False, # If an app is not installed and thus no test can be run with the app.

960

# This might be caused by trying to run a test on an unsupported platform.

961

"timedOut": True or False, # If the test overran some time limit, and that is why it failed.

962

"otherNativeCrash": True or False, # If a native process (including any other than the app) crashed.

963

},

964

"inconclusiveDetail": { # Details for an outcome with an INCONCLUSIVE outcome summary. # More information about an INCONCLUSIVE outcome.

965

#

966

# Returns INVALID_ARGUMENT if this field is set

967

# but the summary is not INCONCLUSIVE.

968

#

969

# Optional

970

"hasErrorLogs": True or False, # If results are being provided to the user in certain cases of

971

# infrastructure failures

972

"infrastructureFailure": True or False, # If the test runner could not determine success or failure because the test

973

# depends on a component other than the system under test which failed.

974

#

975

# For example, a mobile test requires provisioning a device where the test

976

# executes, and that provisioning can fail.

977

"abortedByUser": True or False, # If the end user aborted the test execution before a pass or fail could be

978

# determined.

979

# For example, the user pressed ctrl-c which sent a kill signal to the test

980

# runner while the test was running.

},

},

},

"dimensionValue": [ # Dimension values describing the environment. Dimension values always

985

# consist of "Model", "Version", "Locale", and "Orientation".

986

#

987

# - In response: always set

988

# - In create request: always set

989

# - In update request: never set

{

"value": "A String",

"key": "A String",

},

],

"projectId": "A String", # Output only. A Project id.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

996

},

997

],

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

1003

<pre>Retrieves the next page of results.

1004

1005

Args:

1006

previous_request: The request for the previous page. (required)

1007

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

1008

1009

Returns:

1010

A request object that you can call 'execute()' on to request the next

1011

page. Returns None if there are no more items in the collection.

</pre>

</div>

</body></html>