بدون توضیح

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

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