Clojure kafka-client clojure-library
Need help with jackdaw?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
FundingCircle

Description

A Clojure library for the Apache Kafka distributed streaming platform.

243 Stars 52 Forks BSD 3-Clause "New" or "Revised" License 1.2K Commits 67 Opened issues

Services available

Need anything else?

Jackdaw · Clojars Project Code Coverage cljdoc badge CircleCI

Jackdaw is a Clojure library for the Apache Kafka distributed streaming platform. With Jackdaw, you can create and list topics using the AdminClient API, produce and consume records using the Producer and Consumer APIs, and create stream processing applications using the Streams API. Jackdaw also contains functions to serialize and deserialize records as JSON, EDN, and Avro, as well as functions for writing unit and integration tests.

Supported versions

Jackdaw currently only works with Clojure >= 1.10. This is because we are using the

datafy
protocol which was only introduced in 1.10.

Documentation

You can find all the documentation on cljdoc.

Examples

Contributing

We welcome any thoughts or patches. You can reach us in

#jackdaw
(or open an issue).

Related projects

If you want to get more insight about your topologies, you can use the Topology Grapher library to generate graphs. See an example using jackdaw to check how to integrate it with your topology.

Releasing

Anyone with the appropriate credentials can "cut a release" of jackdaw using the following steps.

  1. Review the diff of master vs the latest released tag (e.g. while preparing 0.7.0, I looked at https://github.com/FundingCircle/jackdaw/compare/0.6.9...master to see what was actually merged vs what was in the Changelog). Make a PR to put a date on the version being released and if necessary ensure completeness and consistency of the Changelog
  2. Use the Draft a new release feature in github to prepare a release
  3. In the "tag version" field, enter the proposed version
  4. In the "release title" field, enter "v[version]"
  5. In the "describe this release" field, enter the contents of the Changelog and add a credit to the contributors of the release
  6. When happy, use the "Publish Release" button to publish the release in github which creates a corresponding git tag
  7. Once the tag is seen by circleci, a deployment build is triggered which builds the project and deploys a release to clojars

Steps 2 to 6 is essentially

git tag $version -m "$title\n\n$description" && git push --tags

License

Copyright © 2017 Funding Circle

Distributed under the BSD 3-Clause License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.