{"id":3705,"library":"mypy-boto3-ssm-guiconnect","title":"mypy-boto3-ssm-guiconnect Type Annotations","description":"mypy-boto3-ssm-guiconnect provides comprehensive type annotations for the AWS SSM GUIConnect service, designed to be used with `boto3`. It enables static analysis tools like `mypy` to perform rigorous type checking on `boto3` calls related to SSM GUIConnect resources, enhancing code reliability. The library is automatically generated by `mypy-boto3-builder` and its version (currently 1.42.3) synchronizes with `boto3`'s service definitions, with frequent updates.","status":"active","version":"1.42.3","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","boto3","mypy","type-hinting","ssm-guiconnect","static-analysis"],"install":[{"cmd":"pip install mypy-boto3-ssm-guiconnect","lang":"bash","label":"Install package"}],"dependencies":[{"reason":"Provides the AWS SDK for Python at runtime; this package only offers type stubs for it. `boto3` must be installed separately.","package":"boto3","optional":false}],"imports":[{"symbol":"SSMGUIConnectClient","correct":"from mypy_boto3_ssm_guiconnect import SSMGUIConnectClient"},{"note":"While importing directly from `.literals` may work, the top-level import is generally preferred for common symbols via the package's `__init__.pyi`.","wrong":"from mypy_boto3_ssm_guiconnect.literals import SSMGUIConnectServiceName","symbol":"SSMGUIConnectServiceName","correct":"from mypy_boto3_ssm_guiconnect import SSMGUIConnectServiceName"},{"note":"Specific Type Definition classes are typically located in the `type_defs` submodule for clarity.","wrong":"from mypy_boto3_ssm_guiconnect import DescribeConnectionsResponseTypeDef","symbol":"DescribeConnectionsResponseTypeDef","correct":"from mypy_boto3_ssm_guiconnect.type_defs import DescribeConnectionsResponseTypeDef"}],"quickstart":{"code":"import boto3\nfrom mypy_boto3_ssm_guiconnect import SSMGUIConnectClient\nfrom typing import TYPE_CHECKING\n\n# --- Type Checking (only active during static analysis) ---\nif TYPE_CHECKING:\n    # Define the client with its specific type annotation\n    # Mypy will use the stubs from mypy-boto3-ssm-guiconnect to validate calls.\n    client: SSMGUIConnectClient = boto3.client(\"ssm-guiconnect\")\n\n    # Example of type-checking an attribute access. \n    # For SSM GUIConnect, direct public API methods might be less common,\n    # but the client object itself is fully type-hinted.\n    _ = client.meta.service_model\n\n# --- Runtime Code (executes normally) ---\n# The actual boto3 client is created and used as usual.\nreal_client = boto3.client(\"ssm-guiconnect\")\n\nprint(f\"Boto3 SSM GUIConnect client created: {real_client.__class__.__name__}\")\n# Add actual runtime interactions here if applicable for your use case.\n# Example: try:\n#     response = real_client.some_ssm_guiconnect_method() \n#     print(response)\n# except Exception as e:\n#     print(f\"Error during SSM GUIConnect call: {e}\")","lang":"python","description":"This quickstart demonstrates how to use `mypy-boto3-ssm-guiconnect` to add type hints to your `boto3` SSM GUIConnect client. The `if TYPE_CHECKING:` block is processed by `mypy` to validate method calls and attribute access, while the runtime code remains unchanged."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or newer. If Python 3.8 support is critical, pin to an older `mypy-boto3-ssm-guiconnect` version (e.g., `<1.42.0`).","message":"Beginning with `mypy-boto3-builder` 8.12.0 (which generated `mypy-boto3-ssm-guiconnect` 1.42.x and newer), Python 3.8 is no longer supported. Projects using these stubs must upgrade their Python environment.","severity":"breaking","affected_versions":"mypy-boto3-ssm-guiconnect >= 1.42.0"},{"fix":"Review and update `TypeDef` imports and usage in your type-hinted code to match the new generated names. Consult the `mypy-boto3-builder`'s release notes for specific service-related `TypeDef` changes if issues persist.","message":"If upgrading from `mypy-boto3-ssm-guiconnect` versions generated by `mypy-boto3-builder` older than 8.9.0 (roughly prior to `mypy-boto3-ssm-guiconnect` 1.36.0), explicit references to `TypeDef` names might break. The builder introduced naming convention changes (e.g., shorter names, `Extra` postfix moved) for consistency.","severity":"breaking","affected_versions":"Migration from versions < 1.36.0 to >= 1.36.0"},{"fix":"Ensure your `TYPE_CHECKING` blocks and type annotations correctly reference types provided by `mypy-boto3-ssm-guiconnect`.","message":"Always import client types and other type definitions directly from the `mypy_boto3_ssm_guiconnect` package or its submodules (e.g., `from mypy_boto3_ssm_guiconnect import SSMGUIConnectClient`). Do not attempt to import type definitions or client types from the `boto3` package itself, as `boto3` does not provide its own type stubs.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}