Struct testcontainers_modules::postgres::Postgres

pub struct Postgres { /* private fields */ }

Available on crate feature postgres only.

Module to work with Postgres inside of tests.

Starts an instance of Postgres. This module is based on the official Postgres docker image.

Example

use testcontainers::clients;
use testcontainers_modules::postgres;

let docker = clients::Cli::default();
let postgres_instance = docker.run(postgres::Postgres::default());

let connection_string = format!(
    "postgres://postgres:postgres@127.0.0.1:{}/postgres",
    postgres_instance.get_host_port_ipv4(5432)
);

Trait Implementations

impl Debug for Postgres

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Postgres

fn default() -> Self

Returns the “default value” for a type.

impl Image for Postgres

type Args = ()

A type representing the arguments for an Image.

fn name(&self) -> String

The name of the docker image to pull from the Docker Hub registry.

fn tag(&self) -> String

Implementations are encouraged to include a tag that will not change (i.e. NOT latest) in order to prevent test code from randomly breaking because the underlying docker suddenly changed.

fn ready_conditions(&self) -> Vec<WaitFor>

Returns a list of conditions that need to be met before a started container is considered ready.

fn env_vars(&self) -> Box<dyn Iterator<Item = (&String, &String)> + '_>

There are a couple of things regarding the environment variables of images:

fn volumes(&self) -> Box<dyn Iterator<Item = (&String, &String)> + '_>

There are a couple of things regarding the volumes of images:

fn entrypoint(&self) -> Option<String>

Returns the entrypoint this instance was created with.

fn expose_ports(&self) -> Vec<u16>

Returns the ports that needs to be exposed when a container is created.

fn exec_after_start(&self, cs: ContainerState) -> Vec<ExecCommand>

Returns the commands that needs to be executed after a container is started i.e. commands to be run in a running container.