Install & Compatibility
Where this runs
tested against v1.43.75 · 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.640s · 53.6MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 5.5s · import 0.585s · 54MB
52MB installed
● package 52MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
VPCLatticeClient
✓ from mypy_boto3_vpc_lattice.client import VPCLatticeClient
Imports the type-hinted client for AWS VPC Lattice service.
ListServicesPaginator
✓ from mypy_boto3_vpc_lattice.paginator import ListServicesPaginator
Imports the type-hinted paginator for listing services.
ServiceSummaryTypeDef
✓ from mypy_boto3_vpc_lattice.type_defs import ServiceSummaryTypeDef
Imports a common TypeDef for VPC Lattice service summaries.
This quickstart demonstrates how to use `mypy-boto3-vpc-lattice` for type-hinting a `boto3` VPC Lattice client. The `TYPE_CHECKING` block ensures that the type stub imports are only active during static analysis, avoiding runtime dependencies on the stub package. The `boto3.client` call returns the actual runtime client, which `mypy` (or another type checker) will understand as `VPCLatticeClient` thanks to the installed stubs.
import os
from typing import TYPE_CHECKING
import boto3
# These imports are only for type checking and won't be evaluated at runtime
if TYPE_CHECKING:
from mypy_boto3_vpc_lattice.client import VPCLatticeClient
from mypy_boto3_vpc_lattice.type_defs import ServiceSummaryTypeDef
def list_vpc_lattice_services() -> list["ServiceSummaryTypeDef"]:
# Initialize a boto3 client (runtime object)
# The type checker uses the VPCLatticeClient stub for this call
client: VPCLatticeClient = boto3.client("vpc-lattice", region_name=os.environ.get('AWS_REGION', 'us-east-1'))
print("Listing VPC Lattice services...")
response = client.list_services()
services = response.get("items", [])
for service in services:
print(f" Service ID: {service.get('id')}, Name: {service.get('name')}")
return services
if __name__ == "__main__":
# Set a dummy AWS_REGION for local execution if not already set
# In a real scenario, credentials/region would be configured via env vars, ~/.aws/config, etc.
if 'AWS_REGION' not in os.environ:
os.environ['AWS_REGION'] = 'us-east-1'
try:
# This call will actually execute and might require AWS credentials
services = list_vpc_lattice_services()
print(f"Found {len(services)} VPC Lattice services.")
except Exception as e:
print(f"An error occurred: {e}. Make sure you have AWS credentials configured.")
Debug
Known issues
breakingSupport for Python 3.8 was removed in `mypy-boto3-builder` version 8.12.0, affecting all generated `mypy-boto3` packages. Users on Python 3.8 must pin to an older version of `mypy-boto3-vpc-lattice` (prior to versions generated by builder 8.12.0) or upgrade their Python environment.fixUpgrade to Python 3.9+ or pin `mypy-boto3-vpc-lattice` to a version compatible with Python 3.8.
affects: >=8.12.0 of mypy-boto3-builder (affecting mypy-boto3-vpc-lattice versions built with it)
breakingIn `mypy-boto3-builder` version 8.9.0, there were breaking changes to TypeDef naming conventions. Packed method arguments now use shorter names (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`), and conflicting `Extra` postfixes were moved to the end of the name (e.g., `CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`). This may require updates to explicit TypeDef annotations in user code.fixReview and update explicit TypeDef imports and usage in your code to match the new naming conventions.
affects: >=8.9.0 of mypy-boto3-builder (affecting mypy-boto3-vpc-lattice versions built with it)
gotchaThis package provides only type annotations for `boto3`. You must install `boto3` separately for your code to run. This package is solely for static analysis tools like `mypy` or `pyright`.fixEnsure `pip install boto3` is executed in your environment alongside `mypy-boto3-vpc-lattice`.
affects: All
gotchaPyCharm's built-in type checker can experience slow performance or high CPU usage with the full `boto3-stubs` packages due to complex Literal overloads. For better IDE performance, consider using `boto3-stubs-lite` (e.g., `pip install 'boto3-stubs-lite[vpc-lattice]'`) or disabling PyCharm's type checker and relying on external tools like `mypy` or `pyright`.fixSwitch to `boto3-stubs-lite` for IDE performance, or use an external type checker.
affects: All
Upgrade
Version history
1.43.75latest on PyPI · released Aug 19, 2026
Audit
Dependencies
boto3requiredThis package provides type stubs for boto3; boto3 itself is required at runtime for the type hints to be useful.
mypyoptionalA type checker like mypy or pyright is necessary to utilize the provided type annotations.