mypy-boto3-eks 1.35.57__tar.gz → 1.35.81__tar.gz

{mypy_boto3_eks-1.35.57 → mypy_boto3_eks-1.35.81}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: mypy-boto3-eks
-Version: 1.35.57
-Summary: Type annotations for boto3.EKS 1.35.57 service generated with mypy-boto3-builder 8.2.1
+Version: 1.35.81
+Summary: Type annotations for boto3 EKS 1.35.81 service generated with mypy-boto3-builder 8.6.3
 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_eks/
 Project-URL: Source, https://github.com/youtype/mypy_boto3_builder
 Project-URL: Tracker, https://github.com/youtype/mypy_boto3_builder/issues
-Keywords: boto3 eks type-annotations botocore mypy typeshed autocomplete
+Keywords: boto3 eks boto3-stubs type-annotations mypy typeshed autocomplete
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Environment :: Console
@@ -36,35 +36,35 @@ Requires-Dist: typing-extensions>=4.1.0; python_version < "3.12"
 
 # mypy-boto3-eks
 
-[![PyPI - mypy-boto3-eks](https://img.shields.io/pypi/v/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_eks/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-eks)](https://pepy.tech/project/mypy-boto3-eks)
+[![PyPI - mypy-boto3-eks](https://img.shields.io/pypi/v/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks/)
+[![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-eks)](https://pypistats.org/packages/mypy-boto3-eks)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.EKS 1.35.57](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/eks.html#EKS)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 EKS 1.35.81](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.2.1](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.6.3](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-eks docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_eks/).
 
-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-eks](#mypy-boto3-eks)
   - [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)
@@ -76,6 +76,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)
@@ -95,6 +96,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.35.81' mypy_boto3_builder`
+2. Select `boto3 (legacy boto3-stubs)` AWS SDK.
+3. Add `EKS` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -115,12 +131,10 @@ Install `boto3-stubs` for `EKS` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[eks]'
 
-
 # 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[eks]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-eks
 ```
@@ -159,16 +173,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[eks]` 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[eks]'
+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[eks]` in your environment:
 
-Use `boto3-stubs` package instead for implicit type discovery.
+```bash
+python -m pip install 'boto3-stubs[eks]'
+```
+
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -254,6 +283,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-eks` 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_eks-1.35.57 → mypy_boto3_eks-1.35.81}/README.md

@@ -2,35 +2,35 @@
 
 # mypy-boto3-eks
 
-[![PyPI - mypy-boto3-eks](https://img.shields.io/pypi/v/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_eks/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-eks)](https://pepy.tech/project/mypy-boto3-eks)
+[![PyPI - mypy-boto3-eks](https://img.shields.io/pypi/v/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-eks.svg?color=blue)](https://pypi.org/project/mypy-boto3-eks/)
+[![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-eks)](https://pypistats.org/packages/mypy-boto3-eks)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.EKS 1.35.57](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/eks.html#EKS)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 EKS 1.35.81](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.2.1](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.6.3](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-eks docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_eks/).
 
-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-eks](#mypy-boto3-eks)
   - [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)
@@ -42,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)
@@ -61,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.35.81' mypy_boto3_builder`
+2. Select `boto3 (legacy boto3-stubs)` AWS SDK.
+3. Add `EKS` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -81,12 +97,10 @@ Install `boto3-stubs` for `EKS` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[eks]'
 
-
 # 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[eks]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-eks
 ```
@@ -125,16 +139,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[eks]` 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[eks]'
+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[eks]` in your environment:
 
-Use `boto3-stubs` package instead for implicit type discovery.
+```bash
+python -m pip install 'boto3-stubs[eks]'
+```
+
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -220,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-eks` 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_eks-1.35.57/mypy_boto3_eks/__init__.pyi → mypy_boto3_eks-1.35.81/mypy_boto3_eks/__init__.py

@@ -57,6 +57,8 @@ Usage::
     list_pod_identity_associations_paginator: ListPodIdentityAssociationsPaginator = client.get_paginator("list_pod_identity_associations")
     list_updates_paginator: ListUpdatesPaginator = client.get_paginator("list_updates")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import EKSClient
@@ -88,6 +90,7 @@ from .waiter import (
 
 Client = EKSClient
 
+
 __all__ = (
     "AddonActiveWaiter",
     "AddonDeletedWaiter",

mypy_boto3_eks-1.35.57/mypy_boto3_eks/__init__.py → mypy_boto3_eks-1.35.81/mypy_boto3_eks/__init__.pyi

@@ -57,6 +57,8 @@ Usage::
     list_pod_identity_associations_paginator: ListPodIdentityAssociationsPaginator = client.get_paginator("list_pod_identity_associations")
     list_updates_paginator: ListUpdatesPaginator = client.get_paginator("list_updates")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import EKSClient
@@ -88,7 +90,6 @@ from .waiter import (
 
 Client = EKSClient
 
-
 __all__ = (
     "AddonActiveWaiter",
     "AddonDeletedWaiter",

{mypy_boto3_eks-1.35.57 → mypy_boto3_eks-1.35.81}/mypy_boto3_eks/__main__.py

@@ -1,5 +1,7 @@
 """
 Main CLI entrypoint.
+
+Copyright 2024 Vlad Emelianov
 """
 
 import sys
@@ -10,11 +12,11 @@ def print_info() -> None:
     Print package info to stdout.
     """
     print(
-        "Type annotations for boto3.EKS 1.35.57\n"
-        "Version:         1.35.57\n"
-        "Builder version: 8.2.1\n"
+        "Type annotations for boto3 EKS 1.35.81\n"
+        "Version:         1.35.81\n"
+        "Builder version: 8.6.3\n"
         "Docs:            https://youtype.github.io/boto3_stubs_docs/mypy_boto3_eks//\n"
-        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/eks.html#EKS\n"
+        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/eks.html#eks\n"
         "Other services:  https://pypi.org/project/boto3-stubs/\n"
         "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases"
     )
@@ -24,7 +26,7 @@ def print_version() -> None:
     """
     Print package version to stdout.
     """
-    print("1.35.57")
+    print("1.35.81")
 
 
 def main() -> None: