{"id":3146,"library":"mypy-boto3-snowball","title":"mypy-boto3-snowball","description":"Type annotations for boto3 Snowball 1.42.3 service generated with mypy-boto3-builder 8.12.0. This library provides static type checking for `boto3` clients and resources, enhancing development with autocompletion and early error detection for AWS Snowball operations. It follows `boto3`'s release cadence, with frequent updates to align with new AWS service versions.","status":"active","version":"1.42.3","language":"python","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","boto3","mypy","typing","stubs","cloud","snowball","type-checking","developer-tools"],"install":[{"cmd":"pip install mypy-boto3-snowball","lang":"bash","label":"Standalone package"},{"cmd":"pip install 'boto3-stubs[snowball]'","lang":"bash","label":"As part of boto3-stubs"}],"dependencies":[{"reason":"Runtime dependency for AWS API calls.","package":"boto3","optional":false},{"reason":"Underlying type stubs for botocore, implicitly used by mypy-boto3-snowball.","package":"types-botocore","optional":false}],"imports":[{"wrong":"from mypy_boto3_snowball import SnowballClient","symbol":"SnowballClient","correct":"from mypy_boto3_snowball.client import SnowballClient"},{"symbol":"SnowballServiceResource","correct":"from mypy_boto3_snowball.resources import SnowballServiceResource"},{"symbol":"ServiceResource","correct":"from mypy_boto3_snowball import ServiceResource"}],"quickstart":{"code":"import boto3\nfrom typing import TYPE_CHECKING\nfrom mypy_boto3_snowball.client import SnowballClient\n\ndef get_snowball_jobs():\n    # Use TYPE_CHECKING guard to avoid runtime dependency on mypy-boto3-snowball\n    if TYPE_CHECKING:\n        client: SnowballClient = boto3.client(\"snowball\")\n    else:\n        client = boto3.client(\"snowball\")\n\n    try:\n        response = client.list_jobs(\n            MaxResults=10,\n            # NextToken='string' # Uncomment if you have a next token\n        )\n        print(f\"Snowball Jobs: {response.get('JobListEntries')}\")\n        return response.get('JobListEntries', [])\n    except client.exceptions.InvalidResourceException as e:\n        print(f\"Error: {e}\")\n        return []\n\nif __name__ == \"__main__\":\n    # Ensure AWS credentials are configured (e.g., via ~/.aws/credentials or environment variables)\n    # For local testing, you might need a mock boto3 or actual AWS setup.\n    print(\"Attempting to list Snowball jobs...\")\n    jobs = get_snowball_jobs()","lang":"python","description":"This quickstart demonstrates how to initialize a `boto3` Snowball client and use it with `mypy-boto3-snowball` type annotations. The `TYPE_CHECKING` guard ensures the stub package is only used during static analysis, preventing a runtime dependency. The example lists up to 10 Snowball jobs."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or higher. If unable to upgrade Python, use an older `mypy-boto3-snowball` version compatible with Python 3.8.","message":"Python 3.8 support has been removed since mypy-boto3-builder version 8.12.0. Ensure your project uses Python 3.9 or newer to utilize the latest `mypy-boto3-snowball` versions.","severity":"breaking","affected_versions":"mypy-boto3-builder >=8.12.0, mypy-boto3-snowball >=1.42.0"},{"fix":"Review and update `TypedDict` imports and usage in your codebase to match the new naming conventions as defined in the latest stub package documentation.","message":"mypy-boto3-builder version 8.9.0 introduced breaking changes in TypeDef naming conventions, potentially affecting existing type-hinted code. For example, `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`.","severity":"breaking","affected_versions":"mypy-boto3-builder >=8.9.0, mypy-boto3-* versions generated by these builders"},{"fix":"Always install the specific `mypy-boto3-SERVICE_NAME` package for the service you need or use `boto3-stubs[SERVICE_NAME]` to ensure you're getting the latest and correctly generated stubs.","message":"Legacy `mypy-boto3` (the monolithic package) has been moved to a separate product by the builder in version 8.9.0. Users should explicitly install service-specific packages (e.g., `mypy-boto3-snowball`) or `boto3-stubs` with extras.","severity":"gotcha","affected_versions":"mypy-boto3-builder >=8.9.0"},{"fix":"Consider using `boto3-stubs-lite[snowball]` which offers a more RAM-friendly experience without `session.client`/`resource` overloads (requiring explicit type annotations). Alternatively, disable PyCharm's internal type checker and rely on external tools like `mypy` or `pyright`.","message":"PyCharm may experience slow performance or high CPU usage due to `Literal` overloads in `mypy-boto3` stubs. This is a known issue (PY-40997).","severity":"gotcha","affected_versions":"All versions"},{"fix":"It's good practice to explicitly type-hint your `boto3` client (e.g., `client: SnowballClient = boto3.client(\"snowball\")`) for maximum type-checking benefit and IDE assistance.","message":"While `mypy-boto3` often provides implicit type discovery, explicit type annotations for clients, paginators, and waiters can improve clarity and sometimes be necessary, especially when using `lite` versions of the stubs.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'1.42.3':10 '8.12.0':18 'align':52 'annot':6 'autocomplet':33 'aw':39,55,58 'boto3':3,8,16,26,44,59 'builder':17 'cadenc':47 'check':24,67 'client':27 'cloud':63 'detect':37 'develop':31,69 'developer-tool':68 'earli':35 'enhanc':30 'error':36 'follow':43 'frequent':49 'generat':12 'librari':20 'mypi':2,15,60 'mypy-boto3-builder':14 'mypy-boto3-snowball':1 'new':54 'oper':41 'provid':21 'releas':46 'resourc':29 'servic':11,56 'snowbal':4,9,40,64 'static':22 'stub':62 'tool':70 'type':5,23,61,66 'type-check':65 'updat':50 'version':57","created_at":"2026-04-11T09:23:00.815996+00:00","updated_at":"2026-04-16T17:14:06.862088+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n  File \"/tmp/tmppwwx1yle/venv/lib/python3.12/site-packages/mypy_boto3_snowball/__init__.py\", line 35, in <module>\n    from .client import SnowballClient\n  File \"/tmp/tmppwwx1yle/venv/lib/python3.12/site-packages/mypy_boto3_sno"},"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_snowball/","changelog":null,"pypi":"https://pypi.org/project/mypy-boto3-snowball/","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}}