Getting started with Testcontainers for Python

In this guide, you will learn how to:

• Create a Python application that uses PostgreSQL to store customer data
• Use psycopg to interact with the database
• Write integration tests using testcontainers-python and pytest
• Manage container lifecycle with pytest fixtures

Prerequisites

• Python 3.10+
• pip
• A Docker environment supported by Testcontainers

Note

If you're new to Testcontainers, visit the Testcontainers overview to learn more about Testcontainers and the benefits of using it.

Modules

1. Create the project

   Set up a Python project with a PostgreSQL-backed customer service.

2. Write tests

   Write integration tests using testcontainers-python and pytest with a real PostgreSQL database.

3. Run tests

   Run your Testcontainers-based integration tests and explore next steps.