Metadata-Version: 2.1
Name: strimzi-kafka-cli
Version: 0.1.0a33
Summary: Command Line Interface for Strimzi Kafka Operator
Home-page: https://github.com/systemcraftsman/strimzi-kafka-cli
License: UNKNOWN
Description: ![Build](https://github.com/systemcraftsman/strimzi-kafka-cli/workflows/Build/badge.svg) ![Deploy](https://github.com/systemcraftsman/strimzi-kafka-cli/workflows/Deploy/badge.svg) [![PyPI version](https://badge.fury.io/py/strimzi-kafka-cli.svg)](https://badge.fury.io/py/strimzi-kafka-cli)
        
        ![strimzi cli](https://raw.githubusercontent.com/systemcraftsman/strimzi-kafka-cli/master/logo/strimzi_cli.png)
        
        # Strimzi Kafka CLI
        
        Strimzi Kafka CLI is a CLI that helps traditional Apache Kafka users
        -mostly administrators- to easily adapt [Strimzi](https://strimzi.io/),
        a [Kubernetes
        operator](https://operatorhub.io/operator/strimzi-kafka-operator) for
        [Apache Kafka](https://kafka.apache.org/).
        
        Intention here is to ramp up Strimzi usage by creating a similar CLI
        experience with traditional Apache Kafka binaries. For example:
        
        | Native Command                             | Strimzi CLI Command  |
        | ------------------------------------------ | -------------------- |
        | $KAFKA\_HOME/bin/kafka-topics.sh           | kfk topics           |
        | $KAFKA\_HOME/bin/kafka-configs.sh          | kfk configs          |
        | $KAFKA\_HOME/bin/kafka-console-consumer.sh | kfk console-consumer |
        | ... | ... |
        
        **kfk** command stands for the usual **kafka-**\* prefix of the
        Apache Kafka runnable files which are located in *bin* directory. There
        are options provided like *topics*, *console-consumer*, etc. which also
        mostly stand for the rest of the runnable file names like
        *kafka-topic.sh*.
        
        However, because of the nature of Strimzi and its capabilities, there
        are also unusual options like *clusters* which is used for
        cluster configuration or *users* which is used for user management and
        configuration.
        
        Following is the high-level output of the Strimzi Kafka CLI:
        
        ``` bash
        Usage: kfk [OPTIONS] COMMAND [ARGS]...
        
          Strimzi Kafka CLI
        
        Options:
          --help  Show this message and exit.
        
        Commands:
          acls              This tool helps to manage ACLs on Kafka.
          clusters          The kafka cluster(s) to be created, altered or...
          configs           Add/Remove entity config for a topic, client, user or...
          console-consumer  The console consumer is a tool that reads data from...
          console-producer  The console producer is a tool that reads data from...
          operator          Install/Uninstall Strimzi Kafka Operator
          topics            The kafka topic(s) to be created, altered or described.
          users             The kafka user(s) to be created, altered or described.
          version           Prints the version of Strimzi Kafka CLI
        ```
        
        Please take a look at the relevant article [Strimzi Kafka CLI: Managing Strimzi in a Kafka Native Way](https://www.systemcraftsman.com/2020/08/25/strimzi-kafka-cli-managing-strimzi-in-a-kafka-native-way/) for more details.
        
        ## Installation
        
        Strimzi Kafka CLI can be installed via pip (python package installer).
        
        ``` bash
        sudo pip install strimzi-kafka-cli
        ```
        
        ---
        **IMPORTANT**
        
        We recommend to use sudo while installing Strimzi Kafka CLI because the binary will directly be located in /usr/local/bin which is accessible from all users of the OS. If you don't want this, and want to install the CLI without sudo you will get this kind of warning:
        
        ```
        WARNING: The script kfk is installed in '[USER_HOME]/[PYTHON_PATH]/bin' which is not on PATH.
        Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
        ```
          
        So in this case you need to put the shown location of `kfk` on PATH.
        
        ---
        
        Project requires: Python >=3.5
        
        ## Examples
        
        You can access the examples from [here](https://github.com/systemcraftsman/strimzi-kafka-cli/tree/master/examples).
        
        ## Dependencies
        ### Python Dependencies
        Please see [requirements.txt](https://github.com/systemcraftsman/strimzi-kafka-cli/blob/master/requirements.txt) file.
        ### External Dependencies
        - kubectl: kfk will automatically download kubectl binary which is configurable to use which kubectl version to use. (Pls see [issue-19](https://github.com/systemcraftsman/strimzi-kafka-cli/issues/19))
        - Strimzi binaries: kfk will download it automatically. The yaml templates are used for create actions. This is configurable to use which binaries path to use. (Pls see [issue-19](https://github.com/systemcraftsman/strimzi-kafka-cli/issues/19))
        
Platform: UNKNOWN
Requires-Python: >=3.5
Description-Content-Type: text/markdown
