testcontainers-python facilitates the use of Docker containers for functional and integration testing.

For more information, see the docs.

>>> from testcontainers.postgres import PostgresContainer >>> import sqlalchemy >>> with PostgresContainer("postgres:16") as postgres: ... engine = sqlalchemy.create_engine(postgres.get_connection_url()) ... with engine.begin() as connection: ... result = connection.execute(sqlalchemy.text("select version()")) ... version, = result.fetchone() >>> version 'PostgreSQL 16...'

The snippet above will spin up a postgres database in a container. The get_connection_url() convenience method returns a sqlalchemy compatible url we use to connect to the database and retrieve the database version.

See CONTRIBUTING.md for more details.

You can set environment variables to configure the library behaviour:

Alternatively you can set the configuration during runtime:

fromtestcontainers.coreimporttestcontainers_configtestcontainers_config.ryuk_docker_socket="/home/user/docker.sock"