Type Stubs for botocore (Deprecated)

Warnings

• breaking The `types-botocore` package is deprecated and no longer actively maintained. Its version 1.0.2 is extremely outdated and will not provide accurate or complete type stubs for modern `botocore` versions.
  Fix: Install `mypy-boto3` to get comprehensive type stubs for `botocore` (via `mypy-boto3-botocore`) and `boto3`. For example: `pip install mypy-boto3`. For `botocore` stubs specifically, you can use `mypy-boto3-botocore`.
• gotcha Installing `types-botocore` will not provide the expected type-checking functionality or IDE auto-completion for current `botocore` usage. It's a legacy package that has been superseded by the robust `mypy_boto3_builder` ecosystem.
  Fix: Always use `mypy-boto3` (or `mypy-boto3-botocore` for just botocore stubs) for up-to-date and complete type stubs compatible with modern `botocore` versions.
• breaking The release notes provided in the prompt (e.g., versions like `8.12.0`, `8.11.0`) are for the `mypy_boto3_builder` project and its generated stub packages (like `mypy-boto3` and `mypy-boto3-botocore`), *not* for the `types-botocore` package itself. `types-botocore` is explicitly stuck at version 1.0.2.
  Fix: Refer to the `mypy-boto3-builder` GitHub repository and documentation for current information, releases, and changelogs related to `botocore` type stubs.

Install

• pip install types-botocore Deprecated: Do not use this package

Imports

• Client

  from botocore.client import Client

  This package (`types-botocore`) is deprecated. For actual type hints, install `mypy-boto3-botocore` (or `mypy-boto3` for the full suite) and rely on it to add type hints to standard `botocore` usage, or import types like `from mypy_boto3_botocore.client import BotocoreClient` for direct access to generated types.

Quickstart

This quickstart demonstrates how to use `mypy-boto3` to get type stubs for `botocore` (and `boto3`). It specifically advises *against* installing `types-botocore` due to its deprecated status. The example shows how to correctly type an S3 client and call a method, relying on `mypy-boto3` for accurate type hints.

import boto3
from typing import TYPE_CHECKING

# NOTE: Do NOT install 'types-botocore'. It is deprecated.
# Instead, install 'mypy-boto3' for comprehensive type stubs for boto3 and botocore.
# pip install mypy-boto3

# Example usage with proper type stubs (via mypy-boto3):

if TYPE_CHECKING:
    # These imports are for type checking only and are provided by mypy-boto3-s3
    from mypy_boto3_s3.client import S3Client
    from mypy_boto3_s3.type_defs import CreateBucketOutputTypeDef


def create_s3_bucket(bucket_name: str, region: str) -> None:
    # When mypy-boto3 is installed, boto3.client('s3') will be correctly typed.
    # For explicit type annotation, you can use the imported S3Client type.
    client: S3Client = boto3.client('s3', region_name=region)
    print(f"Attempting to create bucket: {bucket_name} in {region}")
    try:
        response: CreateBucketOutputTypeDef = client.create_bucket(
            Bucket=bucket_name,
            CreateBucketConfiguration={'LocationConstraint': region}
        )
        print(f"Bucket creation successful: {response}")
    except client.exceptions.BucketAlreadyOwnedByYou:
        print(f"Bucket {bucket_name} already exists and is owned by you.")
    except Exception as e:
        print(f"Error creating bucket: {e}")


if __name__ == "__main__":
    # Replace with your desired bucket name and region
    # Use environment variables for sensitive info in real applications
    # Or ensure AWS credentials are configured (e.g., via ~/.aws/credentials)
    test_bucket_name = "my-unique-test-bucket-1234567890"
    test_region = "us-east-1"
    create_s3_bucket(test_bucket_name, test_region)