{"id":6732,"library":"mypy-boto3-simpledbv2","title":"mypy-boto3-simpledbv2","description":"mypy-boto3-simpledbv2 provides precise type annotations for the boto3 SimpleDBv2 client, enhancing type checking for AWS SDK usage. It is part of the `mypy-boto3` project, which generates stubs for all boto3 services. The current version is 1.42.66, and it updates frequently, typically in sync with `boto3` and `botocore` releases.","status":"active","version":"1.42.66","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","boto3","mypy","type-hints","stubs","simpledbv2","type-checking"],"install":[{"cmd":"pip install mypy-boto3-simpledbv2","lang":"bash","label":"Install package"}],"dependencies":[{"reason":"Required at runtime to use the AWS SDK; this package only provides type annotations, not the SDK itself.","package":"boto3","optional":false}],"imports":[{"note":"The raw boto3 client does not provide full type hints. Import the typed client from mypy-boto3-simpledbv2.","wrong":"from boto3.client import SimpleDBv2Client","symbol":"SimpleDBv2Client","correct":"from mypy_boto3_simpledbv2.client import SimpleDBv2Client"},{"note":"Type definitions for request/response payloads are found in `type_defs`.","symbol":"CreateDomainRequestTypeDef","correct":"from mypy_boto3_simpledbv2.type_defs import CreateDomainRequestTypeDef"},{"note":"Common exceptions like ClientError are part of botocore, which boto3 uses internally.","symbol":"ClientError","correct":"from botocore.exceptions import ClientError"}],"quickstart":{"code":"import boto3\nfrom mypy_boto3_simpledbv2.client import SimpleDBv2Client\nfrom botocore.exceptions import ClientError\n\ndef list_simpledb_domains():\n    \"\"\"Lists SimpleDB domains using a typed boto3 client.\"\"\"\n    try:\n        # Initialize a typed SimpleDBv2 client\n        client: SimpleDBv2Client = boto3.client(\"sdb\")\n\n        # List domains with type-hinted response\n        response = client.list_domains(MaxNumberOfDomains=10)\n        \n        print(f\"SimpleDB Domains: {response.get('DomainNames', [])}\")\n        if response.get(\"NextToken\"):\n            print(\"More domains available (use NextToken).\")\n\n    except ClientError as e:\n        print(f\"Error listing SimpleDB domains: {e}\")\n    except Exception as e:\n        print(f\"An unexpected error occurred: {e}\")\n\nif __name__ == \"__main__\":\n    # Ensure AWS credentials are configured (e.g., via environment variables, ~/.aws/credentials)\n    list_simpledb_domains()\n","lang":"python","description":"This quickstart demonstrates how to initialize a type-hinted SimpleDBv2 client and list available domains. The `mypy-boto3-simpledbv2` package provides the `SimpleDBv2Client` type, allowing static analysis tools like Mypy to verify your code against the AWS API."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or newer. If you must use Python 3.8, use an older `mypy-boto3` version (e.g., `<8.8.0` for builder versions before 8.8.0 reintroduced 3.8 support, or `<8.12.0` for versions after that, but before the final drop in 8.12.0).","message":"As of `mypy-boto3-builder` version 8.12.0 (which generated this package version), Python 3.8 support has been dropped. All `mypy-boto3` packages now require Python 3.9 or higher.","severity":"breaking","affected_versions":">=8.12.0"},{"fix":"Review and update any explicit TypeDef annotations in your code to match the new, potentially shorter, generated names. Refer to the specific `mypy_boto3_simpledbv2.type_defs` module for correct names.","message":"Beginning with `mypy-boto3-builder` version 8.9.0, some TypeDef naming conventions were changed (e.g., `CreateDistributionRequestRequestTypeDef` might become `CreateDistributionRequestTypeDef`). While the specific example is for a different service, this is a builder-wide change that may affect explicit type annotations in your code for SimpleDBv2 request/response payloads.","severity":"breaking","affected_versions":">=8.9.0"},{"fix":"Ensure `boto3` is installed in your environment: `pip install boto3`.","message":"This package only provides type stubs. You must install `boto3` separately for actual AWS API calls. This package does not install `boto3` as a dependency.","severity":"gotcha","affected_versions":"*"},{"fix":"Install separate stub packages for each boto3 service you intend to type-check (e.g., `pip install mypy-boto3-s3 mypy-boto3-ec2`). Alternatively, install `mypy-boto3` for all stubs (`pip install mypy-boto3`).","message":"Each AWS service requires its own `mypy-boto3-<service-name>` package for comprehensive type checking. Installing `mypy-boto3-simpledbv2` only provides types for SimpleDBv2, not other services like S3 or EC2.","severity":"gotcha","affected_versions":"*"},{"fix":"Remove any `mypy_boto3.mypy_plugin.Boto3Plugin` entries from your `mypy.ini` or similar configuration files. Rely on PEP 561 discovery.","message":"As of `mypy-boto3-builder` version 8.12.0, all packages migrated to PEP 561 compliance. This means `mypy` should automatically discover the type stubs without explicit configuration in `mypy.ini` (e.g., `plugins`). If you have old `mypy.ini` configurations for `mypy-boto3` plugins, they might now cause issues.","severity":"gotcha","affected_versions":">=8.12.0"}],"env_vars":null,"last_verified":"2026-04-15T00:00:00.000Z","next_check":"2026-07-14T00:00:00.000Z","problems":[]}