hub / github.com/IBM/sarama
github.com/IBM/sarama
Chat with this repo
4,179 symbols
21,108 edges
338 files
⚖ MIT
853 documented · 20%
● updated 2d agov1.60.1 · 2026-07-29★ 12,50414 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
sarama
Sarama is an MIT-licensed Go client library for Apache Kafka.
Getting started
- API documentation and examples are available via pkg.go.dev.
- Mocks for testing are available in the mocks subpackage.
- The examples directory contains more elaborate example applications.
- The tools directory contains command line tools that can be useful for testing, diagnostics, and instrumentation.
You might also want to look at the Frequently Asked Questions.
Compatibility and API stability
Sarama provides a "2 releases + 2 months" compatibility guarantee: we support the two latest stable releases of Kafka and Go, and we provide a two month grace period for older releases. However, older releases of Kafka are still likely to work.
Sarama follows semantic versioning and provides API stability via the standard Go module version numbering scheme.
A changelog is available here.
Contributing
- Get started by checking our contribution guidelines.
- Read the Sarama wiki for more technical and design details.
- The Kafka Protocol Specification contains a wealth of useful information.
- For more general issues, there is a google group for Kafka client developers.
- If you have any questions, just ask!
Extension points exported contracts — how you extend this code
Partitioner (Interface)
Partitioner is anything that, given a Kafka message and a number of partitions indexed [0...numPartitions-1], decides to [6 …
partitioner.go
ConsumerGroupHandler (Interface)
-------------------------------------------------------------------- ConsumerGroupHandler instances are used to handle i [9 …
consumer_group_session.go
MockResponse (Interface)
MockResponse is a response builder interface it defines one method that allows generating a response based on a request [50 …
mockresponses.go
BalanceStrategy (Interface)
-------------------------------------------------------------------- BalanceStrategy is used to balance topics and parti [4 …
balance_strategy.go
Consumer (Interface)
Consumer manages PartitionConsumers which process Kafka messages from brokers. You MUST call Close() on a consumer to av [2 …
consumer.go
SyncProducer (Interface)
SyncProducer publishes Kafka messages, blocking until they have been acknowledged. It routes messages to the correct bro [2 …
sync_producer.go
browse all types & interfaces →
Core symbols most depended-on inside this repo
↓ 111 filesdecoder
decoder is the interface that wraps the basic Decode method. Anything implementing Decoder can be extracted from bytes using …
encoder_decoder.go
↓ 108 filespacketDecoderPacketDecoder is the interface providing helpers for reading with Kafka's encoding rules. Types implementing Decoder only need to …
packet_decoder.go
↓ 108 filesencoderEncoder is the interface that wraps the basic Encode method. Anything implementing Encoder can be turned into bytes using Kafka's …
encoder_decoder.go
↓ 106 filespacketEncoderPacketEncoder is the interface providing helpers for writing with Kafka's encoding rules. Types implementing Encoder only need to …
packet_encoder.go
↓ 109 filesversionedDecoderencoder_decoder.go
↓ 84 filesTestReporterTestReporter has methods matching go's testing.T to avoid importing `testing` in the main part of the library.
mockresponses.go
Shape
Languages
Go100%
Modules by API surface
mockresponses.go198 symbols
broker.go115 symbols
admin.go96 symbols
async_producer.go95 symbols
async_producer_test.go90 symbols
consumer.go83 symbols
client.go82 symbols
balance_strategy.go70 symbols
admin_test.go64 symbols
consumer_test.go50 symbols
balance_strategy_test.go50 symbols
offset_manager.go48 symbols
Dependencies from manifests, versioned
github.com/IBM/saramav1.50.2 · 1×
github.com/cespare/xxhash/v2v2.3.0 · 1×
github.com/davecgh/go-spewv1.1.1 · 1×
github.com/eapache/go-resiliencyv1.7.0 · 1×
github.com/go-logr/logrv1.4.3 · 1×
github.com/go-logr/stdrv1.2.2 · 1×
github.com/google/uuidv1.6.0 · 1×
github.com/hashicorp/go-uuidv1.0.3 · 1×
github.com/jcmturner/aescts/v2v2.0.0 · 1×
github.com/jcmturner/dnsutils/v2v2.0.0 · 1×
github.com/jcmturner/goforkv1.7.6 · 1×
github.com/jcmturner/gokrb5/v8v8.4.4 · 1×
For agents
$ claude mcp add sarama \
-- python -m otcore.mcp_server <graph>