No Description

francois b1cd2562a9 chmod +x producer.sh 6 years ago
.github 88fe21e8de Fixing broken link for vet 6 years ago
examples b2a5c492c3 Merge pull request #1304 from jeroenrinzema/master 6 years ago
mocks e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
tools 9722e739a4 functional test: 6 years ago
vagrant b1cd2562a9 chmod +x producer.sh 6 years ago
.gitignore 151daaac97 Addressing feeback 6 years ago
.travis.yml e78179d050 add java producer to travis too 6 years ago
CHANGELOG.md 175ec42085 Add changelog for sarama v1.21.0 6 years ago
LICENSE 8da9fa72b8 Technically Shopify owns the repo 7 years ago
Makefile 23982ed422 Add SCRAM authentication example. 6 years ago
README.md ca31ca3c90 Fix readme with proper version support 6 years ago
Vagrantfile 609cb1c1db Use sensible heap size for JVMs in Vagrant 8 years ago
acl_bindings.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_create_request.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_create_request_test.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_create_response.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_create_response_test.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_delete_request.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_delete_request_test.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_delete_response.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_delete_response_test.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_describe_request.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_describe_request_test.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_describe_response.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_describe_response_test.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_filter.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 6 years ago
acl_types.go 483263c182 using iota for constants and some style fixes 6 years ago
add_offsets_to_txn_request.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_offsets_to_txn_request_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_offsets_to_txn_response.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_offsets_to_txn_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_partitions_to_txn_request.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_partitions_to_txn_request_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_partitions_to_txn_response.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
add_partitions_to_txn_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
admin.go 0cfd4e6fdb Merge pull request #1154 from dnwe/topic-response-errors 6 years ago
admin_test.go 0cfd4e6fdb Merge pull request #1154 from dnwe/topic-response-errors 6 years ago
alter_configs_request.go f7466ea37d Add Describe + AlterConfigs (#1014) 7 years ago
alter_configs_request_test.go 6ce9e9249a Fix flaky TestAlterConfigsRequest 7 years ago
alter_configs_response.go f7466ea37d Add Describe + AlterConfigs (#1014) 7 years ago
alter_configs_response_test.go f7466ea37d Add Describe + AlterConfigs (#1014) 7 years ago
api_versions_request.go 90a4cc632e Fix race in broker version check 8 years ago
api_versions_request_test.go c5f4248429 Add support for latest protocol messages 8 years ago
api_versions_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
api_versions_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
async_producer.go 6c354b8b3c reduce client close bookkeeping 6 years ago
async_producer_test.go 6a7bac87a0 Merge pull request #1160 from thomaslee/tom_backoff_func 6 years ago
balance_strategy.go 11eb19b893 Fix typo and comment in balance_strategy.go 6 years ago
balance_strategy_test.go 113ce2c044 Implement a higher-level consumer group 6 years ago
broker.go bb3bd3c9f0 Merge remote-tracking branch 'upstream/master' 6 years ago
broker_test.go 55578535cf Add SASL SCRAM-SHA-512 and SCRAM-SHA-256 mechanismes 6 years ago
client.go f21adde5c6 Make code style consistent in kafka client after refresh metadata 6 years ago
client_test.go a047cd70e0 Add Config.Metadata.Retry.BackoffFunc 6 years ago
client_tls_test.go 970116bc74 Support Go 1.11 6 years ago
compress.go f352e5cc8b Reuse compression writer objects 6 years ago
config.go d6fc544fdf config validation + test 6 years ago
config_resource_type.go 483263c182 using iota for constants and some style fixes 6 years ago
config_test.go 077e5d4f7b PR fixes: 6 years ago
consumer.go 98b2c4a922 Merge branch 'master' into read-committed 6 years ago
consumer_group.go 6c354b8b3c reduce client close bookkeeping 6 years ago
consumer_group_members.go 12fa6736bd fixed some typo and added some comments 6 years ago
consumer_group_members_test.go cecb3d9807 Formating all files with gofmt -s 8 years ago
consumer_group_test.go a318f6ee7d CI test fixes 6 years ago
consumer_metadata_request.go 12fa6736bd fixed some typo and added some comments 6 years ago
consumer_metadata_request_test.go a5a9b835af refactor ConsumerMetadataRequest/Response to FindCoordinatorRequest/Response 7 years ago
consumer_metadata_response.go 3006055aad simple typo fixes in consumer metadata response file 6 years ago
consumer_metadata_response_test.go e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
consumer_test.go 0432240e61 test consumer 6 years ago
control_record.go 077e5d4f7b PR fixes: 6 years ago
control_record_test.go 57215a08ac midway on consumer test 6 years ago
crc32_field.go 07a5840e2e Make polynomial a type 7 years ago
create_partitions_request.go 7957e72eca factor out getStringLength, use putArrayLength 7 years ago
create_partitions_request_test.go b3f149d4d2 add create partitions 7 years ago
create_partitions_response.go ec2cbc3814 Satisfy the error interface in create responses 6 years ago
create_partitions_response_test.go ec2cbc3814 Satisfy the error interface in create responses 6 years ago
create_topics_request.go b5ace411a0 add CreateTopicsRequest/Response 7 years ago
create_topics_request_test.go b5ace411a0 add CreateTopicsRequest/Response 7 years ago
create_topics_response.go ec2cbc3814 Satisfy the error interface in create responses 6 years ago
create_topics_response_test.go ec2cbc3814 Satisfy the error interface in create responses 6 years ago
decompress.go f352e5cc8b Reuse compression writer objects 6 years ago
delete_groups_request.go 0f1c3e9b87 Add support for DeleteGroups 7 years ago
delete_groups_request_test.go 0f1c3e9b87 Add support for DeleteGroups 7 years ago
delete_groups_response.go 7d531e2557 Use native time type for ThrottleTime 7 years ago
delete_groups_response_test.go 7d531e2557 Use native time type for ThrottleTime 7 years ago
delete_records_request.go 76a6b90ec2 Add DeleteRecords operation to Broker 7 years ago
delete_records_request_test.go 76a6b90ec2 Add DeleteRecords operation to Broker 7 years ago
delete_records_response.go 76a6b90ec2 Add DeleteRecords operation to Broker 7 years ago
delete_records_response_test.go 76a6b90ec2 Add DeleteRecords operation to Broker 7 years ago
delete_topics_request.go 796e8cc60f Added support for DeleteTopicsRequest V1 7 years ago
delete_topics_request_test.go 796e8cc60f Added support for DeleteTopicsRequest V1 7 years ago
delete_topics_response.go 620549d3ed add DeleteTopicsRequest/Response 7 years ago
delete_topics_response_test.go 620549d3ed add DeleteTopicsRequest/Response 7 years ago
describe_configs_request.go 11800fbad1 Set correct Kafka version for DescribeConfigsRequest v1 6 years ago
describe_configs_request_test.go fbd8338718 Implement DescribeConfigsRequest v1 & v2 6 years ago
describe_configs_response.go 483263c182 using iota for constants and some style fixes 6 years ago
describe_configs_response_test.go f9494b44e1 Implement DescribeConfigsResponse 1 & 2 6 years ago
describe_groups_request.go 90a4cc632e Fix race in broker version check 8 years ago
describe_groups_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
describe_groups_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
describe_groups_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
dev.yml 0cd4678d8a Add support for Golang 1.12 6 years ago
encoder_decoder.go 124e7c647e Expose producer metrics with go-metrics 8 years ago
end_txn_request.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
end_txn_request_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
end_txn_response.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
end_txn_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
errors.go 7345dd0c9d add error codes 73-76 6 years ago
fetch_request.go 483263c182 using iota for constants and some style fixes 6 years ago
fetch_request_test.go 953231c528 Add support for Kafka 0.11 in consumer 7 years ago
fetch_response.go 077e5d4f7b PR fixes: 6 years ago
fetch_response_test.go 8d1bd4c0d6 Handle overflow-only batch 6 years ago
find_coordinator_request.go 483263c182 using iota for constants and some style fixes 6 years ago
find_coordinator_request_test.go a5a9b835af refactor ConsumerMetadataRequest/Response to FindCoordinatorRequest/Response 7 years ago
find_coordinator_response.go 5a23d49f7a remove rack from FindCoordinatorResponse and hardcode Broker-decode/encode version to 0 7 years ago
find_coordinator_response_test.go e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
functional_client_test.go e931cc00ed Stop test if client.Coordinator fails somehow 8 years ago
functional_consumer_group_test.go a318f6ee7d CI test fixes 6 years ago
functional_consumer_test.go 9722e739a4 functional test: 6 years ago
functional_offset_manager_test.go ccab789d44 OffsetManager: match upstream mark/next behaviour 8 years ago
functional_producer_test.go 7b655373d8 Expose request latency metric 8 years ago
functional_test.go 2c40df751c Fix version.satisfies so all tests run against 0.9 9 years ago
go.mod 98b2c4a922 Merge branch 'master' into read-committed 6 years ago
go.sum e78179d050 add java producer to travis too 6 years ago
heartbeat_request.go 90a4cc632e Fix race in broker version check 8 years ago
heartbeat_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
heartbeat_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
heartbeat_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
init_producer_id_request.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
init_producer_id_request_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
init_producer_id_response.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
init_producer_id_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
join_group_request.go e1b85f3400 Added versioning for join-group requests and responses 7 years ago
join_group_request_test.go e1b85f3400 Added versioning for join-group requests and responses 7 years ago
join_group_response.go e1b85f3400 Added versioning for join-group requests and responses 7 years ago
join_group_response_test.go e1b85f3400 Added versioning for join-group requests and responses 7 years ago
leave_group_request.go 90a4cc632e Fix race in broker version check 8 years ago
leave_group_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
leave_group_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
leave_group_response_test.go e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
length_field.go 682468dcc7 Fix partial messages handling 6 years ago
list_groups_request.go 90a4cc632e Fix race in broker version check 8 years ago
list_groups_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
list_groups_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
list_groups_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
message.go 483263c182 using iota for constants and some style fixes 6 years ago
message_set.go 8d1bd4c0d6 Handle overflow-only batch 6 years ago
message_test.go 7d77064a4d Revert "Add workaround for an empty zstd message" 6 years ago
metadata_request.go 46821574be Fix metadata requests on later versions 6 years ago
metadata_request_test.go bbdeda9fd2 Added support for Metadata Request/Response up to v5 7 years ago
metadata_response.go b4a8a4a8f6 add missing error check 6 years ago
metadata_response_test.go e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
metrics.go 82be3b4da9 Unregister all broker metrics on broker stop 6 years ago
metrics_test.go 124e7c647e Expose producer metrics with go-metrics 8 years ago
mockbroker.go f933fb4b0b Add NewMockBrokerListener() so that it's possible to test TLS connections 7 years ago
mockresponses.go 0cfd4e6fdb Merge pull request #1154 from dnwe/topic-response-errors 6 years ago
offset_commit_request.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_commit_request_test.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_commit_response.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_commit_response_test.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_fetch_request.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_fetch_request_test.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_fetch_response.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_fetch_response_test.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_manager.go 0fab210f8c remove go keyword from channel close in singleton 6 years ago
offset_manager_test.go a047cd70e0 Add Config.Metadata.Retry.BackoffFunc 6 years ago
offset_request.go 374f0e3cd0 Use a boolean to check that replica ID was set 6 years ago
offset_request_test.go 8869e903fa Add a getter for replica ID 6 years ago
offset_response.go e42dc76c4e Add missing Kafka versions 7 years ago
offset_response_test.go d65b3fd46b Support ListOffsetRequest v1 [KIP-79] 8 years ago
packet_decoder.go b3f149d4d2 add create partitions 7 years ago
packet_encoder.go b3f149d4d2 add create partitions 7 years ago
partitioner.go a74fb772b5 update name of partitioner option so it makes more sense 6 years ago
partitioner_test.go 9b2c4d6e2c Make Partitioner.RequiresConsistency vary per-message 6 years ago
prep_encoder.go b3f149d4d2 add create partitions 7 years ago
produce_request.go 5468405d94 Expose Records union fields 7 years ago
produce_request_test.go 7ad9a62d7d Fix TestProduceRequest 7 years ago
produce_response.go 8e2b04b363 Added support for Idempotent Producer 6 years ago
produce_response_test.go e6c029ff1a Revert "Synced error names and descriptions with the kafka's protocol" 6 years ago
produce_set.go 4c93f1f002 Merge pull request #1141 from adwinsky/fix-overflow-max-message-bytes-limit 6 years ago
produce_set_test.go 4c93f1f002 Merge pull request #1141 from adwinsky/fix-overflow-max-message-bytes-limit 6 years ago
real_decoder.go 7957e72eca factor out getStringLength, use putArrayLength 7 years ago
real_encoder.go b3f149d4d2 add create partitions 7 years ago
record.go b68420a29b control record + isTransactional bit parsing 6 years ago
record_batch.go 10d673ff22 copied transaction logic from java client 6 years ago
record_test.go 780ea152be Fix gzip compression encode/decode test 7 years ago
records.go 0432240e61 test consumer 6 years ago
records_test.go 6b86562f5c ut transactional flag 6 years ago
request.go 3cda1801ab fixed a bug related to error return 6 years ago
request_test.go f4fbc32080 Simple validation of required version 7 years ago
response_header.go 55578535cf Add SASL SCRAM-SHA-512 and SCRAM-SHA-256 mechanismes 6 years ago
response_header_test.go 893044d278 Fix Golint errors, except for all the missing comments. 11 years ago
sarama.go 483263c182 using iota for constants and some style fixes 6 years ago
sasl_authenticate_request.go 56ffac20e5 Clean up error handling 6 years ago
sasl_authenticate_request_test.go daa6ff523d Fix SaslAuthenticateRequest 6 years ago
sasl_authenticate_response.go 56ffac20e5 Clean up error handling 6 years ago
sasl_authenticate_response_test.go dc6025a247 Increase test coverage 6 years ago
sasl_handshake_request.go f5b3e0ed01 Implement SASL/OAUTHBEARER support 6 years ago
sasl_handshake_request_test.go c5f4248429 Add support for latest protocol messages 8 years ago
sasl_handshake_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
sasl_handshake_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
sync_group_request.go 124e7c647e Expose producer metrics with go-metrics 8 years ago
sync_group_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
sync_group_response.go fdebee00c4 Following Golint tips for if blocks who ends with a return 8 years ago
sync_group_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
sync_producer.go 1e2740380a Do not modify ProducerMessage.MetaData during the whole publishing process. 6 years ago
sync_producer_test.go 459e548c02 simplified code for abandoned connection check, attempt to fix racy sync producer test 6 years ago
timestamp.go ed80c61d79 Make timestamp fields of type time.Time and time.Duration 7 years ago
txn_offset_commit_request.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
txn_offset_commit_request_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
txn_offset_commit_response.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
txn_offset_commit_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
utils.go 483263c182 using iota for constants and some style fixes 6 years ago
utils_test.go a709f2d5ca String functions for KafkaVersion (#989) 7 years ago
zstd_cgo.go 3dd2f63504 Fix build without cgo 6 years ago
zstd_fallback.go 3dd2f63504 Fix build without cgo 6 years ago

README.md

sarama

GoDoc Build Status Coverage

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.

You might also want to look at the Frequently Asked Questions.

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.10 through 1.12, and Kafka 2.0 through 2.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