cooper

README

Cooper

Modern Command Line Tool for Apache Kafka.

Cooper is a Modern Command Line Tool for Apache Kafka. It is easy to install and use. Here is some of the features:

• Consume messages on specific partitions between specific offsets.
• Display topic information (e.g., with partition offset and leader info).
• Modify consumer group offsets (e.g., resetting or manually setting offsets per topic and per partition).
• JSON output for easy consumption with tools like kp or jq.
• JSON input to facilitate automation via tools like jsonify.
• Support for TLS authentication.
• Cluster administration functions: Create & delete topics.

Documentation

Installation

Download the latest cooper binary. Make it executable from everywhere.

$ export LATEST_VERSION=$(curl --silent "https://api.github.com/repos/clivern/cooper/releases/latest" | jq '.tag_name' | sed -E 's/.*"([^"]+)".*/\1/' | tr -d v)

$ curl -sL https://github.com/clivern/cooper/releases/download/v{$LATEST_VERSION}/cooper_{$LATEST_VERSION}_Linux_x86_64.tar.gz | tar xz

Usage

To run a local kafka cluster with docker & docker-compose for testing, you can use the following command:

$ cooper cluster run [name] [port]

$ cooper cluster run local_clus1 3000
$ cooper cluster run local_clus2 3001

Please note that the above command requires both docker and docker-compose.

To destroy local clusters

$ cooper cluster destroy [name]

$ cooper cluster destroy local_clus1
$ cooper cluster destroy local_clus2

To list all configured clusters

$ cooper cluster list

To show cluster info

$ cooper cluster show [name]

$ cooper cluster show local_clus1

To add a new remote cluster

$ cooper cluster add [name]

$ cooper cluster add remote_cluster

To remove a configured cluster

$ cooper cluster show [name]

$ cooper cluster remove remote_cluster

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Cooper is maintained under the Semantic Versioning guidelines and release process is predictable and business-friendly.

See the Releases section of our GitHub project for changelogs for each release version of Helmet. It contains summaries of the most noteworthy changes made in each release.

Bug tracker

If you have any suggestions, bug reports, or annoyances please report them to our issue tracker at https://github.com/clivern/cooper/issues

Security Issues

If you discover a security vulnerability within Cooper, please send an email to hello@clivern.com

Contributing

We are an open source, community-driven project so please feel free to join us. see the contributing guidelines for more details.

License

© 2022, Clivern. Released under MIT License.

Cooper is authored and maintained by @Clivern.