Struct PostgresTestContainer 

pub struct PostgresTestContainer { /* private fields */ }

Handle to the suite’s shared PostgreSQL container.

Implementations

impl PostgresTestContainer

pub async fn start(suite: &TestContainerSuite) -> Self

Starts (or reuses) the shared PostgreSQL container with postgres/postgres credentials.

Panics

Panics when shared state, container startup, port discovery, readiness, stale-database cleanup, or connection shutdown fails.

pub fn admin_url(&self) -> &str

Returns the admin URL pointing at the default postgres database.

pub fn container_identity(&self) -> &str

Returns a stable identity for the running suite container.

The resolved admin URL includes the checkout-scoped host port and therefore changes when the reusable container belongs to a different suite instance.

pub async fn create_database(&self, name: &str) -> PostgresTestDatabase

Creates and registers an isolated database for a product test.

Panics

Panics when the database name is invalid, shared state fails, or the admin connection, CREATE DATABASE, or connection shutdown fails.

pub async fn create_database_from_template( &self, name: &str, template: &str, ) -> PostgresTestDatabase

Creates and registers an isolated database cloned from template.

Products still own the template contents, migrations, and seed data. This helper only provides the product-neutral PostgreSQL database lifecycle and safe identifier handling.

Panics

Panics when either database name is invalid, shared state fails, or the admin connection, CREATE DATABASE ... TEMPLATE ..., or connection shutdown fails.

pub async fn create_shared_database(&self, name: &str) -> PostgresTestDatabase

Creates a suite-scoped database for a product-owned reusable fixture.

Unlike Self::create_database, this resource survives the producer process. Products must use a separate locked fixture-state protocol to validate or invalidate its contents.

pub async fn drop_shared_database(&self, name: &str)

Drops a suite-scoped fixture database and unregisters it.

Panics

Panics when the name is invalid or database cleanup, connection, or shutdown fails.

pub fn remember_shared_resource(&self, resource: &str)

Registers a suite-scoped product fixture that must outlive the producer process.

This is for product-owned migrated template databases. Products must pair it with their own fingerprint-based invalidation and call Self::forget_shared_resource after dropping a superseded fixture.

pub fn forget_shared_resource(&self, resource: &str)

Removes a suite-scoped product fixture after it was explicitly cleaned up.