No Description

Willem van Bergen e5245babad Merge pull request #333 from Shopify/partition_based_on_entire_message 10 years ago
mocks abfb8a5a6f Add tests for channel draining expectations. 10 years ago
vagrant 19f91ba46b Kafka 0.8.2.1 in CI etc. 10 years ago
.gitignore d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster. 11 years ago
.travis.yml 25161444de Enable errcheck on subpackages, and address error handling that was missed before. 10 years ago
CONTRIBUTING.md 6aacbb7d86 Some additions 11 years ago
MIT-LICENSE 86b4691cdd Add license information 12 years ago
README.md 733cb00b74 Add compatibility guarantee to README 10 years ago
Vagrantfile 6f2b60a051 Give it more memory by default 11 years ago
broker.go 0abdf8c4f0 Move the clientID into the config object 10 years ago
broker_test.go 0abdf8c4f0 Move the clientID into the config object 10 years ago
client.go 0e95e22dd4 Various doc and naming tweaks from code review. 10 years ago
client_test.go 0e95e22dd4 Various doc and naming tweaks from code review. 10 years ago
config.go 0e95e22dd4 Various doc and naming tweaks from code review. 10 years ago
config_test.go 616ac5daa4 Unify configuration structures into config.go 10 years ago
consumer.go 0d6a34032f Make Consumer and PartitionConsumer interfaces. 10 years ago
consumer_metadata_request.go 9520ed2cbd Implement consumer metadata request/response pair 11 years ago
consumer_metadata_request_test.go 9520ed2cbd Implement consumer metadata request/response pair 11 years ago
consumer_metadata_response.go e91bb557fd golint: use CoordinatorID instead of CoordinatorId as variable name. 10 years ago
consumer_metadata_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
consumer_test.go 0d6a34032f Make Consumer and PartitionConsumer interfaces. 10 years ago
crc32_field.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
encoder_decoder.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
errors.go 9275bd2669 Update the KError enum for with Kafka 0.8.2 10 years ago
fetch_request.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
fetch_request_test.go 4969d24fa1 kafka->sarama 12 years ago
fetch_response.go 75c8106b0b Preparatory steps for the new consumer 11 years ago
fetch_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
functional_test.go 0e95e22dd4 Various doc and naming tweaks from code review. 10 years ago
length_field.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
message.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
message_set.go 2018fd405e Prefix error variables with Err 10 years ago
message_test.go 9675a91962 Added Gzip test. Simplified a little. 12 years ago
metadata_request.go 4969d24fa1 kafka->sarama 12 years ago
metadata_request_test.go 4969d24fa1 kafka->sarama 12 years ago
metadata_response.go d33e005ce0 Implement Client.WritablePartitions 11 years ago
metadata_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
mockbroker.go e571a38ded Now that mockbroker is private we don't need testState 10 years ago
offset_commit_request.go 53093b7fa8 Update a few odds and ends to the latest spec 11 years ago
offset_commit_request_test.go 53093b7fa8 Update a few odds and ends to the latest spec 11 years ago
offset_commit_response.go aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1 11 years ago
offset_commit_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
offset_fetch_request.go 39823e3af9 Check some errors 11 years ago
offset_fetch_request_test.go 4969d24fa1 kafka->sarama 12 years ago
offset_fetch_response.go aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1 11 years ago
offset_fetch_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
offset_request.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
offset_request_test.go 4969d24fa1 kafka->sarama 12 years ago
offset_response.go 39823e3af9 Check some errors 11 years ago
offset_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
packet_decoder.go 4969d24fa1 kafka->sarama 12 years ago
packet_encoder.go 2f5cf8fd16 Fixed remaining test. 12 years ago
partitioner.go 2983f9a39a Partitioners operate on the entire ProducerMessage, not just the key 10 years ago
partitioner_test.go 2983f9a39a Partitioners operate on the entire ProducerMessage, not just the key 10 years ago
prep_encoder.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
produce_request.go 0d17c78f48 producer: add warning about RequiredAcks>1 11 years ago
produce_request_test.go 2bae192c12 Use time.Duration values consistently in *Config types. 11 years ago
produce_response.go 5509b4a29c wip 12 years ago
produce_response_test.go 87c89f868c Also prefix KError instances with Err. 10 years ago
producer.go 2983f9a39a Partitioners operate on the entire ProducerMessage, not just the key 10 years ago
producer_test.go 437cd2f8c4 Add a test for bug #294 10 years ago
real_decoder.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
real_encoder.go 39823e3af9 Check some errors 11 years ago
request.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
request_test.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
response_header.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
response_header_test.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
sarama.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 10 years ago
snappy.go cabc1b4ffc golint: use var block, and simply use a variable declaration to create a byteslice with a length of 0 10 years ago
snappy_test.go b5df04ed3e Make snappy functions private 11 years ago
sync_producer.go 015a1feac8 Make SyncProducer an interface, and make the original SyncProducer internal. Add a mock for SyncProducer. 10 years ago
utils.go ea16443baa Fix safeAsyncClose logging again 11 years ago

README.md

sarama

Build Status GoDoc

Sarama is an MIT-licensed Go client library for Apache Kafka 0.8 (and later).

Documentation is available via godoc at http://godoc.org/github.com/Shopify/sarama

There is a google group for Kafka client users and authors at https://groups.google.com/forum/#!forum/kafka-clients

Sarama provides a "2 releases + 2 months" compatibility guarantee: we support the two latest releases of Kafka and Go, and we provide a two month grace period for older releases. This means we currently officially support Go 1.3 and 1.4, and Kafka 0.8.1 and 0.8.2.

A word of warning: the API is not 100% stable. It won't change much (in particular the low-level Broker and Request/Response objects could probably be considered frozen) but there may be the occasional parameter added or function renamed. As far as semantic versioning is concerned, we haven't quite hit 1.0.0 yet. It is absolutely stable enough to use, just expect that you might have to tweak things when you update to a newer version.

Other related links: