{"id":13561044,"url":"https://github.com/FundingCircle/jackdaw","last_synced_at":"2025-04-03T16:31:55.024Z","repository":{"id":37885413,"uuid":"159663637","full_name":"FundingCircle/jackdaw","owner":"FundingCircle","description":"A Clojure library for the Apache Kafka distributed streaming platform.","archived":false,"fork":false,"pushed_at":"2024-08-16T15:00:20.000Z","size":1921,"stargazers_count":373,"open_issues_count":79,"forks_count":78,"subscribers_count":78,"default_branch":"master","last_synced_at":"2025-03-31T02:12:29.360Z","etag":null,"topics":["clojure-library","kafka-client"],"latest_commit_sha":null,"homepage":"https://fundingcircle.github.io/jackdaw/","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FundingCircle.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-29T12:34:49.000Z","updated_at":"2025-02-02T22:36:16.000Z","dependencies_parsed_at":"2024-01-14T02:53:25.431Z","dependency_job_id":"1141c0de-c577-4346-bc29-085238469984","html_url":"https://github.com/FundingCircle/jackdaw","commit_stats":{"total_commits":1107,"total_committers":74,"mean_commits":14.95945945945946,"dds":0.8283649503161699,"last_synced_commit":"1e51947eb0b4e882972d7bacd5c3ba0e77f89327"},"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FundingCircle%2Fjackdaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FundingCircle%2Fjackdaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FundingCircle%2Fjackdaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FundingCircle%2Fjackdaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FundingCircle","download_url":"https://codeload.github.com/FundingCircle/jackdaw/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247037063,"owners_count":20873089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clojure-library","kafka-client"],"created_at":"2024-08-01T13:00:51.948Z","updated_at":"2025-04-03T16:31:50.014Z","avatar_url":"https://github.com/FundingCircle.png","language":"Clojure","funding_links":[],"categories":["Avro \u0026 Confluent Schema Registry","Clojure","Clients"],"sub_categories":["Clojure"],"readme":"# Jackdaw \u0026middot; [![Clojars Project](https://img.shields.io/clojars/v/fundingcircle/jackdaw.svg)](https://clojars.org/fundingcircle/jackdaw) [![Code Coverage](https://codecov.io/gh/FundingCircle/jackdaw/branch/master/graph/badge.svg)](https://codecov.io/gh/FundingCircle/jackdaw) [![cljdoc badge](https://cljdoc.org/badge/fundingcircle/jackdaw)](https://cljdoc.org/d/fundingcircle/jackdaw/CURRENT) [![CircleCI](https://circleci.com/gh/FundingCircle/jackdaw.svg?style=shield)](https://circleci.com/gh/FundingCircle/jackdaw)\n\nJackdaw 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.\n\n# Supported versions\n\nJackdaw currently only works with Clojure \u003e= 1.10.\nThis is because we are using the `datafy` protocol which was only introduced in 1.10.\n\n## Documentation\n\nYou can find all the documentation on [cljdoc](https://cljdoc.org/d/fundingcircle/jackdaw).\n\n## Examples\n\n- [Pipe](https://github.com/FundingCircle/jackdaw/tree/master/examples/pipe)\n- [Word Count](https://github.com/FundingCircle/jackdaw/tree/master/examples/word-count)\n- [Simple Ledger](https://github.com/FundingCircle/jackdaw/tree/master/examples/simple-ledger)\n- [Roll Dice](https://github.com/FundingCircle/jackdaw/tree/master/examples/rolldice)\n\n## Contributing\n\nWe welcome any thoughts or patches. You can reach us in [`#jackdaw`](https://clojurians.slack.com/messages/CEA3C7UG0/) (or [open an issue](https://github.com/fundingcircle/jackdaw/issues)).\n\n## Related projects\n\nIf you want to get more insight about your topologies, you can use the\n[Topology Grapher](https://github.com/FundingCircle/topology-grapher) library to generate graphs.\nSee [an example using jackdaw](https://github.com/FundingCircle/topology-grapher/blob/master/sample_project/src/jackdaw_topology.clj) to check how to integrate it with your topology.\n\n## Releasing\n\nAnyone with the appropriate credentials can \"cut a release\" of jackdaw\n* Tags are protected, you will need to be a maintainer or admin to apply them\n* Clojars deployment uses a protected env, once a tag is created, the CI job to deploy will need to be reviewed by the clojars env owner\n\n\nSteps:\n 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\n 2. Use the [Draft a new release](https://github.com/FundingCircle/jackdaw/releases/new) feature in github to prepare a release\n 3. In the \"tag version\" field, enter the proposed version\n 4. In the \"release title\" field, enter \"v[version]\"\n 5. In the \"describe this release\" field, enter the contents of the Changelog and add a credit to the contributors of the release\n 6. When happy, use the \"Publish Release\" button to publish the release in github which creates a corresponding git tag\n 7. Once the tag is seen by circleci, a deployment build is triggered which builds the project and deploys a release to clojars\n\nSteps 2 to 6 is essentially `git tag $version -m \"$title\\n\\n$description\" \u0026\u0026 git push --tags`\n\n#### Snapshot release\n\nSnapshot releases can be created by pushing a tag with the format `publish-snapshot-semver`\n\n## License\n\nCopyright © 2017 Funding Circle\n\nDistributed under the BSD 3-Clause License.\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFundingCircle%2Fjackdaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFundingCircle%2Fjackdaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFundingCircle%2Fjackdaw/lists"}