{"id":5736,"library":"types-botocore","title":"Type Stubs for botocore (Deprecated)","description":"This is a deprecated proxy package that historically provided type stubs for `botocore`. It has been superseded by `mypy-boto3-botocore` and other comprehensive stub packages generated by the `mypy_boto3_builder` project. Users should avoid installing this package, as its version is extremely outdated and it will not provide accurate or complete type hints for modern `botocore` versions.","status":"deprecated","version":"1.0.2","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["type-stubs","botocore","aws","mypy","deprecated"],"install":[{"cmd":"pip install types-botocore","lang":"bash","label":"Deprecated: Do not use this package"}],"dependencies":[],"imports":[{"note":"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.","symbol":"Client","correct":"from botocore.client import Client"}],"quickstart":{"code":"import boto3\nfrom typing import TYPE_CHECKING\n\n# NOTE: Do NOT install 'types-botocore'. It is deprecated.\n# Instead, install 'mypy-boto3' for comprehensive type stubs for boto3 and botocore.\n# pip install mypy-boto3\n\n# Example usage with proper type stubs (via mypy-boto3):\n\nif TYPE_CHECKING:\n    # These imports are for type checking only and are provided by mypy-boto3-s3\n    from mypy_boto3_s3.client import S3Client\n    from mypy_boto3_s3.type_defs import CreateBucketOutputTypeDef\n\n\ndef create_s3_bucket(bucket_name: str, region: str) -> None:\n    # When mypy-boto3 is installed, boto3.client('s3') will be correctly typed.\n    # For explicit type annotation, you can use the imported S3Client type.\n    client: S3Client = boto3.client('s3', region_name=region)\n    print(f\"Attempting to create bucket: {bucket_name} in {region}\")\n    try:\n        response: CreateBucketOutputTypeDef = client.create_bucket(\n            Bucket=bucket_name,\n            CreateBucketConfiguration={'LocationConstraint': region}\n        )\n        print(f\"Bucket creation successful: {response}\")\n    except client.exceptions.BucketAlreadyOwnedByYou:\n        print(f\"Bucket {bucket_name} already exists and is owned by you.\")\n    except Exception as e:\n        print(f\"Error creating bucket: {e}\")\n\n\nif __name__ == \"__main__\":\n    # Replace with your desired bucket name and region\n    # Use environment variables for sensitive info in real applications\n    # Or ensure AWS credentials are configured (e.g., via ~/.aws/credentials)\n    test_bucket_name = \"my-unique-test-bucket-1234567890\"\n    test_region = \"us-east-1\"\n    create_s3_bucket(test_bucket_name, test_region)\n","lang":"python","description":"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."},"warnings":[{"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`.","message":"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.","severity":"breaking","affected_versions":"1.0.2 and earlier"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer to the `mypy-boto3-builder` GitHub repository and documentation for current information, releases, and changelogs related to `botocore` type stubs.","message":"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.","severity":"breaking","affected_versions":"All versions of `types-botocore` (1.0.2)"}],"env_vars":null,"last_verified":"2026-04-13T00:00:00.000Z","next_check":"2026-07-12T00:00:00.000Z"}