Skip to content

feature(internal/sidekick/surfer): operations commands#5798

Merged
sarahheacock merged 7 commits into
googleapis:mainfrom
sarahheacock:surfer-operations
May 5, 2026
Merged

feature(internal/sidekick/surfer): operations commands#5798
sarahheacock merged 7 commits into
googleapis:mainfrom
sarahheacock:surfer-operations

Conversation

@sarahheacock
Copy link
Copy Markdown
Contributor

@sarahheacock sarahheacock commented May 4, 2026

  • Infers resource from operation method patterns to populate resource argument. Resource descriptors are not available for operation mixins
  • Adds new mixins file to provide missing information such as documentation.
  • Skip return_partial_success field since not available on all APIs

For #5485

@sarahheacock sarahheacock self-assigned this May 4, 2026
@sarahheacock sarahheacock added the surfer Issues related to the surfer project (https://github.com/googleapis/librarian/issues/2375) label May 4, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request implements support for Long Running Operations (LRO) within the surfer tool. Key changes include the synthesis of 'wait' commands for operation resources, the introduction of a new LRO mixin provider for identifying and documenting operation methods, and enhanced resource discovery that can infer operation resources from path patterns. Additionally, the PR updates argument building logic to handle LRO-specific fields and provides comprehensive test coverage, including updated golden files for several APIs. I have no feedback to provide.

@sarahheacock sarahheacock requested a review from jameslynnwu May 4, 2026 16:19
@sarahheacock sarahheacock marked this pull request as ready for review May 4, 2026 16:20
@sarahheacock sarahheacock requested review from a team as code owners May 4, 2026 16:20
Comment thread internal/sidekick/surfer/provider/mixin.go
Comment thread internal/sidekick/surfer/provider/mixin.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go
@sarahheacock sarahheacock force-pushed the surfer-operations branch 5 times, most recently from 41b4539 to 2d1f28a Compare May 4, 2026 21:52
Finish implementation of operations commands.
- Infers resource from operation method patterns to populate resource argument.
- Adds new mixins file to provide missing information such as documentation.
- Build wait command from get method
- Skip return_partial_success field since not available on all APIs

Fixes googleapis#5485
Comment thread internal/sidekick/surfer/provider/resource.go
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/mixin.go Outdated
Comment thread internal/sidekick/surfer/argument_builder_test.go
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/argument_builder.go
Comment thread internal/sidekick/surfer/provider/resource.go
@sarahheacock sarahheacock requested a review from jameslynnwu May 5, 2026 15:21
Comment thread internal/sidekick/surfer/argument_builder_test.go
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go
Comment thread internal/sidekick/surfer/provider/resource.go
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/provider/resource.go Outdated
Comment thread internal/sidekick/surfer/argument_builder.go
@sarahheacock sarahheacock merged commit 11fd477 into googleapis:main May 5, 2026
24 checks passed
sofisl pushed a commit that referenced this pull request May 5, 2026
- Infers resource from operation method patterns to populate resource
argument. Resource descriptors are not available for operation mixins
- Adds new mixins file to provide missing information such as
documentation.
- Skip return_partial_success field since not available on all APIs

For #5485
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

surfer Issues related to the surfer project (https://github.com/googleapis/librarian/issues/2375)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants