Skip to main content

Type annotations for boto3.SNS 1.14.9 service, generated by mypy-boto3-buider 2.2.0

Project description

mypy-boto3-sns

PyPI - mypy-boto3-sns PyPI - Python Version Docs

Type annotations for boto3.SNS 1.14.9 service compatible with mypy, VSCode, PyCharm and other tools.

Generated by mypy-boto3-buider 2.2.0.

More information can be found on boto3-stubs page.

How to install

Make sure you have mypy installed and activated in your IDE.

Install boto3-stubs for SNS service.

python -m pip install boto3-stubs[sns]

How to use

Client annotations

SNSClient provides annotations for boto3.client("sns").

import boto3

from mypy_boto3_sns import SNSClient, SNSServiceResource
from mypy_boto3_sns.paginator import (
    ListEndpointsByPlatformApplicationPaginator,
    ListPhoneNumbersOptedOutPaginator,
    ListPlatformApplicationsPaginator,
    ListSubscriptionsByTopicPaginator,
    ListSubscriptionsPaginator,
    ListTopicsPaginator,
)
from mypy_boto3_sns.service_resource import (
    PlatformApplication,
    PlatformEndpoint,
    ServiceResourcePlatformApplicationsCollection,
    ServiceResourceSubscriptionsCollection,
    ServiceResourceTopicsCollection,
    Subscription,
    Topic,
)
from mypy_boto3_sns.type_defs import EndpointTypeDef, ...

client: SNSClient = boto3.client("sns")

# now client usage is checked by mypy and IDE should provide code auto-complete

# works for session as well
session = boto3.session.Session(region="us-west-1")
session_client: SNSClient = session.client("sns")

Paginators annotations

mypy_boto3_sns.paginator module contains type annotations for all paginators.

client: SNSClient = boto3.client("sns")

# Explicit type annotations are optional here
# Type should be correctly discovered by mypy and IDEs
# VSCode requires explicit type annotations
list_endpoints_by_platform_application_paginator: ListEndpointsByPlatformApplicationPaginator = client.get_paginator("list_endpoints_by_platform_application")
list_phone_numbers_opted_out_paginator: ListPhoneNumbersOptedOutPaginator = client.get_paginator("list_phone_numbers_opted_out")
list_platform_applications_paginator: ListPlatformApplicationsPaginator = client.get_paginator("list_platform_applications")
list_subscriptions_paginator: ListSubscriptionsPaginator = client.get_paginator("list_subscriptions")
list_subscriptions_by_topic_paginator: ListSubscriptionsByTopicPaginator = client.get_paginator("list_subscriptions_by_topic")
list_topics_paginator: ListTopicsPaginator = client.get_paginator("list_topics")

Service Resource annotations

SNSServiceResource provides annotations for boto3.resource("sns").

resource: SNSServiceResource = boto3.resource("sns")

# now resource usage is checked by mypy and IDE should provide code auto-complete

# works for session as well
session = boto3.session.Session(region="us-west-1")
session_resource: SNSServiceResource = session.resource("sns")

Other resources annotations

mypy_boto3_sns.service_resource module contains type annotations for all resources.

resource: SNSServiceResource = boto3.resource("sns")

# Explicit type annotations are optional here
# Type should be correctly discovered by mypy and IDEs
my_platform_application: PlatformApplication = resource.PlatformApplication(...)
my_platform_endpoint: PlatformEndpoint = resource.PlatformEndpoint(...)
my_subscription: Subscription = resource.Subscription(...)
my_topic: Topic = resource.Topic(...)

Collections annotations

mypy_boto3_sns.service_resource module contains type annotations for all SNSServiceResource collections.

resource: SNSServiceResource = boto3.resource("sns")

# Explicit type annotations are optional here
# Type should be correctly discovered by mypy and IDEs
platform_applications: sns_resources.ServiceResourcePlatformApplicationsCollection = resource.platform_applications
subscriptions: sns_resources.ServiceResourceSubscriptionsCollection = resource.subscriptions
topics: sns_resources.ServiceResourceTopicsCollection = resource.topics

Typed dictionations

mypy_boto3_sns.type_defs module contains structures and shapes assembled to typed dictionaries for additional type checking.

def get_structure() -> EndpointTypeDef:
    return {
      ...
    }

Dynamic type annotations

mypy_boto3 command generates boto3.client/resource type annotations for mypy_boto3_sns and other installed services.

# Run this command after you add or remove service packages
python -m mypy_boto3

Generated type annotations provide overloads for boto3.client and boto3.resource, boto3.Session.client and boto3.Session.resource functions, so explicit type annotations are not needed.

  • mypy supports function overloads as expected
  • PyCharm also supports function overloads, but consumes a lot of RAM, use carefully if you have many services installed
  • VSCode does not currently support function overloads, use explicit type annotations
# Type is discovered correctly by mypy and PyCharm
# VSCode still needs explicit type annotations
client = boto3.client("sns")
resource = boto3.resource("sns")

session_client = boto3.Session().client("sns")
session_resource = boto3.Session().resource("sns")

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mypy-boto3-sns-1.14.9.0.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

mypy_boto3_sns-1.14.9.0-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file mypy-boto3-sns-1.14.9.0.tar.gz.

File metadata

  • Download URL: mypy-boto3-sns-1.14.9.0.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for mypy-boto3-sns-1.14.9.0.tar.gz
Algorithm Hash digest
SHA256 92a82ee9cb14ffd6d20ca0cebc3e4f47c83e971f3bd96d29d2741a648e09941a
MD5 0b4f9037a955734e3404e1cacd5945d3
BLAKE2b-256 916d7cc9de88e9cc1c669c89be75c1ff0d34667dd22cd142e14713d506a75b8d

See more details on using hashes here.

File details

Details for the file mypy_boto3_sns-1.14.9.0-py3-none-any.whl.

File metadata

  • Download URL: mypy_boto3_sns-1.14.9.0-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for mypy_boto3_sns-1.14.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 642e6b1d4ca894a7652348e4d06f4f742a0d96738180366890212c97ea2af2c4
MD5 a9cf6bd39f4e2b9e84d3a45e5e24bc64
BLAKE2b-256 00ce9b700dca0c27aa8d94611b66a30ff7e2642ac86382fbec6853dce30ec078

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page