mypy-boto3-batch 1.35.53__tar.gz → 1.35.83__tar.gz

{mypy_boto3_batch-1.35.53 → mypy_boto3_batch-1.35.83}/PKG-INFO

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

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

@@ -24,6 +24,8 @@ Usage::
     list_jobs_paginator: ListJobsPaginator = client.get_paginator("list_jobs")
     list_scheduling_policies_paginator: ListSchedulingPoliciesPaginator = client.get_paginator("list_scheduling_policies")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import BatchClient
@@ -37,6 +39,7 @@ from .paginator import (
 
 Client = BatchClient
 
+
 __all__ = (
     "BatchClient",
     "Client",

mypy_boto3_batch-1.35.53/mypy_boto3_batch/__init__.py → mypy_boto3_batch-1.35.83/mypy_boto3_batch/__init__.pyi

@@ -24,6 +24,8 @@ Usage::
     list_jobs_paginator: ListJobsPaginator = client.get_paginator("list_jobs")
     list_scheduling_policies_paginator: ListSchedulingPoliciesPaginator = client.get_paginator("list_scheduling_policies")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import BatchClient
@@ -37,7 +39,6 @@ from .paginator import (
 
 Client = BatchClient
 
-
 __all__ = (
     "BatchClient",
     "Client",

{mypy_boto3_batch-1.35.53 → mypy_boto3_batch-1.35.83}/mypy_boto3_batch/__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.Batch 1.35.53\n"
-        "Version:         1.35.53\n"
-        "Builder version: 8.1.4\n"
+        "Type annotations for boto3 Batch 1.35.83\n"
+        "Version:         1.35.83\n"
+        "Builder version: 8.6.4\n"
         "Docs:            https://youtype.github.io/boto3_stubs_docs/mypy_boto3_batch//\n"
-        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/batch.html#Batch\n"
+        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/batch.html#batch\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.53")
+    print("1.35.83")
 
 
 def main() -> None: