暫無描述

Evan Huus ea09ec0652 Add a test for bug #325		11 年之前
mocks	e4ee98f586 Add package level godoc, fix some typos.	11 年之前
vagrant	1d27b1a359 Run CI against Kafka 0.8.2.0 and 0.8.1.1	11 年之前
.gitignore	d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster.	11 年之前
.travis.yml	3cb648fea7 Drop official support for go 1.2	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	0abdf8c4f0 Move the clientID into the config object	11 年之前
broker_test.go	0abdf8c4f0 Move the clientID into the config object	11 年之前
client.go	0e95e22dd4 Various doc and naming tweaks from code review.	11 年之前
client_test.go	0e95e22dd4 Various doc and naming tweaks from code review.	11 年之前
config.go	0e95e22dd4 Various doc and naming tweaks from code review.	11 年之前
config_test.go	616ac5daa4 Unify configuration structures into config.go	11 年之前
consumer.go	6e7ef3c572 Permit constructing producers/consumers without clients	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	ea09ec0652 Add a test for bug #325	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	0e95e22dd4 Various doc and naming tweaks from code review.	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.go	e571a38ded Now that mockbroker is private we don't need testState	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	12 年之前
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	12 年之前
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	3b38704acc Make partitioner implementations private	11 年之前
partitioner_test.go	3b38704acc Make partitioner implementations private	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	fc30281c47 Move the Producer interface to Sarama itself, and make the current Producer struct private.	11 年之前
producer_test.go	4a62390a8f Clean up and document 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	015a1feac8 Make SyncProducer an interface, and make the original SyncProducer internal. Add a mock for SyncProducer.	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