Keine Beschreibung

Evan Huus f13498ffc9 tweak docs vor 10 Jahren
examples af448a6f24 Fix names as a_name to be aName vor 10 Jahren
mocks 03d03b3c61 Minor lint changes vor 10 Jahren
tools 9008214b35 Rename topicConsumer tool to just consumer vor 10 Jahren
vagrant b841795c04 Add kafka 0.9 vor 10 Jahren
.gitignore d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster. vor 11 Jahren
.travis.yml 5dfbdd353d Bump CI from 1.5.1 to 1.5.2 vor 10 Jahren
CHANGELOG.md 87ec8d76e8 Prep for 1.7 vor 10 Jahren
CONTRIBUTING.md 6aacbb7d86 Some additions vor 11 Jahren
MIT-LICENSE 86b4691cdd Add license information vor 12 Jahren
Makefile 44d2339061 Put a 60s limit on the test suite vor 10 Jahren
README.md 7cdfc5b3e0 Replace 'other' with 'contributing' and make it more friendly vor 10 Jahren
Vagrantfile f3aa1b53de Upgrade vagrant from precise to trusty vor 10 Jahren
async_producer.go b8b4670075 Merge pull request #562 from Shopify/producer-syn-fin vor 10 Jahren
async_producer_test.go 733c74f30d Refactor the producer, part 2 vor 10 Jahren
broker.go b51603af22 Make dead brokers die harder vor 10 Jahren
broker_test.go 39f6444f59 Don't return from example functions vor 10 Jahren
client.go 12d29331cf A few minor suggestions from golint vor 10 Jahren
client_test.go 1874f69e22 Shuffle seed brokers so we don't always connect to the first one provided vor 10 Jahren
config.go 6facece8ef Wrap godoc to 80 chars, round 2 vor 10 Jahren
config_test.go 616ac5daa4 Unify configuration structures into config.go vor 11 Jahren
consumer.go 6facece8ef Wrap godoc to 80 chars, round 2 vor 10 Jahren
consumer_metadata_request.go aa411f16fd Add decode method to request types vor 10 Jahren
consumer_metadata_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
consumer_metadata_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
consumer_metadata_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
consumer_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests vor 10 Jahren
crc32_field.go 8fa523b125 Use an optimized crc32 library which is faster vor 10 Jahren
describe_groups_request.go 7611ea6ab0 Add DescribeGroup request and response pair. vor 10 Jahren
describe_groups_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
describe_groups_response.go 7611ea6ab0 Add DescribeGroup request and response pair. vor 10 Jahren
describe_groups_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
encoder_decoder.go 66411d8222 Cleanup a bunch more error formats vor 10 Jahren
errors.go 2bac783afa Add new protocol errors with their respective messages. vor 10 Jahren
fetch_request.go aa411f16fd Add decode method to request types vor 10 Jahren
fetch_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
fetch_response.go 900e4f4595 Centralize and unify getSubset error checking vor 10 Jahren
fetch_response_test.go 87c89f868c Also prefix KError instances with Err. vor 11 Jahren
functional_client_test.go f0fc7e9247 Finalize most of the toxiproxy test framework vor 10 Jahren
functional_consumer_test.go f0fc7e9247 Finalize most of the toxiproxy test framework vor 10 Jahren
functional_offset_manager_test.go 1e5cc31d7c Fix offset_manager for Kafka 0.9.0.0 vor 10 Jahren
functional_producer_test.go f0fc7e9247 Finalize most of the toxiproxy test framework vor 10 Jahren
functional_test.go 2c40df751c Fix version.satisfies so all tests run against 0.9 vor 10 Jahren
heartbeat_request.go b1d40bdba9 Add Heartbeat request and response pair. vor 10 Jahren
heartbeat_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
heartbeat_response.go b1d40bdba9 Add Heartbeat request and response pair. vor 10 Jahren
heartbeat_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
join_group_request.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
join_group_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
join_group_response.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
join_group_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
leave_group_request.go ccec1aae54 Add LeaveGroup request and response pair. vor 10 Jahren
leave_group_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
leave_group_response.go ccec1aae54 Add LeaveGroup request and response pair. vor 10 Jahren
leave_group_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
length_field.go 66411d8222 Cleanup a bunch more error formats vor 10 Jahren
list_groups_request.go 037310ad5d Add ListGroups request and response pair. vor 10 Jahren
list_groups_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
list_groups_response.go 037310ad5d Add ListGroups request and response pair. vor 10 Jahren
list_groups_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
message.go 2594b8edd6 Fix and simplify message decoding vor 10 Jahren
message_set.go 2018fd405e Prefix error variables with Err vor 11 Jahren
message_test.go 9675a91962 Added Gzip test. Simplified a little. vor 12 Jahren
metadata_request.go aa411f16fd Add decode method to request types vor 10 Jahren
metadata_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
metadata_response.go 7f2cdf6cd2 Do not use partition cache for unknown topics. vor 11 Jahren
metadata_response_test.go 87c89f868c Also prefix KError instances with Err. vor 11 Jahren
mockbroker_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests vor 10 Jahren
mockresponses_test.go 99f4fd70a5 Introduce mockSequence and further simplify tests vor 10 Jahren
offset_commit_request.go f13498ffc9 tweak docs vor 10 Jahren
offset_commit_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
offset_commit_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
offset_commit_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
offset_fetch_request.go aa411f16fd Add decode method to request types vor 10 Jahren
offset_fetch_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
offset_fetch_response.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
offset_fetch_response_test.go 9b6ac1a0fe Add mock responses for OffsetManager testing vor 10 Jahren
offset_manager.go 48e29ec594 Publish GroupGenerationUndefined constant vor 10 Jahren
offset_manager_test.go 5109f975f5 OffsetManager: make initial offset configurable vor 10 Jahren
offset_request.go aa411f16fd Add decode method to request types vor 10 Jahren
offset_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
offset_response.go 39823e3af9 Check some errors vor 11 Jahren
offset_response_test.go 87c89f868c Also prefix KError instances with Err. vor 11 Jahren
packet_decoder.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
packet_encoder.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
partitioner.go 6facece8ef Wrap godoc to 80 chars, round 2 vor 10 Jahren
partitioner_test.go faec514115 Add an example for different partitioning per topic. vor 11 Jahren
prep_encoder.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
produce_request.go 900e4f4595 Centralize and unify getSubset error checking vor 10 Jahren
produce_request_test.go aa411f16fd Add decode method to request types vor 10 Jahren
produce_response.go 5509b4a29c wip vor 12 Jahren
produce_response_test.go 87c89f868c Also prefix KError instances with Err. vor 11 Jahren
produce_set.go 52c880384b Extract produceSet and add tests vor 10 Jahren
produce_set_test.go ec382518ee Fix errcheck vor 10 Jahren
real_decoder.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
real_encoder.go 1badb8e8c4 Add JoinGroup request and response pair. vor 10 Jahren
request.go a050648142 Register new request type keys in request.go vor 10 Jahren
request_test.go 9dbdf89484 Better assertion failure messages from request_test. vor 10 Jahren
response_header.go 66411d8222 Cleanup a bunch more error formats vor 10 Jahren
response_header_test.go 893044d278 Fix Golint errors, except for all the missing comments. vor 12 Jahren
sarama.go 2ca3f4f970 Update and simplify doc for MaxResponseSize vor 10 Jahren
snappy.go 0aeb8f0f95 Update snappy repo path and encoding interface vor 10 Jahren
snappy_test.go 03d03b3c61 Minor lint changes vor 10 Jahren
sync_group_request.go 0d36de60f2 Add SyncGroup request and response pair. vor 10 Jahren
sync_group_request_test.go 1621c4959a Add tests for all new request types. vor 10 Jahren
sync_group_response.go 0d36de60f2 Add SyncGroup request and response pair. vor 10 Jahren
sync_group_response_test.go 756801dfa2 Add tests for all new response types vor 10 Jahren
sync_producer.go 12d29331cf A few minor suggestions from golint vor 10 Jahren
sync_producer_test.go 7f2cdf6cd2 Do not use partition cache for unknown topics. vor 11 Jahren
utils.go 766d1bfaac Simplify how we manage seed brokers vor 11 Jahren

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