v2.7.0

confluent-kafka-python v2.7.0

Note: As part of this release, we are deprecating v2.6.2 release and yanking it from PyPI. Please refrain from using v2.6.2. Use v2.7.0 instead.

Note: This release modifies the dependencies of the Schema Registry client.
If you are using the Schema Registry client, please ensure that you install the
extra dependencies using the following syntax:

pip install confluent-kafka[schemaregistry]

or

pip install confluent-kafka[avro,schemaregistry]

Please see the README.md for more information related to installing protobuf, jsonschema or rules dependencies.

v2.7.0 is a feature release with the following features, fixes and enhancements:

• Support for Data Contracts with Schema Registry, including
  • Data Quality rules
  • Data Transformation rules
  • Client-Side Field Level Encryption (CSFLE)
  • Schema Migration rules (requires Python 3.9+)
• Migrated the Schema Registry client from requests to httpx
• Add support for multiple URLs (#409)
• Allow configuring timeout (#622)
• Fix deletion semantics (#1127)
• Python deserializer can take SR client (#1174)
• Fix handling of Avro unions (#1562)
• Remove deprecated RefResolver for JSON (#1840)
• Support delete of subject version (#1851)
• Added missing dependency on googleapis-common-protos when using protobufs. (#1881, @Tenzer)

confluent-kafka-python v2.7.0 is based on librdkafka v2.6.1, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.6.2

confluent-kafka-python v2.6.2

Warning

Due to an error in which we included dependency changes to a recent patch release, Confluent recommends users to refrain from upgrading to 2.6.2 of Confluent Kafka. Confluent will release a new minor version, 2.7.0, where the dependency changes will be appropriately included. Users who have already upgraded to 2.6.2 and made the required dependency changes are free to remain on that version and are recommended to upgrade to 2.7.0 when that version is available. Upon the release of 2.7.0, the 2.6.2 version will be marked deprecated.
We apologize for the inconvenience and appreciate the feedback that we have gotten from the community.

Note: This version is yanked from PyPI. Use 2.7.0 instead.

Note: This release modifies the dependencies of the Schema Registry client.
If you are using the Schema Registry client, please ensure that you install the
extra dependencies using the following syntax:

pip install confluent-kafka[schemaregistry]

or

pip install confluent-kafka[avro,schemaregistry]

Please see the README.md for more information related to installing protobuf, jsonschema or rules dependencies.

v2.6.2 is a feature release with the following features, fixes and enhancements:

• Support for Data Contracts with Schema Registry, including
  • Data Quality rules
  • Data Transformation rules
  • Client-Side Field Level Encryption (CSFLE)
  • Schema Migration rules (requires Python 3.9+)
• Migrated the Schema Registry client from requests to httpx
• Add support for multiple URLs (#409)
• Allow configuring timeout (#622)
• Fix deletion semantics (#1127)
• Python deserializer can take SR client (#1174)
• Fix handling of Avro unions (#1562)
• Remove deprecated RefResolver for JSON (#1840)
• Support delete of subject version (#1851)

confluent-kafka-python is based on librdkafka v2.6.1, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.6.1

confluent-kafka-python v2.6.1

v2.6.1 is a maintenance release with the following fixes and enhancements:

• Removed python 3.6 support. (#1592)
• Migrated build system from setup.py to pyproject.toml in accordance with PEP 517 and PEP 518, improving project configuration, build system requirements management, and compatibility with modern Python packaging tools like pip and build. (#1592)
• Added an example for OAUTH OIDC producer with support for confluent cloud (#1769, @sarwarbhuiyan)

confluent-kafka-python is based on librdkafka v2.6.1, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.6.0

confluent-kafka-python v2.6.0

v2.6.0 is a feature release with the following features, fixes and enhancements:

• Added Python 3.13 wheels (#1828).
• KIP-848 EA: Admin API for listing consumer groups now has an optional filter to return only groups of given types (#1830).
• KIP-460 Admin Leader Election RPC (#1818)
• Added Transactional id resource type for ACL operations (@JohnPreston, #1834).

confluent-kafka-python is based on librdkafka v2.6.0, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.5.3

confluent-kafka-python v2.5.3

v2.5.3 is a maintenance release with the following fixes and enhancements:

Fixes

• Fix an assert being triggered during push telemetry call when no metrics matched on the client side.
• Minor enhancement to JSONDeserializer to retrieve schema from Schema Registry if not provided

confluent-kafka-python is based on librdkafka v2.5.3, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.5.0

Warning

This version has introduced a regression in which an assert is triggered during PushTelemetry call. This happens when no metric is matched on the client side among those requested by broker subscription.

You won't face any problem if:

• Broker doesn't support KIP-714.
• KIP-714 feature is disabled on the broker side.
• KIP-714 feature is disabled on the client side. This is enabled by default. Set configuration enable.metrics.push to false.
• If KIP-714 is enabled on the broker side and there is no subscription configured there.
• If KIP-714 is enabled on the broker side with subscriptions that match the KIP-714 metrics defined on the client.

Having said this, we strongly recommend using v2.5.3 and above to not face this regression at all.

confluent-kafka-python v2.5.0

v2.5.0 is a feature release with the following features, fixes and enhancements:

• KIP-107 Added delete_records API. (#1710)
• Added an example to show the usage of the custom logger with AdminClient. (#1758)
• Improve caching on Schema Registry client. (#1744)
• Removed usage of strcpy to enhance security of the client. (#1745)
• Removed support for centos6 and centos7. (#1776)
• Fixed invalid write in OAUTHBEARER/OIDC extensions copy. (#1745)
• Fixed documentation for default value of operation_timeout and request_timeout in various Admin apis. (#1710)
• Fixed an issue related to import error of TopicCollection and TopicPartitionInfo classes when importing through other module like mypy. (#1764)
• Fixed a segfault when commit or store_offsets consumer method is called incorrectly with errored Message object. (#1754)
• Fixed logger not working when provided as an argument to AdminClient instead of a configuration property. (#1758)
• Fixed some memory leaks related to PyDict_SetItem. (#1710)

confluent-kafka-python is based on librdkafka v2.5.0, see the librdkafka release notes for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.4.0

confluent-kafka-python v2.4.0

v2.4.0 is a feature release with the following features, fixes and enhancements:

• KIP-848: Added KIP-848 based new consumer group rebalance protocol. The feature is an Early Access: not production ready yet. Please refer detailed doc for more information.
• Fix segfault with describe_topics and flaky connection (@lpsinger, #1692)

confluent-kafka-python is based on librdkafka v2.4.0, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.3.0

confluent-kafka-python v2.3.0

v2.3.0 is a feature release with the following features, fixes and enhancements:

• Add Python 3.12 wheels
• KIP-117: Add support for AdminAPI describe_cluster() and describe_topics(). (@jainruchir, #1635)
• KIP-430:
  Return authorized operations in Describe Responses. (@jainruchir, #1635)
• KIP-516: Partial support of topic identifiers. Topic identifiers in metadata response are available through the new describe_topics function (#1645).
• KIP-396: completed the implementation with the addition of list_offsets (#1576).
• Add Rack to the Node type, so AdminAPI calls can expose racks for brokers
  (currently, all Describe Responses) (#1635, @jainruchir).
• Fix the Describe User Scram Credentials for Describe all users or empty users list. Please refer to
  issue(#1616) for more details (#1630).

confluent-kafka-python is based on librdkafka v2.3.0, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.2.0

confluent-kafka-python v2.2.0

v2.2.0 is a feature release with the following features, fixes and enhancements:

• KIP-339
  IncrementalAlterConfigs API (#1517).
• KIP-554:
  User SASL/SCRAM credentials alteration and description (#1575).
• Added documentation with an example of FIPS compliant communication with Kafka cluster.
• Fixed wrong error code parameter name in KafkaError.

confluent-kafka-python is based on librdkafka v2.2.0, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.

v2.1.1

confluent-kafka-python v2.1.1

v2.1.1 is a maintenance release with the following fixes and enhancements:

Fixes

• Added a new ConsumerGroupState UNKNOWN. The typo state UNKOWN is deprecated and will be removed in the next major version.
• Fix some Admin API documentation stating -1 for infinite timeout incorrectly.
  Request timeout can't be infinite.

confluent-kafka-python is based on librdkafka v2.1.1, see the
librdkafka release notes
for a complete list of changes, enhancements, fixes and upgrade considerations.