mypy-boto3-kinesis 1.35.26__tar.gz → 1.36.0__tar.gz

{mypy_boto3_kinesis-1.35.26 → mypy_boto3_kinesis-1.36.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Vlad Emelianov
+Copyright (c) 2025 Vlad Emelianov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{mypy_boto3_kinesis-1.35.26/mypy_boto3_kinesis.egg-info → mypy_boto3_kinesis-1.36.0}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: mypy-boto3-kinesis
-Version: 1.35.26
-Summary: Type annotations for boto3.Kinesis 1.35.26 service generated with mypy-boto3-builder 8.1.2
+Version: 1.36.0
+Summary: Type annotations for boto3 Kinesis 1.36.0 service generated with mypy-boto3-builder 8.8.0
 Home-page: https://github.com/youtype/mypy_boto3_builder
 Author: Vlad Emelianov
 Author-email: vlad.emelianov.nz@gmail.com
@@ -9,7 +9,7 @@ License: MIT License
 Project-URL: Documentation, https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/
 Project-URL: Source, https://github.com/youtype/mypy_boto3_builder
 Project-URL: Tracker, https://github.com/youtype/mypy_boto3_builder/issues
-Keywords: boto3 kinesis type-annotations botocore mypy typeshed autocomplete
+Keywords: boto3 kinesis boto3-stubs type-annotations mypy typeshed autocomplete
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Environment :: Console
@@ -23,47 +23,60 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Typing :: Stubs Only
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typing-extensions>=4.1.0; python_version < "3.12"
+Requires-Dist: typing-extensions; python_version < "3.12"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 <a id="mypy-boto3-kinesis"></a>
 
 # mypy-boto3-kinesis
 
-[![PyPI - mypy-boto3-kinesis](https://img.shields.io/pypi/v/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-kinesis)](https://pepy.tech/project/mypy-boto3-kinesis)
+[![PyPI - mypy-boto3-kinesis](https://img.shields.io/pypi/v/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis/)
+[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/)
+[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-kinesis)](https://pypistats.org/packages/mypy-boto3-kinesis)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.Kinesis 1.35.26](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis.html#Kinesis)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 Kinesis 1.36.0](https://pypi.org/project/boto3/)
+compatible with [VSCode](https://code.visualstudio.com/),
 [PyCharm](https://www.jetbrains.com/pycharm/),
 [Emacs](https://www.gnu.org/software/emacs/),
 [Sublime Text](https://www.sublimetext.com/),
 [mypy](https://github.com/python/mypy),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
-Generated by
-[mypy-boto3-builder 8.1.2](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.8.0](https://github.com/youtype/mypy_boto3_builder).
 
 More information can be found on
 [boto3-stubs](https://pypi.org/project/boto3-stubs/) page and in
 [mypy-boto3-kinesis docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/).
 
-See how it helps to find and fix potential bugs:
+See how it helps you find and fix potential bugs:
 
-![boto3-stubs demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
+![types-boto3 demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
 
 - [mypy-boto3-kinesis](#mypy-boto3-kinesis)
   - [How to install](#how-to-install)
+    - [Generate locally (recommended)](<#generate-locally-(recommended)>)
     - [VSCode extension](#vscode-extension)
     - [From PyPI with pip](#from-pypi-with-pip)
   - [How to uninstall](#how-to-uninstall)
@@ -75,6 +88,7 @@ See how it helps to find and fix potential bugs:
     - [Other IDEs](#other-ides)
     - [mypy](#mypy)
     - [pyright](#pyright)
+    - [Pylint compatibility](#pylint-compatibility)
   - [Explicit type annotations](#explicit-type-annotations)
     - [Client annotations](#client-annotations)
     - [Paginators annotations](#paginators-annotations)
@@ -94,6 +108,21 @@ See how it helps to find and fix potential bugs:
 
 ## How to install
 
+<a id="generate-locally-(recommended)"></a>
+
+### Generate locally (recommended)
+
+You can generate type annotations for `boto3` package locally with
+`mypy_boto3_builder`. Use
+[uv](https://docs.astral.sh/uv/getting-started/installation/) for build
+isolation.
+
+1. Run mypy-boto3-builder in your package root directory:
+   `uvx --with 'boto3==1.36.0' mypy_boto3_builder`
+2. Select `boto3-stubs` AWS SDK.
+3. Add `Kinesis` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -114,12 +143,10 @@ Install `boto3-stubs` for `Kinesis` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[kinesis]'
 
-
 # Lite version does not provide session.client/resource overloads
 # it is more RAM-friendly, but requires explicit type annotations
 python -m pip install 'boto3-stubs-lite[kinesis]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-kinesis
 ```
@@ -158,16 +185,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[kinesis]` in your environment:
+> ⚠️ Due to slow PyCharm performance on `Literal` overloads (issue
+> [PY-40997](https://youtrack.jetbrains.com/issue/PY-40997)), it is recommended
+> to use [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/) until
+> the issue is resolved.
+
+> ⚠️ If you experience slow performance and high CPU usage, try to disable
+> `PyCharm` type checker and use [mypy](https://github.com/python/mypy) or
+> [pyright](https://github.com/microsoft/pyright) instead.
+
+> ⚠️ To continue using `PyCharm` type checker, you can try to replace
+> `boto3-stubs` with
+> [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/):
 
 ```bash
-python -m pip install 'boto3-stubs-lite[kinesis]'`
+pip uninstall boto3-stubs
+pip install boto3-stubs-lite
 ```
 
-Both type checking and code completion should now work. Explicit type
-annotations **are required**.
+Install `boto3-stubs[kinesis]` in your environment:
+
+```bash
+python -m pip install 'boto3-stubs[kinesis]'
+```
 
-Use `boto3-stubs` package instead for implicit type discovery.
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -253,6 +295,31 @@ Optionally, you can install `boto3-stubs` to `typings` directory.
 Type checking should now work. No explicit type annotations required, write
 your `boto3` code as usual.
 
+<a id="pylint-compatibility"></a>
+
+### Pylint compatibility
+
+It is totally safe to use `TYPE_CHECKING` flag in order to avoid
+`mypy-boto3-kinesis` dependency in production. However, there is an issue in
+`pylint` that it complains about undefined variables. To fix it, set all types
+to `object` in non-`TYPE_CHECKING` mode.
+
+```python
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from mypy_boto3_ec2 import EC2Client, EC2ServiceResource
+    from mypy_boto3_ec2.waiters import BundleTaskCompleteWaiter
+    from mypy_boto3_ec2.paginators import DescribeVolumesPaginator
+else:
+    EC2Client = object
+    EC2ServiceResource = object
+    BundleTaskCompleteWaiter = object
+    DescribeVolumesPaginator = object
+
+...
+```
+
 <a id="explicit-type-annotations"></a>
 
 ## Explicit type annotations

mypy_boto3_kinesis-1.35.26/PKG-INFO → mypy_boto3_kinesis-1.36.0/README.md

@@ -1,69 +1,36 @@
-Metadata-Version: 2.1
-Name: mypy-boto3-kinesis
-Version: 1.35.26
-Summary: Type annotations for boto3.Kinesis 1.35.26 service generated with mypy-boto3-builder 8.1.2
-Home-page: https://github.com/youtype/mypy_boto3_builder
-Author: Vlad Emelianov
-Author-email: vlad.emelianov.nz@gmail.com
-License: MIT License
-Project-URL: Documentation, https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/
-Project-URL: Source, https://github.com/youtype/mypy_boto3_builder
-Project-URL: Tracker, https://github.com/youtype/mypy_boto3_builder/issues
-Keywords: boto3 kinesis type-annotations botocore mypy typeshed autocomplete
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Environment :: Console
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-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
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Typing :: Stubs Only
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typing-extensions>=4.1.0; python_version < "3.12"
-
 <a id="mypy-boto3-kinesis"></a>
 
 # mypy-boto3-kinesis
 
-[![PyPI - mypy-boto3-kinesis](https://img.shields.io/pypi/v/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-kinesis)](https://pepy.tech/project/mypy-boto3-kinesis)
+[![PyPI - mypy-boto3-kinesis](https://img.shields.io/pypi/v/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-kinesis.svg?color=blue)](https://pypi.org/project/mypy-boto3-kinesis/)
+[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/)
+[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-kinesis)](https://pypistats.org/packages/mypy-boto3-kinesis)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.Kinesis 1.35.26](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis.html#Kinesis)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 Kinesis 1.36.0](https://pypi.org/project/boto3/)
+compatible with [VSCode](https://code.visualstudio.com/),
 [PyCharm](https://www.jetbrains.com/pycharm/),
 [Emacs](https://www.gnu.org/software/emacs/),
 [Sublime Text](https://www.sublimetext.com/),
 [mypy](https://github.com/python/mypy),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
-Generated by
-[mypy-boto3-builder 8.1.2](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.8.0](https://github.com/youtype/mypy_boto3_builder).
 
 More information can be found on
 [boto3-stubs](https://pypi.org/project/boto3-stubs/) page and in
 [mypy-boto3-kinesis docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis/).
 
-See how it helps to find and fix potential bugs:
+See how it helps you find and fix potential bugs:
 
-![boto3-stubs demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
+![types-boto3 demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
 
 - [mypy-boto3-kinesis](#mypy-boto3-kinesis)
   - [How to install](#how-to-install)
+    - [Generate locally (recommended)](<#generate-locally-(recommended)>)
     - [VSCode extension](#vscode-extension)
     - [From PyPI with pip](#from-pypi-with-pip)
   - [How to uninstall](#how-to-uninstall)
@@ -75,6 +42,7 @@ See how it helps to find and fix potential bugs:
     - [Other IDEs](#other-ides)
     - [mypy](#mypy)
     - [pyright](#pyright)
+    - [Pylint compatibility](#pylint-compatibility)
   - [Explicit type annotations](#explicit-type-annotations)
     - [Client annotations](#client-annotations)
     - [Paginators annotations](#paginators-annotations)
@@ -94,6 +62,21 @@ See how it helps to find and fix potential bugs:
 
 ## How to install
 
+<a id="generate-locally-(recommended)"></a>
+
+### Generate locally (recommended)
+
+You can generate type annotations for `boto3` package locally with
+`mypy_boto3_builder`. Use
+[uv](https://docs.astral.sh/uv/getting-started/installation/) for build
+isolation.
+
+1. Run mypy-boto3-builder in your package root directory:
+   `uvx --with 'boto3==1.36.0' mypy_boto3_builder`
+2. Select `boto3-stubs` AWS SDK.
+3. Add `Kinesis` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -114,12 +97,10 @@ Install `boto3-stubs` for `Kinesis` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[kinesis]'
 
-
 # Lite version does not provide session.client/resource overloads
 # it is more RAM-friendly, but requires explicit type annotations
 python -m pip install 'boto3-stubs-lite[kinesis]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-kinesis
 ```
@@ -158,16 +139,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[kinesis]` in your environment:
+> ⚠️ Due to slow PyCharm performance on `Literal` overloads (issue
+> [PY-40997](https://youtrack.jetbrains.com/issue/PY-40997)), it is recommended
+> to use [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/) until
+> the issue is resolved.
+
+> ⚠️ If you experience slow performance and high CPU usage, try to disable
+> `PyCharm` type checker and use [mypy](https://github.com/python/mypy) or
+> [pyright](https://github.com/microsoft/pyright) instead.
+
+> ⚠️ To continue using `PyCharm` type checker, you can try to replace
+> `boto3-stubs` with
+> [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/):
 
 ```bash
-python -m pip install 'boto3-stubs-lite[kinesis]'`
+pip uninstall boto3-stubs
+pip install boto3-stubs-lite
 ```
 
-Both type checking and code completion should now work. Explicit type
-annotations **are required**.
+Install `boto3-stubs[kinesis]` in your environment:
 
-Use `boto3-stubs` package instead for implicit type discovery.
+```bash
+python -m pip install 'boto3-stubs[kinesis]'
+```
+
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -253,6 +249,31 @@ Optionally, you can install `boto3-stubs` to `typings` directory.
 Type checking should now work. No explicit type annotations required, write
 your `boto3` code as usual.
 
+<a id="pylint-compatibility"></a>
+
+### Pylint compatibility
+
+It is totally safe to use `TYPE_CHECKING` flag in order to avoid
+`mypy-boto3-kinesis` dependency in production. However, there is an issue in
+`pylint` that it complains about undefined variables. To fix it, set all types
+to `object` in non-`TYPE_CHECKING` mode.
+
+```python
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from mypy_boto3_ec2 import EC2Client, EC2ServiceResource
+    from mypy_boto3_ec2.waiters import BundleTaskCompleteWaiter
+    from mypy_boto3_ec2.paginators import DescribeVolumesPaginator
+else:
+    EC2Client = object
+    EC2ServiceResource = object
+    BundleTaskCompleteWaiter = object
+    DescribeVolumesPaginator = object
+
+...
+```
+
 <a id="explicit-type-annotations"></a>
 
 ## Explicit type annotations

mypy_boto3_kinesis-1.35.26/mypy_boto3_kinesis/__init__.pyi → mypy_boto3_kinesis-1.36.0/mypy_boto3_kinesis/__init__.py

@@ -27,6 +27,8 @@ Usage::
     list_stream_consumers_paginator: ListStreamConsumersPaginator = client.get_paginator("list_stream_consumers")
     list_streams_paginator: ListStreamsPaginator = client.get_paginator("list_streams")
     ```
+
+Copyright 2025 Vlad Emelianov
 """
 
 from .client import KinesisClient
@@ -40,6 +42,7 @@ from .waiter import StreamExistsWaiter, StreamNotExistsWaiter
 
 Client = KinesisClient
 
+
 __all__ = (
     "Client",
     "DescribeStreamPaginator",

mypy_boto3_kinesis-1.35.26/mypy_boto3_kinesis/__init__.py → mypy_boto3_kinesis-1.36.0/mypy_boto3_kinesis/__init__.pyi

@@ -27,6 +27,8 @@ Usage::
     list_stream_consumers_paginator: ListStreamConsumersPaginator = client.get_paginator("list_stream_consumers")
     list_streams_paginator: ListStreamsPaginator = client.get_paginator("list_streams")
     ```
+
+Copyright 2025 Vlad Emelianov
 """
 
 from .client import KinesisClient
@@ -40,7 +42,6 @@ from .waiter import StreamExistsWaiter, StreamNotExistsWaiter
 
 Client = KinesisClient
 
-
 __all__ = (
     "Client",
     "DescribeStreamPaginator",

{mypy_boto3_kinesis-1.35.26 → mypy_boto3_kinesis-1.36.0}/mypy_boto3_kinesis/__main__.py

@@ -1,5 +1,7 @@
 """
 Main CLI entrypoint.
+
+Copyright 2025 Vlad Emelianov
 """
 
 import sys
@@ -9,14 +11,14 @@ def print_info() -> None:
     """
     Print package info to stdout.
     """
-    print(
-        "Type annotations for boto3.Kinesis 1.35.26\n"
-        "Version:         1.35.26\n"
-        "Builder version: 8.1.2\n"
+    sys.stdout.write(
+        "Type annotations for boto3 Kinesis 1.36.0\n"
+        "Version:         1.36.0\n"
+        "Builder version: 8.8.0\n"
         "Docs:            https://youtype.github.io/boto3_stubs_docs/mypy_boto3_kinesis//\n"
-        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis.html#Kinesis\n"
+        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis.html#kinesis\n"
         "Other services:  https://pypi.org/project/boto3-stubs/\n"
-        "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases"
+        "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases\n"
     )
 
 
@@ -24,7 +26,7 @@ def print_version() -> None:
     """
     Print package version to stdout.
     """
-    print("1.35.26")
+    sys.stdout.write("1.36.0\n")
 
 
 def main() -> None:
@@ -32,7 +34,8 @@ def main() -> None:
     Main CLI entrypoint.
     """
     if "--version" in sys.argv:
-        return print_version()
+        print_version()
+        return
     print_info()