暫無描述

Evan Huus 4f7be25dfb Reduce logging on broker close		11 年之前
mocks	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
vagrant	4c06d845e1 Give kafka slightly longer to come up	11 年之前
.gitignore	d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster.	11 年之前
.travis.yml	dc84d93edc Order both golang and kafka versions ascending in CI	11 年之前
CONTRIBUTING.md	6aacbb7d86 Some additions	11 年之前
MIT-LICENSE	86b4691cdd Add license information	12 年之前
README.md	733cb00b74 Add compatibility guarantee to README	11 年之前
Vagrantfile	6f2b60a051 Give it more memory by default	11 年之前
broker.go	4f7be25dfb Reduce logging on broker close	11 年之前
broker_test.go	0abdf8c4f0 Move the clientID into the config object	11 年之前
client.go	9ffa8c742f Retry UnknownTopicOrPartition on fetching metadata	11 年之前
client_test.go	0e95e22dd4 Various doc and naming tweaks from code review.	11 年之前
config.go	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
config_test.go	616ac5daa4 Unify configuration structures into config.go	11 年之前
consumer.go	251a2dbf7e Update consumer example comments.	11 年之前
consumer_metadata_request.go	9520ed2cbd Implement consumer metadata request/response pair	11 年之前
consumer_metadata_request_test.go	9520ed2cbd Implement consumer metadata request/response pair	11 年之前
consumer_metadata_response.go	e91bb557fd golint: use CoordinatorID instead of CoordinatorId as variable name.	11 年之前
consumer_metadata_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
consumer_test.go	251a2dbf7e Update consumer example comments.	11 年之前
crc32_field.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
encoder_decoder.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
errors.go	9275bd2669 Update the KError enum for with Kafka 0.8.2	11 年之前
fetch_request.go	893044d278 Fix Golint errors, except for all the missing comments.	12 年之前
fetch_request_test.go	4969d24fa1 kafka->sarama	12 年之前
fetch_response.go	75c8106b0b Preparatory steps for the new consumer	11 年之前
fetch_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
functional_test.go	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
length_field.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
message.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
message_set.go	2018fd405e Prefix error variables with Err	11 年之前
message_test.go	9675a91962 Added Gzip test. Simplified a little.	12 年之前
metadata_request.go	4969d24fa1 kafka->sarama	12 年之前
metadata_request_test.go	4969d24fa1 kafka->sarama	12 年之前
metadata_response.go	d33e005ce0 Implement Client.WritablePartitions	11 年之前
metadata_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
mockbroker_test.go	d24f15ca41 Make mockbroker part of the _test code	11 年之前
offset_commit_request.go	53093b7fa8 Update a few odds and ends to the latest spec	11 年之前
offset_commit_request_test.go	53093b7fa8 Update a few odds and ends to the latest spec	11 年之前
offset_commit_response.go	aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1	11 年之前
offset_commit_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
offset_fetch_request.go	39823e3af9 Check some errors	11 年之前
offset_fetch_request_test.go	4969d24fa1 kafka->sarama	12 年之前
offset_fetch_response.go	aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1	11 年之前
offset_fetch_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
offset_request.go	893044d278 Fix Golint errors, except for all the missing comments.	12 年之前
offset_request_test.go	4969d24fa1 kafka->sarama	12 年之前
offset_response.go	39823e3af9 Check some errors	11 年之前
offset_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
packet_decoder.go	4969d24fa1 kafka->sarama	12 年之前
packet_encoder.go	2f5cf8fd16 Fixed remaining test.	12 年之前
partitioner.go	2983f9a39a Partitioners operate on the entire ProducerMessage, not just the key	11 年之前
partitioner_test.go	2983f9a39a Partitioners operate on the entire ProducerMessage, not just the key	11 年之前
prep_encoder.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
produce_request.go	0d17c78f48 producer: add warning about RequiredAcks>1	11 年之前
produce_request_test.go	2bae192c12 Use time.Duration values consistently in *Config types.	11 年之前
produce_response.go	5509b4a29c wip	12 年之前
produce_response_test.go	87c89f868c Also prefix KError instances with Err.	11 年之前
producer.go	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
producer_test.go	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
real_decoder.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
real_encoder.go	39823e3af9 Check some errors	11 年之前
request.go	893044d278 Fix Golint errors, except for all the missing comments.	12 年之前
request_test.go	893044d278 Fix Golint errors, except for all the missing comments.	12 年之前
response_header.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
response_header_test.go	893044d278 Fix Golint errors, except for all the missing comments.	12 年之前
sarama.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	11 年之前
snappy.go	cabc1b4ffc golint: use var block, and simply use a variable declaration to create a byteslice with a length of 0	11 年之前
snappy_test.go	b5df04ed3e Make snappy functions private	11 年之前
sync_producer.go	5411ec3676 Rename Ack* configuration names to Return*, make ReturnErrors default to false for the Consumer, update good and examples	11 年之前
utils.go	ea16443baa Fix safeAsyncClose logging again	11 年之前

sarama

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.

README.md

sarama