Tutorial

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.

Terminologies

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.

Requirements

• AWS CLI and configured with your credentials.
• AWS SAM CLI installed.
• AWS CDK installed.
• Python 3.8+ installed.

Getting started

Clone the examples:

git clone --single-branch --branch examples git@github.com:awslabs/aws-iatk.git 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