{"id":3835,"library":"types-aiobotocore-rds","title":"Type Annotations for aiobotocore RDS","description":"types-aiobotocore-rds provides static type annotations for the aiobotocore RDS service. It enables robust type checking and improved code completion for asynchronous AWS interactions in tools like VSCode, PyCharm, mypy, and pyright. This package is generated by the mypy-boto3-builder project and is currently at version 3.4.0, generated with builder version 8.12.0, with ongoing active development.","status":"active","version":"3.4.0","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["typing","aws","aiobotocore","rds","stubs","mypy","pyright","type-hints","async"],"install":[{"cmd":"pip install types-aiobotocore-rds aiobotocore","lang":"bash","label":"Install standalone types-aiobotocore-rds and aiobotocore"}],"dependencies":[{"reason":"Provides the underlying asynchronous AWS client library that these type annotations are for. This package only adds types, it does not include the runtime library.","package":"aiobotocore","optional":false},{"reason":"Minimum Python version required.","package":"python","optional":false,"version_range":">=3.9"}],"imports":[{"note":"The actual aiobotocore client does not provide type hints directly, you must import the type from types_aiobotocore_rds.client for type checking.","wrong":"from aiobotocore.client import RDSClient","symbol":"RDSClient","correct":"from types_aiobotocore_rds.client import RDSClient"},{"note":"Use this pattern to import specific TypeDefs for request/response payloads.","symbol":"DBInstanceTypeDef","correct":"from types_aiobotocore_rds.type_defs import DBInstanceTypeDef"}],"quickstart":{"code":"import asyncio\nfrom typing import TYPE_CHECKING\n\nimport aiobotocore.session\n\nif TYPE_CHECKING:\n    from types_aiobotocore_rds.client import RDSClient\n    from types_aiobotocore_rds.type_defs import DBInstanceMessageTypeDef\n\n\nasync def describe_rds_instances():\n    session = aiobotocore.session.get_session()\n    async with session.create_client(\"rds\") as client:\n        if TYPE_CHECKING:\n            client: RDSClient # Explicit type annotation for the client\n\n        print(\"Describing RDS DB instances...\")\n        response: DBInstanceMessageTypeDef = await client.describe_db_instances()\n\n        for db_instance in response.get(\"DBInstances\", []):\n            print(f\"  DB Instance Identifier: {db_instance.get('DBInstanceIdentifier')}\")\n            print(f\"  DB Instance Status: {db_instance.get('DBInstanceStatus')}\")\n            print(f\"  Engine: {db_instance.get('Engine')}\")\n            print(f\"  Endpoint: {db_instance.get('Endpoint', {}).get('Address')}:{db_instance.get('Endpoint', {}).get('Port')}\")\n\n        print(\"Description complete.\")\n\nif __name__ == \"__main__\":\n    asyncio.run(describe_rds_instances())\n","lang":"python","description":"This quickstart demonstrates how to use `types-aiobotocore-rds` to add type annotations to an `aiobotocore` RDS client. It fetches and prints details of RDS DB instances using explicit type hints for the client and the response payload, ensuring better type checking and IDE support. Remember to set up AWS credentials for the code to execute successfully."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or higher.","message":"Support for Python 3.8 was removed from `mypy-boto3-builder` version 8.12.0 and consequently from `types-aiobotocore-rds` version 3.x.x. Users on Python 3.8 should upgrade to Python 3.9 or newer.","severity":"breaking","affected_versions":">=3.x.x (generated with mypy-boto3-builder >= 8.12.0)"},{"fix":"Review your imports and usage of TypeDefs, as their names may have changed. Refer to the specific service's documentation for updated TypeDef names if you encounter `ImportError` or `NameError`.","message":"Type Definition (TypeDef) naming conventions changed in `mypy-boto3-builder` version 8.9.0. Some TypeDefs for method arguments now use shorter names (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`), and conflicting `Extra` postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` became `CreateDistributionRequestExtraTypeDef`).","severity":"breaking","affected_versions":">=3.x.x (generated with mypy-boto3-builder >= 8.9.0)"},{"fix":"Ensure `aiobotocore` is installed in your environment: `pip install aiobotocore`.","message":"This package (`types-aiobotocore-rds`) only provides type annotations. You must also install `aiobotocore` (and its dependencies) for the code to run at runtime. Without `aiobotocore`, your code will fail with `ModuleNotFoundError`.","severity":"gotcha","affected_versions":"all"},{"fix":"Consider installing `types-aiobotocore-lite` instead (e.g., `pip install 'types-aiobotocore-lite[rds]'`) or disable PyCharm's internal type checker and use an external one like `mypy` or `pyright`.","message":"PyCharm users might experience slow performance or high CPU usage due to `Literal` overloads (PyCharm issue PY-40997). The project recommends using `types-aiobotocore-lite` as a workaround for this specific IDE issue.","severity":"gotcha","affected_versions":"all (when using PyCharm)"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}