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.

Default db name, user and password is postgres.

Example

use testcontainers_modules::{postgres, testcontainers::runners::SyncRunner};

let postgres_instance = postgres::Postgres::default().start().unwrap();

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

Implementations

impl Postgres

pub fn with_host_auth(self) -> Self

Enables the Postgres instance to be used without authentication on host. For more information see the description of POSTGRES_HOST_AUTH_METHOD in official docker image

pub fn with_db_name(self, db_name: &str) -> Self

Sets the db name for the Postgres instance.

pub fn with_user(self, user: &str) -> Self

Sets the user for the Postgres instance.

pub fn with_password(self, password: &str) -> Self

Sets the password for the Postgres instance.

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 mounts(&self) -> Box<dyn Iterator<Item = &Mount> + '_>

There are a couple of things regarding the mounts 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 ) -> Result<Vec<ExecCommand>, TestcontainersError>

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