説明なし

drsoares 4473ba495c small refactoring suggested on the code review 6 年 前
.github 7df59f3971 Enable CLA bot 7 年 前
examples b2a5c492c3 Merge pull request #1304 from jeroenrinzema/master 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 23982ed422 Add SCRAM authentication example. 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 7 年 前
admin_test.go e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 7 年 前
client_test.go e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 2b2fccd2d2 Merge pull request #1296 from varun06/add-consumer-batchsize-metric 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 23982ed422 Add SCRAM authentication example. 7 年 前
go.sum 23982ed422 Add SCRAM authentication example. 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 4473ba495c small refactoring suggested on the code review 6 年 前
metadata_request_test.go bbdeda9fd2 Added support for Metadata Request/Response up to v5 8 年 前
metadata_response.go e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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 d1c48e31e3 Small docs indentation fix 7 年 前
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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 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