---
id: aws-cdk-integ-tests-alpha
version: "2.265.0a0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.integ-tests-alpha — CDK Integration Testing Constructs

License: permissive · Maintenance: active · Downloads: 179.2K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 179.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws cdk integration testing, cdk test constructs, aws infrastructure testing, cdk stack validation, integration test framework cdk, cdk deployment testing, aws api assertions, aws-cdk, infrastructure-testing, experimental

[View on SkillFed](https://skillfed.io/packages/aws-cdk-integ-tests-alpha) · [View on PyPI](https://pypi.org/project/aws-cdk-integ-tests-alpha/)