kaskade 0.1.1

kaskade is a terminal user interface for kafka

kaskade is a tui (terminal user interface) for kafka.

Installation and Usage

Install with pip:

pip install kaskade

Upgrade with pip:

pip install --upgrade kaskade

Help:

kaskade --help

Version:

kaskade --version

Run without config file (it'll take any of kaskade.yml, kaskade.yaml, config.yml, config.yaml):

kaskade

Run with config file:

kaskade my-file.yml

Running with Docker

Using docker (add a network and volume):

docker run --rm -it --network kafka-sandbox_network -v $(pwd)/config.yml:/kaskade/config.yml sauljabin/kaskade:latest

Configuration

A default yaml configuration file name can be either kaskade.yml, kaskade.yaml, config.yml of config.yaml. It supports all the configuration on kafka consumer configuration page.

Simple example:

kafka:
    bootstrap.servers: kafka1:9092,kafka2:9092,kafka3:9092

SSL auth example:

kafka:
    bootstrap.servers: kafka:9092
    security.protocol: SSL
    ssl.truststore.location: {{path}}/truststore.jks
    ssl.truststore.password: {{password}}
    ssl.keystore.type: PKCS12
    ssl.keystore.location: {{path}}/keystore.p12
    ssl.keystore.password: {{password}}
    ssl.key.password: {{password}}

Screenshots

Alternatives

• cli kcat
• cli zoe
• cli kaf
• ui akhq

To Do

• Paginated table + key events for moving forward and backward
• Consumed messages table
• Consumer groups table
• Shortcuts at header

Development

Installing poetry:

pip install poetry

Installing development dependencies:

poetry install

Build (it'll create the dist folder):

poetry build

Scripts

Running unit tests:

poetry run python -m scripts.tests

Running multi version tests (3.7, 3.8, 3.9):

Make sure you have python3.7, python3.8, python3.9 aliases installed

poetry run python -m scripts.multi-version-tests

Applying code styles:

poetry run python -m scripts.styles

Running code analysis:

poetry run python -m scripts.analyze

Running code coverage:

poetry run python -m scripts.tests-coverage

Generate readme banner:

poetry run python -m scripts.banner

Running kaskade using poetry:

poetry run kaskade

Docker

Build docker:

poetry build
docker build -t sauljabin/kaskade:latest -f ./docker/Dockerfile .

Run with docker:

docker run --rm -it --network kafka-sandbox_network -v $(pwd)/config.yml:/kaskade/config.yml sauljabin/kaskade:latest