mirror of https://github.com/tidwall/tile38.git
37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
|
sarama
|
||
|
|
======
|
||
|
|
|
||
|
|
[](https://godoc.org/github.com/Shopify/sarama)
|
||
|
|
[](https://travis-ci.org/Shopify/sarama)
|
||
|
|
|
||
|
|
Sarama is an MIT-licensed Go client library for [Apache Kafka](https://kafka.apache.org/) version 0.8 (and later).
|
||
|
|
|
||
|
|
### Getting started
|
||
|
|
|
||
|
|
- API documentation and examples are available via [godoc](https://godoc.org/github.com/Shopify/sarama).
|
||
|
|
- Mocks for testing are available in the [mocks](./mocks) subpackage.
|
||
|
|
- The [examples](./examples) directory contains more elaborate example applications.
|
||
|
|
- The [tools](./tools) directory contains command line tools that can be useful for testing, diagnostics, and instrumentation.
|
||
|
|
|
||
|
|
### 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.7 and 1.6, and Kafka 0.10.0 and 0.9.0, 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](CHANGELOG.md).
|
||
|
|
|
||
|
|
### Contributing
|
||
|
|
|
||
|
|
* Get started by checking our [contribution guidelines](https://github.com/Shopify/sarama/blob/master/.github/CONTRIBUTING.md).
|
||
|
|
* Read the [Sarama wiki](https://github.com/Shopify/sarama/wiki) for more
|
||
|
|
technical and design details.
|
||
|
|
* The [Kafka Protocol Specification](https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol)
|
||
|
|
contains a wealth of useful information.
|
||
|
|
* For more general issues, there is [a google group](https://groups.google.com/forum/#!forum/kafka-clients) for Kafka client developers.
|
||
|
|
* If you have any questions, just ask!
|