No Description

Lourens Naudé ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
.github ad70aac2ad Merge pull request #1695 from zendesk/ktsanaktsidis/docker_compose_tests 4 years ago
examples 31886822ab Fix typos 4 years ago
mocks 88b0e98974 removes unused fields/methods 4 years ago
tools 31886822ab Fix typos 4 years ago
vagrant 42bbd066c0 Delete vagrant test harness setup 4 years ago
.gitignore f33a0afab2 Add docker-composed based functional test harness 4 years ago
.golangci.yml db2dbead92 Update golangci-lint to v1.27.0 4 years ago
CHANGELOG.md 5f7121b03e Add changelog for 1.26.1 4 years ago
LICENSE 8da9fa72b8 Technically Shopify owns the repo 6 years ago
Makefile d8f6eca924 Run the linter across functional tests as well 4 years ago
README.md 535a77dcfe Update supported kafka versions in README 4 years ago
Vagrantfile b8c5f7cfe1 Add GitHub Actions workflows, use golangci-lint 4 years ago
acl_bindings.go 29d30a3c4c Refactor misspelled word Resouce to Resource 5 years ago
acl_create_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
acl_create_request_test.go 29d30a3c4c Refactor misspelled word Resouce to Resource 5 years ago
acl_create_response.go 31886822ab Fix typos 4 years ago
acl_create_response_test.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_delete_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
acl_delete_request_test.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 5 years ago
acl_delete_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
acl_delete_response_test.go 86d6f390cf add Describe/Create/DeleteAcls 7 years ago
acl_describe_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
acl_describe_request_test.go 66abce6c25 Implements v1 of {Create,Describe,Delete}AclRequest 5 years ago
acl_describe_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 5 years ago
acl_types.go 483263c182 using iota for constants and some style fixes 5 years ago
add_offsets_to_txn_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
add_partitions_to_txn_request_test.go 07ff436a6d Fix linter errors 4 years ago
add_partitions_to_txn_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
add_partitions_to_txn_response_test.go 07ff436a6d Fix linter errors 4 years ago
admin.go 9c1c364bbc Merge pull request #1639 from agriffaut/patch/handle-errors-without-message 4 years ago
admin_test.go 9c1c364bbc Merge pull request #1639 from agriffaut/patch/handle-errors-without-message 4 years ago
alter_configs_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
alter_configs_request_test.go 07ff436a6d Fix linter errors 4 years ago
alter_configs_response.go 31886822ab Fix typos 4 years ago
alter_configs_response_test.go 07ff436a6d Fix linter errors 4 years ago
alter_partition_reassignments_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
alter_partition_reassignments_request_test.go 31886822ab Fix typos 4 years ago
alter_partition_reassignments_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
alter_partition_reassignments_response_test.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
api_versions_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
api_versions_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
api_versions_response.go 31886822ab Fix typos 4 years ago
api_versions_response_test.go 574371b50a removes var when assigning a value immediately 4 years ago
async_producer.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
async_producer_test.go 9df3038ad4 Fix "broker received out of order sequence" when brokers die 4 years ago
balance_strategy.go 88b0e98974 removes unused fields/methods 4 years ago
balance_strategy_test.go f6fb4afcdd simple compare statement 4 years ago
broker.go 5ff9581b10 more go like code, returning earlier 4 years ago
broker_test.go c6eb1d42e7 fix: Allow TLS to work over socks proxy. (#1666) 4 years ago
client.go 26bbb0417c bugfix: remove broker which is not exist in metadata 4 years ago
client_test.go 31886822ab Fix typos 4 years ago
client_tls_test.go 1628dc1dbf use net.SplitHostPort and don't separate conf var 4 years ago
compress.go c6ac2d9ca8 Revert "refresh 3rdparty dependencies" 4 years ago
config.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
config_resource_type.go fb8b9b5a10 fix: use the broker for any admin on BrokerConfig 5 years ago
config_test.go 159fd52ba1 rm validation and the corresponding test 4 years ago
consumer.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
consumer_group.go cb9d1e8b85 Add support for manual commit to ConsumerGroup 4 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 7 years ago
consumer_group_test.go 8b72385c90 adds a note about consumer groups Consume method 4 years ago
consumer_metadata_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
consumer_metadata_request_test.go a5a9b835af refactor ConsumerMetadataRequest/Response to FindCoordinatorRequest/Response 7 years ago
consumer_metadata_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 6159078aac Merge pull request #1644 from zendesk/ktsanaktsidis/fix_session_id_thrashing 4 years ago
control_record.go 3328055d57 another pull request to please lint gods 5 years ago
control_record_test.go 57215a08ac midway on consumer test 5 years ago
crc32_field.go 47ae433aa8 Reuse lengthFields 5 years ago
create_partitions_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
create_partitions_request_test.go 07ff436a6d Fix linter errors 4 years ago
create_partitions_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
create_partitions_response_test.go 07ff436a6d Fix linter errors 4 years ago
create_topics_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
create_topics_request_test.go 07ff436a6d Fix linter errors 4 years ago
create_topics_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
create_topics_response_test.go 07ff436a6d Fix linter errors 4 years ago
decompress.go c6ac2d9ca8 Revert "refresh 3rdparty dependencies" 4 years ago
delete_groups_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_groups_request_test.go 0f1c3e9b87 Add support for DeleteGroups 6 years ago
delete_groups_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_groups_response_test.go 7d531e2557 Use native time type for ThrottleTime 6 years ago
delete_records_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_records_request_test.go 76a6b90ec2 Add DeleteRecords operation to Broker 6 years ago
delete_records_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_records_response_test.go 76a6b90ec2 Add DeleteRecords operation to Broker 6 years ago
delete_topics_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_topics_request_test.go 796e8cc60f Added support for DeleteTopicsRequest V1 6 years ago
delete_topics_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
delete_topics_response_test.go 620549d3ed add DeleteTopicsRequest/Response 7 years ago
describe_configs_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
describe_configs_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
describe_configs_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
describe_configs_response_test.go 6d92277014 Sets ConfigEntry.Default flag in addition to the ConfigEntry.Source for Kafka versions > V1_1_0_0 (#1594) 4 years ago
describe_groups_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
describe_groups_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
describe_groups_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
describe_groups_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
describe_log_dirs_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
describe_log_dirs_request_test.go 07ff436a6d Fix linter errors 4 years ago
describe_log_dirs_response.go d89fa9dc14 Add DescribeLogDirs to admin client 4 years ago
describe_log_dirs_response_test.go 07ff436a6d Fix linter errors 4 years ago
deserializer.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
dev.yml 97156e8036 Bump Go to version 1.14.3 4 years ago
docker-compose.yml 75ff946b52 Map confluent platform -> kafka version 4 years ago
encoder_decoder.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
end_txn_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
end_txn_response_test.go d81319704e add transaction-related request/responses (22, 24, 25, 26, 28) 7 years ago
errors.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
fetch_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
fetch_request_test.go 48ba0ca84f feat: protocol support for V11 fetch w/ rackID 4 years ago
fetch_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
fetch_response_test.go 48ba0ca84f feat: protocol support for V11 fetch w/ rackID 4 years ago
find_coordinator_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
find_coordinator_request_test.go a5a9b835af refactor ConsumerMetadataRequest/Response to FindCoordinatorRequest/Response 7 years ago
find_coordinator_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 f33a0afab2 Add docker-composed based functional test harness 4 years ago
functional_consumer_group_test.go f33a0afab2 Add docker-composed based functional test harness 4 years ago
functional_consumer_test.go f33a0afab2 Add docker-composed based functional test harness 4 years ago
functional_offset_manager_test.go f33a0afab2 Add docker-composed based functional test harness 4 years ago
functional_producer_test.go ad70aac2ad Merge pull request #1695 from zendesk/ktsanaktsidis/docker_compose_tests 4 years ago
functional_test.go cfd5999fa1 Remove redundant hard-coding of env.KafkaVersion 4 years ago
go.mod 5933302b8b updated zstd dependency to latest (#1741) 4 years ago
go.sum 5933302b8b updated zstd dependency to latest (#1741) 4 years ago
gssapi_kerberos.go b5764af1c4 Merge pull request #1697 from kvch/revert-removing-for-of-asn1 4 years ago
heartbeat_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
heartbeat_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
heartbeat_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
heartbeat_response_test.go 574371b50a removes var when assigning a value immediately 4 years ago
init_producer_id_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
join_group_request_test.go e1b85f3400 Added versioning for join-group requests and responses 6 years ago
join_group_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
join_group_response_test.go e1b85f3400 Added versioning for join-group requests and responses 6 years ago
kerberos_client.go dd2a9df207 Formar NewKerberosClient comments acording to golang standad, added test for DisablePAFXFast 4 years ago
kerberos_client_test.go dd2a9df207 Formar NewKerberosClient comments acording to golang standad, added test for DisablePAFXFast 4 years ago
leave_group_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
leave_group_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
leave_group_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 47ae433aa8 Reuse lengthFields 5 years ago
list_groups_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
list_groups_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
list_groups_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
list_groups_response_test.go 37654da7e1 Add support for decoding versioned responses 8 years ago
list_partition_reassignments_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
list_partition_reassignments_request_test.go 31886822ab Fix typos 4 years ago
list_partition_reassignments_response.go 89f6240301 fix decoding response with empty topic list 4 years ago
list_partition_reassignments_response_test.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
message.go 07ff436a6d Fix linter errors 4 years ago
message_set.go 47ae433aa8 Reuse lengthFields 5 years ago
message_test.go 7d77064a4d Revert "Add workaround for an empty zstd message" 6 years ago
metadata_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
metadata_request_test.go ac7342c248 fix tests 4 years ago
metadata_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 2db8d8aea2 Add requests-in-flight metric 4 years ago
mockbroker.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
mockkerberos.go c6ac2d9ca8 Revert "refresh 3rdparty dependencies" 4 years ago
mockresponses.go 9c1c364bbc Merge pull request #1639 from agriffaut/patch/handle-errors-without-message 4 years ago
offset_commit_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_commit_request_test.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_commit_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_commit_response_test.go 3f16fb0e7a Add support for newer OffsetCommit request/response 6 years ago
offset_fetch_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_fetch_request_test.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_fetch_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_fetch_response_test.go 6c7918ef5a Added OffsetFetch support up to v5 6 years ago
offset_manager.go cb9d1e8b85 Add support for manual commit to ConsumerGroup 4 years ago
offset_manager_test.go cb9d1e8b85 Add support for manual commit to ConsumerGroup 4 years ago
offset_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_request_test.go 8869e903fa Add a getter for replica ID 6 years ago
offset_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
offset_response_test.go d65b3fd46b Support ListOffsetRequest v1 [KIP-79] 8 years ago
packet_decoder.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
packet_encoder.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
produce_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
produce_request_test.go 7ad9a62d7d Fix TestProduceRequest 6 years ago
produce_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
produce_response_test.go 37faed7ffc enables zstd bumping the right things 4 years ago
produce_set.go 9df3038ad4 Fix "broker received out of order sequence" when brokers die 4 years ago
produce_set_test.go 07ff436a6d Fix linter errors 4 years ago
real_decoder.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
real_encoder.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
record.go b68420a29b control record + isTransactional bit parsing 5 years ago
record_batch.go 47ae433aa8 Reuse lengthFields 5 years ago
record_test.go 31886822ab Fix typos 4 years ago
records.go 88b0e98974 removes unused fields/methods 4 years ago
records_test.go 6b86562f5c ut transactional flag 5 years ago
request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
request_test.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
response_header.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
response_header_test.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sarama.go 2db8d8aea2 Add requests-in-flight metric 4 years ago
sasl_authenticate_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sasl_authenticate_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
sasl_authenticate_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sasl_authenticate_response_test.go 31886822ab Fix typos 4 years ago
sasl_handshake_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sasl_handshake_request_test.go 574371b50a removes var when assigning a value immediately 4 years ago
sasl_handshake_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sasl_handshake_response_test.go 574371b50a removes var when assigning a value immediately 4 years ago
serde.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
serializer.go ab2cd98eff Initial pass at a basic SerDe implementation 4 years ago
sticky_assignor_user_data.go 01915cf82e Add sticky partition assignor 5 years ago
sticky_assignor_user_data_test.go 01915cf82e Add sticky partition assignor 5 years ago
sync_group_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
sync_group_request_test.go 1621c4959a Add tests for all new request types. 9 years ago
sync_group_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 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 e3ecf7b088 added offline replicas operation to client for kafka version >= 1.x 5 years ago
timestamp.go ed80c61d79 Make timestamp fields of type time.Time and time.Duration 7 years ago
txn_offset_commit_request.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
txn_offset_commit_request_test.go 07ff436a6d Fix linter errors 4 years ago
txn_offset_commit_response.go 2d2326efcf feat: Add alter and list partition reassignments 4 years ago
txn_offset_commit_response_test.go 07ff436a6d Fix linter errors 4 years ago
utils.go 98976f5904 Add support for kafka 2.5.0 4 years ago
utils_test.go a709f2d5ca String functions for KafkaVersion (#989) 7 years ago
zstd.go 8a56b725ac enables goimports lint 4 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.12 through 1.14, and Kafka 2.3 through 2.5, 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