{"id":3147,"library":"mypy-boto3-ssm-contacts","title":"mypy-boto3-ssm-contacts","description":"mypy-boto3-ssm-contacts provides comprehensive type annotations for the AWS SSM Contacts service client within the `boto3` library. It enables static type checking with tools like `mypy`, catching potential API misuse or type mismatches at development time for `boto3.client('ssm-contacts')`. This package, currently at version 1.42.3, is part of the `mypy-boto3` ecosystem which generates stubs for all AWS services, updated frequently to mirror `boto3` and AWS API changes, with a rapid release cadence driven by the `mypy-boto3-builder`.","status":"active","version":"1.42.3","language":"python","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","boto3","mypy","types","type-hints","ssm-contacts","static-analysis"],"install":[{"cmd":"pip install mypy-boto3-ssm-contacts","lang":"bash","label":"Install specific service stubs"},{"cmd":"pip install mypy-boto3","lang":"bash","label":"Install all boto3 stubs (larger)"}],"dependencies":[{"reason":"This package provides type stubs for boto3; boto3 itself must be installed for your code to run.","package":"boto3","optional":false}],"imports":[{"wrong":"from mypy_boto3_ssm_contacts import SSMContactsClient","symbol":"SSMContactsClient","correct":"from mypy_boto3_ssm_contacts import SSMContactsClient"}],"quickstart":{"code":"import boto3\nfrom mypy_boto3_ssm_contacts.client import SSMContactsClient\nfrom mypy_boto3_ssm_contacts.type_defs import ListContactsResponseTypeDef\nfrom typing import TYPE_CHECKING\n\n# Ensure boto3 is installed: pip install boto3\n\n# Use TYPE_CHECKING guard for runtime performance\nif TYPE_CHECKING:\n    # Annotate the client for type-checking benefits\n    client: SSMContactsClient = boto3.client(\"ssm-contacts\")\nelse:\n    client = boto3.client(\"ssm-contacts\")\n\ntry:\n    # Example usage with type-checked method calls and parameters\n    response: ListContactsResponseTypeDef = client.list_contacts(\n        MaxResults=5\n    )\n    contacts = response.get('Contacts', [])\n    print(f\"Found {len(contacts)} SSM Contacts:\")\n    for contact in contacts:\n        print(f\"  - {contact.get('ContactArn')} (Alias: {contact.get('Alias')})\")\n    \n    next_token = response.get('NextToken')\n    if next_token:\n        print(f\"Next Token: {next_token}\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")","lang":"python","description":"This quickstart demonstrates how to import and use the `SSMContactsClient` type to annotate your `boto3` client, enabling static type checking for your SSM Contacts operations. It also shows how to import and use specific `TypeDef` objects for response structures."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or newer.","message":"Python 3.8 support has been removed. `mypy-boto3` packages built with `mypy-boto3-builder` version 8.12.0 or newer no longer support Python 3.8.","severity":"breaking","affected_versions":"mypy-boto3-ssm-contacts versions 1.42.x and above (built with builder >= 8.12.0)"},{"fix":"Ensure your `mypy` installation is up-to-date (`pip install --upgrade mypy`) and your project setup follows standard Python packaging practices for type stubs.","message":"All `mypy-boto3` packages, including `mypy-boto3-ssm-contacts`, migrated to PEP 561 packaging. While this is a standard for type stubs, older `mypy` versions or non-standard project setups might encounter issues.","severity":"breaking","affected_versions":"mypy-boto3-ssm-contacts versions 1.42.x and above (built with builder >= 8.12.0)"},{"fix":"Ensure `pip install boto3` is executed alongside `pip install mypy-boto3-ssm-contacts`.","message":"This package provides only type annotations. For your code to run, you *must* also have the `boto3` library installed in the same environment.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Review and update explicit `TypeDef` imports if they encounter `NameError` after upgrading. Consult the specific service's `type_defs.pyi` for the correct names.","message":"When upgrading from very old versions, be aware that `mypy-boto3-builder` version 8.9.0 introduced breaking changes to how some `TypeDef` names are generated (e.g., shortening names or reordering suffixes to resolve conflicts). Your code might need updates if it directly references these specific type names.","severity":"breaking","affected_versions":"Upgrades from mypy-boto3-ssm-contacts versions built with mypy-boto3-builder < 8.9.0"},{"fix":"Use these types for compile-time checks and development assistance, not for runtime modification or expecting new boto3 functionalities.","message":"This package offers static type information only; it does not alter the runtime behavior of `boto3` or introduce new features. Its purpose is purely for static analysis (e.g., `mypy`) and IDE autocompletion.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'1.42.3':55 'analysi':104 'annot':14 'api':37,78 'aw':17,69,77,92 'boto3':3,8,24,62,75,90,93 'boto3.client':46 'builder':91 'cadenc':84 'catch':35 'chang':79 'check':30 'client':21 'comprehens':12 'contact':5,10,19,49,101 'current':52 'develop':43 'driven':85 'ecosystem':63 'enabl':27 'frequent':72 'generat':65 'hint':98 'librari':25 'like':33 'mirror':74 'mismatch':41 'misus':38 'mypi':2,7,34,61,89,94 'mypy-boto3':60 'mypy-boto3-builder':88 'mypy-boto3-ssm-contacts':1,6 'packag':51 'part':57 'potenti':36 'provid':11 'rapid':82 'releas':83 'servic':20,70 'ssm':4,9,18,48,100 'ssm-contact':47,99 'static':28,103 'static-analysi':102 'stub':66 'time':44 'tool':32 'type':13,29,40,95,97 'type-hint':96 'updat':71 'version':54 'within':22","created_at":"2026-04-11T09:23:03.339863+00:00","updated_at":"2026-04-16T17:14:30.291593+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n  File \"/tmp/tmplhk1v695/venv/lib/python3.12/site-packages/mypy_boto3_ssm_contacts/__init__.py\", line 45, in <module>\n    from .client import SSMContactsClient\n  File \"/tmp/tmplhk1v695/venv/lib/python3.12/site-packages/mypy_bo"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.43.0","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/youtype/mypy_boto3_builder","docs":"https://youtype.github.io/boto3_stubs_docs/mypy_boto3_ssm_contacts/","changelog":null,"pypi":"https://pypi.org/project/mypy-boto3-ssm-contacts/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["type-stubs","aws"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-08-28","next_check":"2026-07-10","install_tag":null}}