Sin descripción

12 Ramas

Evan Huus db6a85dc6b Merge pull request #481 from Shopify/producer-structs		hace 10 años
examples	9fd83b3752 Fix a few README typos	hace 11 años
mocks	5f78d90083 Add high water mark offset support to the consumer.	hace 10 años
tools	9008214b35 Rename topicConsumer tool to just consumer	hace 10 años
vagrant	08601f68eb Tweak where and how we wait for kafka to boot	hace 10 años
.gitignore	d3bc825c36 Add Vagrantfile, and provisioning scripts that set up a working 5-node cluster.	hace 11 años
.travis.yml	1cb275416d Tweak travis config	hace 10 años
CHANGELOG.md	d546818f24 Update changelog, prep for 1.4.2	hace 10 años
CONTRIBUTING.md	6aacbb7d86 Some additions	hace 11 años
MIT-LICENSE	86b4691cdd Add license information	hace 12 años
Makefile	d482af099e Connect to toxiproxy in functional tests	hace 11 años
README.md	3e02f29af4 Update READMEs	hace 11 años
Vagrantfile	cf5665ab9a Increase memory with vagrant virtualbox	hace 11 años
async_producer.go	071d28e684 Refactor producer goroutines somewhat	hace 10 años
async_producer_test.go	b21ab845b5 Add a custom-partitioner test	hace 10 años
broker.go	f33811b058 Refactor metadata retro logic and imrove logging.	hace 10 años
broker_test.go	0abdf8c4f0 Move the clientID into the config object	hace 11 años
client.go	e493c2606a Update godoc for Client.Coordinator and Client.RefreshCoordinator	hace 10 años
client_test.go	1874f69e22 Shuffle seed brokers so we don't always connect to the first one provided	hace 10 años
config.go	449c713de0 Adding equals sign to the invalid config message	hace 11 años
config_test.go	616ac5daa4 Unify configuration structures into config.go	hace 11 años
consumer.go	7c4fa7452a Document consumergroup repo location	hace 10 años
consumer_metadata_request.go	9520ed2cbd Implement consumer metadata request/response pair	hace 11 años
consumer_metadata_request_test.go	9520ed2cbd Implement consumer metadata request/response pair	hace 11 años
consumer_metadata_response.go	95649f54ca Add Client.Coordinator(topic) and Client.RefreshCoordinator(topic) to retrieve the coordinating broker for a consumer group.	hace 10 años
consumer_metadata_response_test.go	5d12edf304 Add a test	hace 10 años
consumer_test.go	aff914983c Add a missing offset check to a test	hace 10 años
crc32_field.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	hace 11 años
encoder_decoder.go	f35cfe20d9 Make MaxRequestSize signed for consistency with MaxResponseSize	hace 11 años
errors.go	3aab8e4fdd tweak some errors	hace 11 años
fetch_request.go	893044d278 Fix Golint errors, except for all the missing comments.	hace 12 años
fetch_request_test.go	4969d24fa1 kafka->sarama	hace 12 años
fetch_response.go	75c8106b0b Preparatory steps for the new consumer	hace 11 años
fetch_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
functional_client_test.go	f0fc7e9247 Finalize most of the toxiproxy test framework	hace 10 años
functional_consumer_test.go	f0fc7e9247 Finalize most of the toxiproxy test framework	hace 10 años
functional_producer_test.go	f0fc7e9247 Finalize most of the toxiproxy test framework	hace 10 años
functional_test.go	f0fc7e9247 Finalize most of the toxiproxy test framework	hace 10 años
length_field.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	hace 11 años
message.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	hace 11 años
message_set.go	2018fd405e Prefix error variables with Err	hace 11 años
message_test.go	9675a91962 Added Gzip test. Simplified a little.	hace 12 años
metadata_request.go	4969d24fa1 kafka->sarama	hace 12 años
metadata_request_test.go	4969d24fa1 kafka->sarama	hace 12 años
metadata_response.go	7f2cdf6cd2 Do not use partition cache for unknown topics.	hace 11 años
metadata_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
mockbroker_test.go	83721053d3 Fix TestConsumerBounceWithReferenceOpen	hace 10 años
offset_commit_request.go	f3c86b0317 The wiki of the offset API has been updated again	hace 11 años
offset_commit_request_test.go	e6dbbebb8e Refactor offset commit request tests so they don't cause warnings	hace 10 años
offset_commit_response.go	aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1	hace 12 años
offset_commit_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
offset_fetch_request.go	f3c86b0317 The wiki of the offset API has been updated again	hace 11 años
offset_fetch_request_test.go	4969d24fa1 kafka->sarama	hace 12 años
offset_fetch_response.go	aa133ab822 Fix offset commit/fetch compatibility with kafka 0.8.1	hace 12 años
offset_fetch_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
offset_request.go	a9d8315553 Remove OffsetTime in lieu of int64.	hace 11 años
offset_request_test.go	4969d24fa1 kafka->sarama	hace 12 años
offset_response.go	39823e3af9 Check some errors	hace 11 años
offset_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
packet_decoder.go	4969d24fa1 kafka->sarama	hace 12 años
packet_encoder.go	2f5cf8fd16 Fixed remaining test.	hace 12 años
partitioner.go	1101246f70 Pass the topic to the partitioner constructor	hace 11 años
partitioner_test.go	faec514115 Add an example for different partitioning per topic.	hace 11 años
prep_encoder.go	37fcac52fd Hardcode integer sizes	hace 10 años
produce_request.go	0d17c78f48 producer: add warning about RequiredAcks>1	hace 11 años
produce_request_test.go	2bae192c12 Use time.Duration values consistently in *Config types.	hace 11 años
produce_response.go	5509b4a29c wip	hace 12 años
produce_response_test.go	87c89f868c Also prefix KError instances with Err.	hace 11 años
real_decoder.go	37fcac52fd Hardcode integer sizes	hace 10 años
real_encoder.go	37fcac52fd Hardcode integer sizes	hace 10 años
request.go	893044d278 Fix Golint errors, except for all the missing comments.	hace 12 años
request_test.go	893044d278 Fix Golint errors, except for all the missing comments.	hace 12 años
response_header.go	566627d2ad Make PacketEncodingError and PacketDecodingError more similar to each other.	hace 11 años
response_header_test.go	893044d278 Fix Golint errors, except for all the missing comments.	hace 12 años
sarama.go	2ca3f4f970 Update and simplify doc for MaxResponseSize	hace 10 años
snappy.go	6d47b6cfde fix code.google.com/p/snappy-go/snappy to github.com/golang/snappy	hace 10 años
snappy_test.go	b5df04ed3e Make snappy functions private	hace 11 años
sync_producer.go	6be486f900 Only mention closing the Client on the FromClient constructors	hace 11 años
sync_producer_test.go	7f2cdf6cd2 Do not use partition cache for unknown topics.	hace 11 años
utils.go	766d1bfaac Simplify how we manage seed brokers	hace 11 años

sarama

Sarama is an MIT-licensed Go client library for Apache Kafka 0.8 (and later).

Getting started

API documentation and example are available via godoc at https://godoc.org/github.com/Shopify/sarama.
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.
There is a google group for Kafka client users and authors at https://groups.google.com/forum/#!forum/kafka-clients

Compatibility and API stability

Sarama provides a "2 releases + 2 months" compatibility guarantee: we support the two latest releases of Kafka and Go, and we provide a two month grace period for older releases. This means we currently officially support Go 1.3 and 1.4, and Kafka 0.8.1 and 0.8.2.

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.

Other

Sarama wiki to get started hacking on sarama itself.
Kafka Project Home
Kafka Protocol Specification

README.md

sarama

Getting started

Compatibility and API stability

Other