Skip to content


This tutorial introduces AWS Integrated Application Test Kit (AWS IATK) by going through four examples. Each of them showcases one feature at a time.

For each example, we will execute the following steps:

  1. Deploy System Under Test (SUT) with AWS SAM CLI or AWS CDK.
  2. Run the example test code with pytest.


Here are some terminologies we will use throughout the examples:

  • System Under Test (SUT) - the system being tested for correct operations (including happy and error paths)
  • Test Harness - Test Harness is a group of AWS resources AWS IATK creates for the purpose of facilitating testing around an integration. These resources are intended to exist only for the duration of the test run, and should be destroyed after the test run completes.


Getting started

Clone the examples:

git clone --single-branch --branch examples iatk-examples
cd iatk-examples

To run the Python (3.8+) examples:

python -m venv. venv
source .venv/bin/activate

pip install -r requirements.txt

Last update: 2023-11-09