Metadata-Version: 2.1
Name: kafka-connect-py
Version: 0.2.3
Summary: A client for the Confluent Platform Kafka Connect REST API.
License: MIT
Author: Aidan Melen
Author-email: aidan-melen@protonmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: requests (>=2.25,<3.0)
Description-Content-Type: text/markdown

# Kafka Connect Python

The Kafka Connect REST API allows you to manage connectors that move data between Apache Kafka and other systems.

The `kc` command line tool provides commands for getting information about the Kafka Connect cluster and its connectors, creating new connectors, updating existing connectors, deleting connectors, etc.

This project aims to supported all features of the [Kafka Connect REST API](https://docs.confluent.io/platform/current/connect/references/restapi.html#kconnect-rest-interface).

## Install

```bash
pip install kafka-connect-py
```

## Command Line Usage

Retrieve the version and other details of the Kafka Connect cluster.

```bash
$ kc get-cluster
```

Retrieve the details of a single connector.

```bash
$ kc get-connector <connector>
```

Retrieve a list of active connectors. The `--expand' option can be used to retrieve additional information about the connectors, such as their status or metadata.

```bash
$ kc get-connectors [--expand=status|info]
```

Create a new connector using the configuration specified in the given file. If the connector already exists or a rebalance is in process, Wil return a status code of 409.

```bash
$ kc create-connector <config_file>
```

Update the configuration for an existing connector. If a rebalance is in process, Wil return a status code of 409.

```bash
$ kc update-connector <connector> <config_file>
```

Retrieve the configuration of a connector.

```bash
$ kc get-connector <connector>
```

Retrieve the config of a connector.

```bash
$ kc get-connector-config <connector>
```

Retrieve the status of a connector.

```bash
$ kc get-connector-status <connector>
```

Retrieve the tasks of a connector. The `--include-tasks' option can be used to include task information in the response.

```bash
$ kc get-connector-tasks <connector> [--include-tasks]
```

Pause a connector.

```bash
$ kc pause-connector <connector>
```

Resume a connector that was previously paused.

```bash
$ kc resume-connector <connector>
```

Delete a connector.

```bash
$ kc delete-connector <connector>
```

Validate the configuration specified in the given file. If the configuration is valid, Wil return a status code of 200.

```bash
$ kc validate-connector-config <config_file>
```

Retrieve metadata about the specified connector plugin.

```bash
$ kc get-connector-plugin <connector>
```

Retrieve metadata about all available connector plugins.

```bash
$ kc get-connector-plugins
```


### Python

```python
# Import the class
from kafka_connect import KafkaConnect

# Instantiate the client
client = KafkaConnect(endpoint="http://localhost:8083")

# Get the version and other details of the Kafka Connect cluster
cluster = client.get_cluster()
print(cluster)

# Get a list of active connectors
connectors = client.get_connectors()
print(connectors)

# Create a new connector
config = {
    "name": "my-connector",
    "config": {
        "connector.class": "io.confluent.connect.jdbc.JdbcSourceConnector",
        "tasks.max": "1",
        "connection.url": "jdbc:postgresql://localhost:5432/mydatabase",
        "connection.user": "myuser",
        "connection.password": "mypassword",
        "table.whitelist": "mytable",
        "mode": "timestamp+incrementing",
        "timestamp.column.name": "modified_at",
        "validate.non.null": "false",
        "incrementing.column.name": "id",
        "topic.prefix": "my-connector-",
    },
}
response = client.create_connector(config)
print(response)

# Update an existing connector
new_config = {
    "config": {
        "connector.class": "io.confluent.connect.jdbc.JdbcSourceConnector",
        "tasks.max": "1",
        "connection.url": "jdbc:postgresql://localhost:5432/mydatabase",
        "connection.user": "myuser",
        "connection.password": "mypassword",
        "table.whitelist": "mytable",
        "mode": "timestamp+incrementing",
        "timestamp.column.name": "modified_at",
        "validate.non.null": "false",
        "incrementing.column.name": "id",
        "topic.prefix": "my-connector-",
    },
}
response = client.update_connector("my-connector", new_config)
print(response)

# Restart a connector
response = client.restart_connector("my-connector")
print(response)

# Delete a connector
response = client.delete_connector("my-connector")
print(response)
```

## Tests

```
python3 -m unittest tests/test_kafka_connect.py -v
```
