Type annotations for helpers (#989)

* Type annotations for helpers
* Fix references
* Fix "class reference target not found: typing_extensions.Buffer" error
* Fix "object is not subscriptable" in Python 3.8

Author: ods

Makefile

@@ -8,6 +8,7 @@ DIFF_BRANCH=origin/master
 FORMATTED_AREAS=\
 	aiokafka/codec.py \
 	aiokafka/errors.py \
+	aiokafka/helpers.py \
 	aiokafka/structs.py \
 	aiokafka/util.py \
 	tests/test_codec.py

aiokafka/consumer/consumer.py

@@ -573,6 +573,8 @@ async def commit(self, offsets=None):
             Will now raise :exc:`~aiokafka.errors.CommitFailedError` in case
             membership changed, as (possibly) this partition is handled by
             another consumer.
+
+        .. _kafka-python: https://github.com/dpkp/kafka-python
         """
         if self._group_id is None:
             raise IllegalOperation("Requires group_id")

aiokafka/helpers.py

@@ -1,23 +1,26 @@
-"""
-.. _kafka-python: https://github.com/dpkp/kafka-python
-"""
+from __future__ import annotations
 
 import logging
-from ssl import Purpose, create_default_context
+from os import PathLike
+from ssl import Purpose, SSLContext, create_default_context
+from typing import Callable, Union
+
+from typing_extensions import Buffer
 
 log = logging.getLogger(__name__)
 
 
 def create_ssl_context(
     *,
-    cafile=None,
-    capath=None,
-    cadata=None,
-    certfile=None,
-    keyfile=None,
-    password=None,
-    crlfile=None,
-):
+    cafile: Union[str, bytes, PathLike[str], PathLike[bytes], None] = None,
+    capath: Union[str, bytes, PathLike[str], PathLike[bytes], None] = None,
+    cadata: Union[str, Buffer, None] = None,
+    certfile: Union[str, bytes, PathLike[str], PathLike[bytes], None] = None,
+    keyfile: Union[str, bytes, PathLike[str], PathLike[bytes], None] = None,
+    password: Union[
+        Callable[[], Union[str, bytes, bytearray]], str, bytes, bytearray, None
+    ] = None,
+) -> SSLContext:
     """
     Simple helper, that creates an :class:`~ssl.SSLContext` based on params similar to
     those in `kafka-python`_, but with some restrictions like:
@@ -54,6 +57,7 @@ def create_ssl_context(
             :meth:`~ssl.SSLContext.load_cert_chain`.
             Default: :data:`None`.
 
+    .. _kafka-python: https://github.com/dpkp/kafka-python
     """
     if cafile or capath:
         log.info("Loading SSL CA from %s", cafile or capath)

docs/conf.py

@@ -86,7 +86,7 @@ def get_version(release):
 
 # General information about the project.
 project = 'aiokafka'
-copyright = '2015-2017, Aio-libs contributors'
+copyright = '2015-2024, Aio-libs contributors'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -119,6 +119,7 @@ def get_version(release):
     ("py:class", "KT"),
     ("py:class", "Optional[~ VT]"),
     ("py:class", "VT"),
+    ("py:class", "typing_extensions.Buffer"),
 ]
 
 # If true, '()' will be appended to :func: etc. cross-reference text.