mypy-boto3-cost-optimization-hub Type Annotations

1.42.3 · active · verified Sat Apr 11

This library provides comprehensive type annotations for the `boto3` AWS SDK's Cost Optimization Hub service. Generated by `mypy-boto3-builder`, it ensures full type checking compatibility with tools like MyPy, Pyright, VSCode, and PyCharm, enabling developers to write more robust and error-free AWS-interacting Python code. The current version is 1.42.3, following the active and frequent release cadence of the underlying `mypy-boto3-builder` project.

Warnings

breaking Python 3.8 support was removed starting with `mypy-boto3-builder` version 8.12.0. Consequently, `mypy-boto3-cost-optimization-hub` version 1.42.3 and newer require Python 3.9 or higher.
Fix: Upgrade your Python environment to 3.9 or a newer supported version. If unable to upgrade, you must pin to an older version of `mypy-boto3-cost-optimization-hub` that supported Python 3.8.
breaking The `mypy-boto3` ecosystem migrated to PEP 561 compliant packages with `mypy-boto3-builder` version 8.12.0. While this improves packaging standards, it might affect custom build processes or older environments directly consuming `mypy-boto3-builder` outputs, though direct `pip install` users should see minimal impact.
Fix: Ensure your project's packaging and type-checking configurations are up-to-date with PEP 561 standards. For most users, simply updating `pip` and installing the latest stubs should suffice.
gotcha To avoid runtime dependencies on `mypy-boto3-cost-optimization-hub` and prevent potential Pylint warnings, always wrap type-specific imports (e.g., `CostOptimizationHubClient`, `TypeDefs`) within an `if TYPE_CHECKING:` block.
Fix: Modify your imports to use the `if TYPE_CHECKING:` pattern: `from typing import TYPE_CHECKING if TYPE_CHECKING: from mypy_boto3_cost_optimization_hub.client import CostOptimizationHubClient`.
breaking Across the `mypy-boto3` family, `TypeDef` naming conventions changed with `mypy-boto3-builder` version 8.9.0. This involved shortening packed method argument TypeDefs (e.g., `CreateDistributionRequestRequestTypeDef` to `CreateDistributionRequestTypeDef`) and moving 'Extra' postfixes.
Fix: Review your code for direct usage of specific `TypeDef` names. If you encounter `NameError` or type-checking issues with `TypeDef`s, consult the `mypy-boto3` documentation for the updated naming conventions for Cost Optimization Hub types.

Install

pip install mypy-boto3-cost-optimization-hub Install service-specific stubs
pip install 'boto3-stubs[cost-optimization-hub]' Install as boto3-stubs extra

Imports

CostOptimizationHubClient
```
from typing import TYPE_CHECKING
if TYPE_CHECKING:
    from mypy_boto3_cost_optimization_hub.client import CostOptimizationHubClient
```
Imports for type stubs should ideally be guarded by `if TYPE_CHECKING:` to avoid runtime dependencies on stub packages.
ResponseMetadataTypeDef
```
from typing import TYPE_CHECKING
if TYPE_CHECKING:
    from mypy_boto3_cost_optimization_hub.type_defs import ResponseMetadataTypeDef
```
TypeDefs provide precise type hints for API response structures and should also be guarded by `if TYPE_CHECKING:`.

Quickstart

This quickstart demonstrates how to instantiate a type-hinted `CostOptimizationHubClient` and perform a basic API call, `list_recommendation_summaries`. It includes the recommended `TYPE_CHECKING` guard for stub imports and basic error handling.

import boto3
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from mypy_boto3_cost_optimization_hub.client import CostOptimizationHubClient
    from mypy_boto3_cost_optimization_hub.type_defs import ListRecommendationSummariesResponseTypeDef

def get_cost_optimization_client() -> CostOptimizationHubClient:
    """Returns a type-hinted CostOptimizationHub client."""
    session = boto3.session.Session()
    return session.client("cost-optimization-hub")

client: CostOptimizationHubClient = get_cost_optimization_client()

try:
    # Example: List recommendation summaries
    response: ListRecommendationSummariesResponseTypeDef = client.list_recommendation_summaries()
    print(f"Recommendations found: {len(response.get('RecommendationSummaries', []))}")
    for summary in response.get('RecommendationSummaries', []):
        print(f"  - {summary.get('RecommendationTarget')}: {summary.get('EstimatedSavings', {}).get('Amount')}")
except client.exceptions.AccessDeniedException as e:
    print(f"Error: Access Denied. Ensure you have permissions for Cost Optimization Hub. Details: {e}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

view raw JSON →