Registry /
type-stubs / mypy-boto3-marketplace-catalog
Install & Compatibility
Where this runs
tested against v1.43.74 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 19.8MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.4s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
MarketplaceCatalogClient
✓ from mypy_boto3_marketplace_catalog import MarketplaceCatalogClient
✗ from mypy_boto3_marketplace_catalog import MarketplaceCatalogClient
This example demonstrates how to use `mypy-boto3-marketplace-catalog` to type-hint a `boto3` Marketplace Catalog client and its responses. It lists entities of type 'ContainerProduct' from the 'AWSMarketplace' catalog. The `if TYPE_CHECKING:` block ensures that the type stub imports are only processed by type checkers and not during runtime, preventing unnecessary runtime dependencies.
import os
from typing import TYPE_CHECKING
import boto3
if TYPE_CHECKING:
from mypy_boto3_marketplace_catalog.client import MarketplaceCatalogClient
from mypy_boto3_marketplace_catalog.type_defs import ListEntitiesResponseTypeDef
# Ensure boto3 is configured, e.g., via AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, etc.
# For local testing, ensure dummy credentials or a valid AWS config exist.
# os.environ['AWS_ACCESS_KEY_ID'] = os.environ.get('AWS_ACCESS_KEY_ID', 'DUMMY_KEY')
# os.environ['AWS_SECRET_ACCESS_KEY'] = os.environ.get('AWS_SECRET_ACCESS_KEY', 'DUMMY_SECRET')
# os.environ['AWS_SESSION_TOKEN'] = os.environ.get('AWS_SESSION_TOKEN', 'DUMMY_TOKEN')
# os.environ['AWS_DEFAULT_REGION'] = os.environ.get('AWS_DEFAULT_REGION', 'us-east-1')
def list_marketplace_entities() -> list[str]:
client: 'MarketplaceCatalogClient' = boto3.client('marketplace-catalog')
try:
response: 'ListEntitiesResponseTypeDef' = client.list_entities(
Catalog='AWSMarketplace', EntityType='ContainerProduct'
)
entity_ids = [entity['EntityId'] for entity in response.get('EntitySummaryList', [])]
print(f"Found {len(entity_ids)} Marketplace Catalog entities.")
return entity_ids
except Exception as e:
print(f"Error listing entities: {e}")
return []
if __name__ == '__main__':
entities = list_marketplace_entities()
if entities:
print(f"First 3 entity IDs: {entities[:3]}")
Debug
Known issues
breakingPython 3.8 support has been removed for all `mypy-boto3` packages starting with `mypy-boto3-builder 8.12.0`. Ensure your project uses Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or higher.
affects: >=8.12.0 of mypy-boto3-builder (corresponds to mypy-boto3-marketplace-catalog >=1.42.41)
breakingBreaking changes to `TypeDef` naming conventions were introduced in `mypy-boto3-builder 8.9.0`. Type definitions for packed method arguments may use shorter names, and conflicting `Extra` postfixes are now moved to the end.fixIf you explicitly import `TypeDef` objects, you may need to adjust their names in your code to match the new patterns. Refer to the `mypy-boto3-builder` release notes for details.
affects: >=8.9.0 of mypy-boto3-builder
gotchaType stubs are generated for specific `boto3` versions. A mismatch between the installed `mypy-boto3-marketplace-catalog` version and your runtime `boto3` version can lead to incorrect or missing type hints.fixAlways try to match the `mypy-boto3` stub version as closely as possible to your `boto3` runtime version. The `mypy-boto3` project aims to align its versions with `boto3`.
affects: All versions
gotchaTo avoid introducing runtime dependencies on `mypy-boto3` packages, always wrap type stub imports within an `if TYPE_CHECKING:` block.fixExample: `from typing import TYPE_CHECKING; if TYPE_CHECKING: from mypy_boto3_marketplace_catalog.client import MarketplaceCatalogClient`. This ensures type imports are ignored at runtime.
affects: All versions
gotchaThe `mypy-boto3` project migrated to PEP 561 compliant packages. While generally beneficial for type checkers, ensure your type checking setup is up-to-date.fixMost modern type checkers (like MyPy, Pyright) should automatically handle PEP 561 packages. Verify your type checker configuration is recent.
affects: >=8.12.0 of mypy-boto3-builder (corresponds to mypy-boto3-marketplace-catalog >=1.42.41)
Upgrade
Version history
1.43.74latest on PyPI · released Aug 18, 2026
Audit
Dependencies
boto3requiredProvides the runtime functionality for which these are type stubs.