docs(integrations): rewrite go-integration.md for gRPC streams#604
Merged
Conversation
The previous version documented the REST-based sdks/go client that PR #600 deleted. Rewritten to use the official gRPC clients: pkg/producerclient (Connect → Produce per session) and pkg/workerclient (Run with Handler returning Completed/Failed/Nack/Abandon). Sections preserved: stdlib HTTP, Gin, dedicated worker process, best practices, troubleshooting. Code examples are now copy-paste-runnable against the current API surface. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites
docs/integrations/go-integration.mdto use the official gRPC streaming clients (pkg/producerclient+pkg/workerclient) instead of the deleted RESTsdks/goclient.Why
PR #600 deleted
sdks/go/(REST-based Go SDK). This integration guide was the last surviving doc that still referenced the deleted import pathgithub.com/osvaldoandrade/codeq/sdks/goand itsNewClient/CreateTask/ClaimTask/SubmitResultAPI. PR #603 (U7 docs surgery) flagged it as out-of-scope follow-up.Changes
:9091/:9092.go get github.com/osvaldoandrade/codeq(no separate sub-module).producerclient.New→Connect→Producewith copy-pasteable handlers.workerclient.New→Run(ctx, handler)returningCompleted/Failed/Nack/Abandon.Resultconstructor reference table,Concurrency+BatchSizetuning guidance, producer pipelining note.:9092, hello rejection, context deadline, idle worker diagnostics).Test plan
grep -nE 'sdks/(go|java|python|nodejs)|NewClient\b|ClaimTask\b|SubmitResult\b'— no hitsgo build ./...— cleanpkg/producerclient/client.goandpkg/workerclient/client.goAPI surfaceMerge order
Independent of PRs #596-#603. Can merge any time after #600 (which deletes
sdks/go/).🤖 Generated with Claude Code