kafka-python 2.2.19__tar.gz → 2.3.1__tar.gz

{kafka_python-2.2.19 → kafka_python-2.3.1}/CHANGES.md

@@ -1,13 +1,45 @@
-# 2.2.19 (Apr 9, 2026)
+# 2.3.1 (Apr 9, 2026)
 
 Fixes
 * Fix TaggedFields value encoding; add test coverage (#2725)
 * Fix zstd multi-frame decompression failure (#2717)
 * Fix KeyError in KafkaConsumer.committed() (#2710)
 * Fix VarInt/VarLong encoding; move tests to test/protocol/ (#2706)
-* Fix `Fetcher._fetch_offsets_by_times retry handling` (#2833)
+* Fix `Fetcher._fetch_offsets_by_times` retry handling (#2833)
 * Fixes to support integration testing with external KAFKA_URI (#2838)
-* Minor py2 fixes: consumer integration test; done pip install python-snappy
+* Minor py2 fixes: consumer integration test; dont pip install python-snappy
+
+# 2.3.0 (Nov 20, 2025)
+
+CLI
+* python -m cli interfaces for kafka.admin, kafka.consumer, kafka.producer (#2650)
+
+Producer
+* KIP-654: Abort transaction with pending data with TransactionAbortedError (#2662)
+* KafkaProducer: Handle UnknownProducerIdError (#2663)
+* KIP-467: Augment ProduceResponse error messaging for specific culprit records (#2661)
+
+Consumer
+* KIP-345: Consumer group static membership (#2625)
+* KIP-207: Add ListOffsetsRequest v5 / handle OffsetNotAvailableError (#2657)
+* Fetcher: Add missing argument in debug log (#2665)
+
+AdminClient
+* KIP-430: Return Authorized Operations in Describe Responses (#2656)
+* Add `send_request()` and `send_requests()` to KafkaAdminClient (#2649)
+
+Maintenance
+* Remove old/unused kafka.protocol.pickle (#2653)
+* Switch protocol code to getattr/setattr from __dict__ (#2654)
+* Drop unused imports (#2651)
+
+Project Infra
+* Bump github/codeql-action from 3 to 4 (#2678)
+* Bump actions/setup-python from 5 to 6 (#2674)
+* Bump actions/setup-java from 4 to 5 (#2673)
+* Bump actions/checkout from 4 to 5 (#2669)
+* Bump actions/checkout from 5 to 6 (#2694)
+* NixOS helpers
 
 # 2.2.18 (Nov 20, 2025)
 

{kafka_python-2.2.19 → kafka_python-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kafka-python
-Version: 2.2.19
+Version: 2.3.1
 Summary: Pure Python client for Apache Kafka
 Author-email: Dana Powers <dana.powers@gmail.com>
 Project-URL: Homepage, https://github.com/dpkp/kafka-python
@@ -66,22 +66,11 @@ Python client for the Apache Kafka distributed stream processing system.
 kafka-python is designed to function much like the official java client, with a
 sprinkling of pythonic interfaces (e.g., consumer iterators).
 
-kafka-python is best used with newer brokers (0.9+), but is backwards-compatible with
-older versions (to 0.8.0). Some features will only be enabled on newer brokers.
-For example, fully coordinated consumer groups -- i.e., dynamic partition
-assignment to multiple consumers in the same group -- requires use of 0.9+ kafka
-brokers. Supporting this feature for earlier broker releases would require
-writing and maintaining custom leadership election and membership / health
-check code (perhaps using zookeeper or consul). For older brokers, you can
-achieve something similar by manually assigning different partitions to each
-consumer instance with config management tools like chef, ansible, etc. This
-approach will work fine, though it does not support rebalancing on failures.
-See https://kafka-python.readthedocs.io/en/master/compatibility.html
-for more details.
-
 Please note that the master branch may contain unreleased features. For release
 documentation, please see readthedocs and/or python's inline help.
 
+New in 2.3 release: python -m kafka.* interfaces for quick scripts and testing.
+
 .. code-block:: bash
 
     $ pip install kafka-python
@@ -232,6 +221,14 @@ for more details.
     metrics = producer.metrics()
 
 
+Module CLI Interface
+********************
+
+kafka-python also provides simple command-line interfaces for consumer, producer, and admin clients.
+Access via ``python -m kafka.consumer``, ``python -m kafka.producer``, and ``python -m kafka.admin``.
+See https://kafka-python.readthedocs.io/en/master/usage.html for more details.
+
+
 Thread safety
 *************
 

{kafka_python-2.2.19 → kafka_python-2.3.1}/README.rst

@@ -22,22 +22,11 @@ Python client for the Apache Kafka distributed stream processing system.
 kafka-python is designed to function much like the official java client, with a
 sprinkling of pythonic interfaces (e.g., consumer iterators).
 
-kafka-python is best used with newer brokers (0.9+), but is backwards-compatible with
-older versions (to 0.8.0). Some features will only be enabled on newer brokers.
-For example, fully coordinated consumer groups -- i.e., dynamic partition
-assignment to multiple consumers in the same group -- requires use of 0.9+ kafka
-brokers. Supporting this feature for earlier broker releases would require
-writing and maintaining custom leadership election and membership / health
-check code (perhaps using zookeeper or consul). For older brokers, you can
-achieve something similar by manually assigning different partitions to each
-consumer instance with config management tools like chef, ansible, etc. This
-approach will work fine, though it does not support rebalancing on failures.
-See https://kafka-python.readthedocs.io/en/master/compatibility.html
-for more details.
-
 Please note that the master branch may contain unreleased features. For release
 documentation, please see readthedocs and/or python's inline help.
 
+New in 2.3 release: python -m kafka.* interfaces for quick scripts and testing.
+
 .. code-block:: bash
 
     $ pip install kafka-python
@@ -188,6 +177,14 @@ for more details.
     metrics = producer.metrics()
 
 
+Module CLI Interface
+********************
+
+kafka-python also provides simple command-line interfaces for consumer, producer, and admin clients.
+Access via ``python -m kafka.consumer``, ``python -m kafka.producer``, and ``python -m kafka.admin``.
+See https://kafka-python.readthedocs.io/en/master/usage.html for more details.
+
+
 Thread safety
 *************
 

kafka_python-2.3.1/kafka/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+print("Available module interfaces: kafka.consumer, kafka.producer, kafka.admin")
+
+sys.exit(1)

kafka_python-2.3.1/kafka/admin/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import absolute_import
+
+import sys
+
+from kafka.cli.admin import run_cli
+
+sys.exit(run_cli())

{kafka_python-2.2.19 → kafka_python-2.3.1}/kafka/admin/acl_resource.py

@@ -1,5 +1,4 @@
 from __future__ import absolute_import
-from kafka.errors import IllegalArgumentError
 
 # enum in stdlib as of py3.4
 try:
@@ -8,6 +7,8 @@ except ImportError:
     # vendored backport module
     from kafka.vendor.enum34 import IntEnum
 
+from kafka.errors import IllegalArgumentError
+
 
 class ResourceType(IntEnum):
     """Type of kafka resource to set ACL for
@@ -30,6 +31,7 @@ class ACLOperation(IntEnum):
     The ANY value is only valid in a filter context
     """
 
+    UNKNOWN = 0,
     ANY = 1,
     ALL = 2,
     READ = 3,
@@ -41,7 +43,9 @@ class ACLOperation(IntEnum):
     CLUSTER_ACTION = 9,
     DESCRIBE_CONFIGS = 10,
     ALTER_CONFIGS = 11,
-    IDEMPOTENT_WRITE = 12
+    IDEMPOTENT_WRITE = 12,
+    CREATE_TOKENS = 13,
+    DESCRIBE_TOKENS = 13
 
 
 class ACLPermissionType(IntEnum):
@@ -50,6 +54,7 @@ class ACLPermissionType(IntEnum):
     The ANY value is only valid in a filter context
     """
 
+    UNKNOWN = 0,
     ANY = 1,
     DENY = 2,
     ALLOW = 3
@@ -63,6 +68,7 @@ class ACLResourcePatternType(IntEnum):
     https://cwiki.apache.org/confluence/display/KAFKA/KIP-290%3A+Support+for+Prefixed+ACLs
     """
 
+    UNKNOWN = 0,
     ANY = 1,
     MATCH = 2,
     LITERAL = 3,
@@ -242,3 +248,7 @@ class ResourcePattern(ResourcePatternFilter):
             raise IllegalArgumentError(
                 "pattern_type cannot be {} on a concrete ResourcePattern".format(self.pattern_type.name)
             )
+
+
+def valid_acl_operations(int_vals):
+     return set([ACLOperation(v) for v in int_vals if v not in (0, 1, 2)])