Skip to content

Examples#

Index > Sustainability > Examples

Auto-generated documentation for Sustainability type annotations stubs module types-boto3-sustainability.

Client#

Implicit type annotations#

Can be used with types-boto3[sustainability] package installed.

Write your Sustainability code as usual, type checking and code completion should work out of the box.

Client method usage example#

# SustainabilityClient usage example

from boto3.session import Session


session = Session()

client = session.client("sustainability")  # (1)
result = client.get_estimated_carbon_emissions()  # (2)
  1. client: SustainabilityClient
  2. result: GetEstimatedCarbonEmissionsResponseTypeDef

Paginator usage example#

# GetEstimatedCarbonEmissionsDimensionValuesPaginator usage example

from boto3.session import Session


session = Session()
client = session.client("sustainability")  # (1)

paginator = client.get_paginator("get_estimated_carbon_emissions_dimension_values")  # (2)
for item in paginator.paginate(...):
    print(item)  # (3)
  1. client: SustainabilityClient
  2. paginator: GetEstimatedCarbonEmissionsDimensionValuesPaginator
  3. item: GetEstimatedCarbonEmissionsDimensionValuesResponseTypeDef

Explicit type annotations#

With types-boto3-lite[sustainability] or a standalone types_boto3_sustainability package, you have to explicitly specify client: SustainabilityClient type annotation.

All other type annotations are optional, as types should be discovered automatically. However, these type annotations can be helpful in your functions and methods.

Client method usage example#

# SustainabilityClient usage example with type annotations

from boto3.session import Session

from types_boto3_sustainability.client import SustainabilityClient
from types_boto3_sustainability.type_defs import GetEstimatedCarbonEmissionsResponseTypeDef
from types_boto3_sustainability.type_defs import GetEstimatedCarbonEmissionsRequestTypeDef


session = Session()

client: SustainabilityClient = session.client("sustainability")

kwargs: GetEstimatedCarbonEmissionsRequestTypeDef = {...}
result: GetEstimatedCarbonEmissionsResponseTypeDef = client.get_estimated_carbon_emissions(**kwargs)

Paginator usage example#

# GetEstimatedCarbonEmissionsDimensionValuesPaginator usage example with type annotations

from boto3.session import Session

from types_boto3_sustainability.client import SustainabilityClient
from types_boto3_sustainability.paginator import GetEstimatedCarbonEmissionsDimensionValuesPaginator
from types_boto3_sustainability.type_defs import GetEstimatedCarbonEmissionsDimensionValuesResponseTypeDef


session = Session()
client: SustainabilityClient = session.client("sustainability")

paginator: GetEstimatedCarbonEmissionsDimensionValuesPaginator = client.get_paginator("get_estimated_carbon_emissions_dimension_values")
for item in paginator.paginate(...):
    item: GetEstimatedCarbonEmissionsDimensionValuesResponseTypeDef
    print(item)