{"id":3580,"library":"mypy-boto3-finspace-data","title":"mypy-boto3-finspace-data Type Annotations","description":"This package provides type annotations for the `boto3` FinSpaceData service, generated with `mypy-boto3-builder`. It ensures type checking for your AWS FinSpaceData client code. The current version is 1.42.3, and releases are frequent, typically in sync with new `boto3` and `botocore` versions, or when new AWS service features are released.","status":"active","version":"1.42.3","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","boto3","types","mypy","finspace-data","type-checking"],"install":[{"cmd":"pip install mypy-boto3-finspace-data","lang":"bash","label":"Install package"}],"dependencies":[{"reason":"Provides the actual runtime functionality; this package only offers type stubs.","package":"boto3"}],"imports":[{"note":"Client types are nested under the 'client' submodule.","wrong":"from mypy_boto3_finspace_data import FinSpaceDataClient","symbol":"FinSpaceDataClient","correct":"from mypy_boto3_finspace_data.client import FinSpaceDataClient"},{"note":"All `TypedDict` definitions for API responses and request parameters are found in the `type_defs` submodule.","symbol":"ListChangesetsResponseTypeDef","correct":"from mypy_boto3_finspace_data.type_defs import ListChangesetsResponseTypeDef"}],"quickstart":{"code":"from typing import TYPE_CHECKING\nimport boto3\n\nif TYPE_CHECKING:\n    from mypy_boto3_finspace_data.client import FinSpaceDataClient\n    from mypy_boto3_finspace_data.type_defs import ListChangesetsResponseTypeDef\n\ntry:\n    # Initialize the boto3 client for FinSpaceData\n    client: FinSpaceDataClient = boto3.client('finspace-data')\n\n    # Example API call: ListChangesets\n    # Note: Replace 'your-dataset-id' with an actual FinSpaceData dataset ID\n    # or use a placeholder for type checking demonstration.\n    dataset_id = 'your-dataset-id' # os.environ.get('FINSPACE_DATA_DATASET_ID', 'placeholder')\n\n    if dataset_id == 'your-dataset-id':\n        print(\"Please provide a valid FinSpaceData dataset ID for a successful API call.\")\n        # For demonstration, we'll simulate a response structure for type checking.\n        response: ListChangesetsResponseTypeDef = {\n            'changesets': [],\n            'nextToken': 'string',\n            'ResponseMetadata': {\n                'RequestId': 'string',\n                'HTTPStatusCode': 200,\n                'HTTPHeaders': {},\n                'RetryAttempts': 0\n            }\n        }\n    else:\n        response = client.list_changesets(datasetId=dataset_id)\n        print(f\"Successfully listed changesets for dataset '{dataset_id}'.\")\n        print(f\"First changeset ID: {response['changesets'][0]['changesetId'] if response['changesets'] else 'N/A'}\")\n\n    # Type check the response structure\n    _ = response['changesets']\n    _ = response['ResponseMetadata']\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")","lang":"python","description":"This example demonstrates how to initialize a `boto3` client with type hints from `mypy-boto3-finspace-data` and make a sample API call. The `TYPE_CHECKING` block ensures these imports are only used by type checkers, not at runtime."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or higher. If you must use Python 3.8, pin `mypy-boto3-finspace-data` to a version prior to 8.12.0 (e.g., `<8.12.0`).","message":"Support for Python 3.8 was removed in version 8.12.0 of the `mypy-boto3-builder`, which affects all generated service packages, including `mypy-boto3-finspace-data`. Projects using Python 3.8 will need to upgrade to Python 3.9+.","severity":"breaking","affected_versions":">=8.12.0"},{"fix":"Review and update `TypedDict` names in your type annotations to match the new, potentially shorter, generated names. Refer to the specific service's `type_defs.pyi` for exact names.","message":"Version 8.9.0 of the builder introduced changes to how `TypedDict` names are generated for certain API parameters and responses (e.g., shortening `CreateDistributionRequestRequestTypeDef` to `CreateDistributionRequestTypeDef`). This can cause type checking errors if your code relies on the old, longer `TypedDict` names.","severity":"breaking","affected_versions":">=8.9.0"},{"fix":"Ensure `boto3` is installed alongside `mypy-boto3-finspace-data`: `pip install boto3 mypy-boto3-finspace-data`.","message":"This package provides only type stubs (interface definitions) for `boto3`. It does not contain any runtime code. You must install `boto3` (and its dependencies like `botocore`) separately for your code to execute.","severity":"gotcha","affected_versions":"all"},{"fix":"Align `mypy-boto3-finspace-data` and `boto3` versions as closely as possible, typically by updating both to their latest compatible versions.","message":"For optimal type checking, the major and minor version of `mypy-boto3-finspace-data` should ideally match your installed `boto3` version. Mismatched versions can lead to incorrect or missing type definitions, especially with new API features or changes.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}