aws-cdk.integ-tests-alpha

What it is and what it does

This package provides CDK constructs for defining and running integration tests against AWS CDK applications. You write a test as a self-contained CDK application, wrap it with the IntegTest construct, and then use the integ-runner CLI to synthesize, deploy, and validate your infrastructure. The package is experimental (marked as Beta in development status) and part of the AWS CDK ecosystem.

It supports multiple test cases per integration test, customizable deployment workflows, and assertions against deployed infrastructure via AWS API calls. You can define different options for individual test cases, enable asset diffing, and control deployment parameters like approval requirements and destruction behavior. The package depends on aws-cdk-lib, constructs, jsii, and publication.

Use it for:

• Test CDK stacks under different configurations (e.g., Lambda with different architectures) before production deployment
• Validate that infrastructure synthesizes and deploys correctly across multiple scenarios
• Make assertions on deployed AWS resources using AWS API calls to verify expected behavior
• Customize deployment workflows with specific CDK command options and approval policies
• Define integration tests as part of a CDK application to catch infrastructure issues early

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides constructs and utilities for writing and executing integration tests for AWS CDK applications, enabling you to test CDK stacks before deployment.

Yes, if you are actively developing AWS CDK constructs or applications and need to test them before deployment. The package is actively maintained and has low install friction. However, be aware that it is experimental and may introduce breaking changes in future releases—review release notes before upgrading. You will also need the integ-runner CLI to actually execute the tests.

Install

aws-cdk-integ-tests-alpha on PyPI

pip install aws-cdk-integ-tests-alpha

uv add aws-cdk-integ-tests-alpha

poetry add aws-cdk-integ-tests-alpha

Installing aws-cdk.integ-tests-alpha

Before you install

Active maintenance with a recent release (1 day old). Low install friction with 4 runtime dependencies. The package is marked experimental and subject to non-backward compatible changes, so expect potential breaking updates.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in most projects without significant restriction, though you should review the full license terms for your specific use case.

Quickstart

from aws_cdk import App, Stack
from aws_cdk.integ_tests_alpha import IntegTest

app = App()
stack = Stack(app, "MyStack")
IntegTest(app, "MyIntegTest", test_cases=[stack])

Requires AWS CDK CLI (integ-runner) to execute integration tests; this package provides constructs only.

Verify before relying

• Whether integ-runner CLI is packaged separately or must be installed independently
• Supported versions of aws-cdk-lib and constructs beyond the runtime dependency declaration

Package facts

Evidence: aws_cdk_integ_tests_alpha-2.265.0a0-py3-none-any.whl

Tags

More Testing packages