Bez popisu

Evan Huus 7cdfc5b3e0 Replace 'other' with 'contributing' and make it more friendly před 10 roky
examples af448a6f24 Fix names as a_name to be aName před 10 roky
mocks 3695413ed2 Collapse two sync.atomic calls před 10 roky
tools 9008214b35 Rename topicConsumer tool to just consumer před 10 roky
vagrant 30ddad94af Make sure the toxiproxy path is based in the repository root před 10 roky
.gitignore d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster. před 11 roky
.travis.yml 00604524c5 Officially drop 1.3 (but it still works for now) před 10 roky
CHANGELOG.md ce7cca6917 Fix changelog typo před 10 roky
CONTRIBUTING.md 6aacbb7d86 Some additions před 11 roky
MIT-LICENSE 86b4691cdd Add license information před 12 roky
Makefile 44d2339061 Put a 60s limit on the test suite před 10 roky
README.md 7cdfc5b3e0 Replace 'other' with 'contributing' and make it more friendly před 10 roky
Vagrantfile cf5665ab9a Increase memory with vagrant virtualbox před 11 roky
async_producer.go 52c880384b Extract produceSet and add tests před 10 roky
async_producer_test.go 733c74f30d Refactor the producer, part 2 před 10 roky
broker.go b51603af22 Make dead brokers die harder před 10 roky
broker_test.go 39f6444f59 Don't return from example functions před 10 roky
client.go 12d29331cf A few minor suggestions from golint před 10 roky
client_test.go 1874f69e22 Shuffle seed brokers so we don't always connect to the first one provided před 10 roky
config.go 6facece8ef Wrap godoc to 80 chars, round 2 před 10 roky
config_test.go 616ac5daa4 Unify configuration structures into config.go před 11 roky
consumer.go 6facece8ef Wrap godoc to 80 chars, round 2 před 10 roky
consumer_metadata_request.go aa411f16fd Add decode method to request types před 10 roky
consumer_metadata_request_test.go aa411f16fd Add decode method to request types před 10 roky
consumer_metadata_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
consumer_metadata_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
consumer_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests před 10 roky
crc32_field.go 8fa523b125 Use an optimized crc32 library which is faster před 10 roky
encoder_decoder.go 66411d8222 Cleanup a bunch more error formats před 10 roky
errors.go 66411d8222 Cleanup a bunch more error formats před 10 roky
fetch_request.go aa411f16fd Add decode method to request types před 10 roky
fetch_request_test.go aa411f16fd Add decode method to request types před 10 roky
fetch_response.go 900e4f4595 Centralize and unify getSubset error checking před 10 roky
fetch_response_test.go 87c89f868c Also prefix KError instances with Err. před 11 roky
functional_client_test.go f0fc7e9247 Finalize most of the toxiproxy test framework před 10 roky
functional_consumer_test.go f0fc7e9247 Finalize most of the toxiproxy test framework před 10 roky
functional_offset_manager_test.go e8c3c16e1a Add a functional test for the offset manager. před 10 roky
functional_producer_test.go f0fc7e9247 Finalize most of the toxiproxy test framework před 10 roky
functional_test.go e8c3c16e1a Add a functional test for the offset manager. před 10 roky
length_field.go 66411d8222 Cleanup a bunch more error formats před 10 roky
message.go 2594b8edd6 Fix and simplify message decoding před 10 roky
message_set.go 2018fd405e Prefix error variables with Err před 11 roky
message_test.go 9675a91962 Added Gzip test. Simplified a little. před 12 roky
metadata_request.go aa411f16fd Add decode method to request types před 10 roky
metadata_request_test.go aa411f16fd Add decode method to request types před 10 roky
metadata_response.go 7f2cdf6cd2 Do not use partition cache for unknown topics. před 11 roky
metadata_response_test.go 87c89f868c Also prefix KError instances with Err. před 11 roky
mockbroker_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests před 10 roky
mockresponses_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests před 10 roky
offset_commit_request.go aa411f16fd Add decode method to request types před 10 roky
offset_commit_request_test.go aa411f16fd Add decode method to request types před 10 roky
offset_commit_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
offset_commit_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
offset_fetch_request.go aa411f16fd Add decode method to request types před 10 roky
offset_fetch_request_test.go aa411f16fd Add decode method to request types před 10 roky
offset_fetch_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
offset_fetch_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
offset_manager.go 12d29331cf A few minor suggestions from golint před 10 roky
offset_manager_test.go 5109f975f5 OffsetManager: make initial offset configurable před 10 roky
offset_request.go aa411f16fd Add decode method to request types před 10 roky
offset_request_test.go aa411f16fd Add decode method to request types před 10 roky
offset_response.go 39823e3af9 Check some errors před 11 roky
offset_response_test.go 87c89f868c Also prefix KError instances with Err. před 11 roky
packet_decoder.go 4969d24fa1 kafka->sarama před 12 roky
packet_encoder.go 2f5cf8fd16 Fixed remaining test. před 12 roky
partitioner.go 6facece8ef Wrap godoc to 80 chars, round 2 před 10 roky
partitioner_test.go faec514115 Add an example for different partitioning per topic. před 11 roky
prep_encoder.go 12d29331cf A few minor suggestions from golint před 10 roky
produce_request.go 900e4f4595 Centralize and unify getSubset error checking před 10 roky
produce_request_test.go aa411f16fd Add decode method to request types před 10 roky
produce_response.go 5509b4a29c wip před 12 roky
produce_response_test.go 87c89f868c Also prefix KError instances with Err. před 11 roky
produce_set.go 52c880384b Extract produceSet and add tests před 10 roky
produce_set_test.go ec382518ee Fix errcheck před 10 roky
real_decoder.go 12d29331cf A few minor suggestions from golint před 10 roky
real_encoder.go 12d29331cf A few minor suggestions from golint před 10 roky
request.go 66411d8222 Cleanup a bunch more error formats před 10 roky
request_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing před 10 roky
response_header.go 66411d8222 Cleanup a bunch more error formats před 10 roky
response_header_test.go 893044d278 Fix Golint errors, except for all the missing comments. před 12 roky
sarama.go 2ca3f4f970 Update and simplify doc for MaxResponseSize před 10 roky
snappy.go 0aeb8f0f95 Update snappy repo path and encoding interface před 10 roky
snappy_test.go 0aeb8f0f95 Update snappy repo path and encoding interface před 10 roky
sync_producer.go 12d29331cf A few minor suggestions from golint před 10 roky
sync_producer_test.go 7f2cdf6cd2 Do not use partition cache for unknown topics. před 11 roky
utils.go 766d1bfaac Simplify how we manage seed brokers před 11 roky

README.md

sarama

GoDoc Build Status

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

Getting started

  • API documentation and examples are available via godoc.
  • 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.

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. This means we currently officially support Go 1.4 and 1.5, and Kafka 0.8.1 and 0.8.2, although older releases are still likely to work.

Sarama follows semantic versioning and provides API stability via the gopkg.in service. You can import a version with a guaranteed stable API via http://gopkg.in/Shopify/sarama.v1. A changelog is available here.

Contributing