No Description

Evan Huus 9352a3d655 Put godoc badge before build status, more people care about the former 10 years ago
mocks a141cbef2e Return partition and offset when calling SendMessage. 10 years ago
vagrant effe30b4da [Vagrant] Enable topic deletion. 10 years ago
.gitignore d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster. 11 years ago
.travis.yml dc84d93edc Order both golang and kafka versions ascending in CI 10 years ago
CONTRIBUTING.md 6aacbb7d86 Some additions 11 years ago
MIT-LICENSE 86b4691cdd Add license information 12 years ago
README.md 9352a3d655 Put godoc badge before build status, more people care about the former 10 years ago
Vagrantfile 6f2b60a051 Give it more memory by default 11 years ago
async_producer.go 6be486f900 Only mention closing the Client on the FromClient constructors 10 years ago
async_producer_test.go 7661952f75 Fix producer test names. 10 years ago
broker.go 4f7be25dfb Reduce logging on broker close 10 years ago
broker_test.go 0abdf8c4f0 Move the clientID into the config object 10 years ago
client.go f0de0cead8 Cleanup disconnectBroker a bit 10 years ago
client_test.go f0de0cead8 Cleanup disconnectBroker a bit 10 years ago
config.go 4189e55a44 Return{Errors,Successes} -> Return.{Errors,Successes} 10 years ago
config_test.go 616ac5daa4 Unify configuration structures into config.go 10 years ago
consumer.go 7938e04f61 Fix PartitionConsumer godoc 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. 11 years ago
consumer_metadata_response_test.go 87c89f868c Also prefix KError instances with Err. 11 years ago
consumer_test.go aef773ae4e Close the consumer master in tests 10 years ago
crc32_field.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 11 years ago
encoder_decoder.go f35cfe20d9 Make MaxRequestSize signed for consistency with MaxResponseSize 10 years ago
errors.go 3aab8e4fdd tweak some errors 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. 11 years ago
functional_test.go 51060e6515 Rename Producer to AsyncProducer 10 years ago
length_field.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 11 years ago
message.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 11 years ago
message_set.go 2018fd405e Prefix error variables with Err 11 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. 11 years ago
mockbroker_test.go d24f15ca41 Make mockbroker part of the _test code 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. 11 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. 11 years ago
offset_request.go a9d8315553 Remove OffsetTime in lieu of int64. 10 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. 11 years ago
packet_decoder.go 4969d24fa1 kafka->sarama 12 years ago
packet_encoder.go 2f5cf8fd16 Fixed remaining test. 12 years ago
partitioner.go 1101246f70 Pass the topic to the partitioner constructor 10 years ago
partitioner_test.go 1101246f70 Pass the topic to the partitioner constructor 10 years ago
prep_encoder.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 11 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. 11 years ago
real_decoder.go 566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other. 11 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. 11 years ago
response_header_test.go 893044d278 Fix Golint errors, except for all the missing comments. 12 years ago
sarama.go f35cfe20d9 Make MaxRequestSize signed for consistency with MaxResponseSize 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 11 years ago
snappy_test.go b5df04ed3e Make snappy functions private 11 years ago
sync_producer.go 6be486f900 Only mention closing the Client on the FromClient constructors 10 years ago
sync_producer_test.go a141cbef2e Return partition and offset when calling SendMessage. 10 years ago
utils.go a92324bc51 Fix documentation of the encoder types 10 years ago

README.md

sarama

GoDoc Build Status

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: