Uh oh!
There was an error while loading. Please reload this page.
refactor!: Refactor GistsService to use value parameters - #3680
refactor!: Refactor GistsService to use value parameters#3680sarthakw7 wants to merge 4 commits into
Conversation
gmlewis
left a comment
There was a problem hiding this comment.
Thank you, @sarthakw7!
LGTM.
Awaiting second LGTM+Approval from any other contributor to this repo before merging.
@alexandear or @stevehipwell - might you have time for a code review? Thank you!
stevehipwell
left a comment
There was a problem hiding this comment.
This PR looks good @sarthakw7 but I'd like to hear back from @gmlewis about the API design before approving.
| // | ||
| //meta:operation PATCH /gists/{gist_id} | ||
| func (s *GistsService) Edit(ctx context.Context, id string, gist *Gist) (*Gist, *Response, error) { | ||
| func (s *GistsService) Edit(ctx context.Context, id string, gist UpdateGistRequest) (*Gist, *Response, error) { |
There was a problem hiding this comment.
| func (s*GistsService) Edit(ctx context.Context, idstring, gistUpdateGistRequest) (*Gist, *Response, error) { | |
| func (s*GistsService) Update(ctx context.Context, idstring, gistUpdateGistRequest) (*Gist, *Response, error) { |
I think the API consistency would be improved if we replaced Edit with Update and if we're changing the method signature that seems like a good time to make this change? @gmlewis what do you think?
There was a problem hiding this comment.
I’ll go ahead and replace Edit → Update and EditComment → UpdateComment to keep things consistent
| func (s *GistsService) CreateFromGist(ctx context.Context, gist *Gist) (*Gist, *Response, error) { | ||
| var req CreateGistRequest | ||
| if gist != nil { | ||
| req = CreateGistRequest{ | ||
| Description: gist.Description, | ||
| Public: gist.Public, | ||
| Files: gist.Files, | ||
| } | ||
| } | ||
| return s.Create(ctx, req) | ||
| } |
There was a problem hiding this comment.
Why do we need this wrapper?
In this PR #3654 we didn't introduce any wrappers, but it breaks API in a similar way.
There was a problem hiding this comment.
I agree that we don't need the wrappers. I was trying to decide, but I think you are correct, @alexandear.
There was a problem hiding this comment.
Got it.
Since wrappers aren’t needed, I’ll go ahead and remove the four deprecated methods (CreateFromGist, EditFromGist, CreateCommentFromGistComment, and EditCommentFromGistComment)
gmlewis
commented
Sep 22, 2025
@stevehipwell and/or @alexandear - do you approve this PR now? |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@## master #3680 +/- ##
==========================================
+ Coverage 91.12% 91.15% +0.02%
==========================================
Files 187 187 Lines 16640 16679 +39 ==========================================
+ Hits 15164 15203 +39
Misses 1291 1291 Partials 185 185 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
stevehipwell
commented
Sep 23, 2025
@gmlewis I don't think the agreed actions from the review conversations have been completed yet. @sarthakw7 are you still planning on making the changes? |
BREAKING CHANGE: GistsService.Create / Update / CreateComment / UpdateComment now take dedicated request structs by value (CreateGistRequest, UpdateGistRequest, CreateGistCommentRequest, UpdateGistCommentRequest) instead of *Gist / *GistComment. Edit is renamed to Update and EditComment is renamed to UpdateComment. This completes the stalled PR google#3680, applying the maintainer-agreed review feedback that was never addressed: drop the deprecated wrappers entirely and rename Edit/EditComment to Update/UpdateComment for API consistency. The now-obsolete Gist and GistComment entries are removed from the paramcheck body-allowed-pointer-types allow-list in .golangci.yml. Relates to google#3644. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
BREAKING CHANGE: GistsService.Create / Update / CreateComment / UpdateComment now take dedicated request structs by value (CreateGistRequest, UpdateGistRequest, CreateGistCommentRequest, UpdateGistCommentRequest) instead of *Gist / *GistComment. Edit is renamed to Update and EditComment is renamed to UpdateComment. This completes the stalled PR google#3680, applying the maintainer-agreed review feedback that was never addressed: drop the deprecated wrappers entirely and rename Edit/EditComment to Update/UpdateComment for API consistency. The now-obsolete Gist and GistComment entries are removed from the paramcheck body-allowed-pointer-types allow-list in .golangci.yml. Relates to google#3644.
BREAKING CHANGE:
GistsServicemethods now pass required params by-value instead of by-ref.Summary
This PR refactors the GistsService to use value parameters instead of pointer parameters where appropriate, addressing issue #3644. This is the first service in a planned series of PRs to improve API design consistency across the entire library.
Changes
New Input Structs
CreateGistRequest- Input for creating gists (3 fields)UpdateGistRequest- Input for updating gists (2 fields)CreateGistCommentRequest- Input for creating gist comments (1 field)UpdateGistCommentRequest- Input for updating gist comments (1 field)Refactored Methods (New API)
Create(ctx, CreateGistRequest)- Uses value parameterEdit(ctx, id, UpdateGistRequest)- Uses value parameterCreateComment(ctx, gistID, CreateGistCommentRequest)- Uses value parameterEditComment(ctx, gistID, commentID, UpdateGistCommentRequest)- Uses value parameterBackward Compatibility (Deprecated API)
CreateFromGist(ctx, *Gist)- Wrapper for backward compatibilityEditFromGist(ctx, id, *Gist)- Wrapper for backward compatibilityCreateCommentFromGistComment(ctx, gistID, *GistComment)- Wrapper for backward compatibilityEditCommentFromGistComment(ctx, gistID, commentID, *GistComment)- Wrapper for backward compatibility