The EDWH Development Database Plugin provides a comprehensive set of tools for managing snapshots of the development database. This plugin allows developers to create, push, pop, recover, and list database snapshots efficiently.

• Snapshot Management: Create and manage snapshots of the development database.
• Selective Exclusion: Optionally exclude specific tables during snapshot creation.
• Remote Operations: Push and pop snapshots to/from a remote server.
• Database Recovery: Recover the database from previously created snapshots.
• Environment Setup: Easy setup of environment variables for PostgreSQL connections.

• Python 3.12+
• Docker Compose
• PostgreSQL
• EDWH environment variables configured (usually via edwh setup)

To install the plugin in development mode, run:

uv pip install -e .[dev]

For production use, you can install the plugin using:

uvenv install edwh[devdb]

Alternatively, you can add the plugin directly with:

edwh plugin.add devdb

Ensure the following environment variables are set:

• POSTGRES_USERNAME: Username for PostgreSQL (default: postgres)
• POSTGRES_PASSWORD: Password for PostgreSQL (default: password)
• PGPOOL_PORT: Port for pgpool (default: 5432)
• POSTGRES_DATABASE: Name of the PostgreSQL database (default: backend)

Then you can run edwh setup and the other required variables can be infered.

To create a snapshot of the development database:

ew devdb.snapshot

You can exclude specific tables using optional parameters:

ew devdb.snapshot --without_api_activity False --without_applog False

To list all snapshots in reverse chronological order:

ew devdb.list

To rename the most recent snapshot:

ew devdb.rename <new_name>

To push the local snapshot to a remote server:

ew devdb.push

To download and prepare a snapshot from a given URL:

ew devdb.pop <url>

To recover the database from a snapshot:

ew devdb.recover

This assumes an empty database. An easier alternative is:

To reset your database to the latest state:

ew devdb.reset

• Be cautious when using the reset command as it will clear your PostgreSQL database and remove all existing data.

The source code is available at GitHub.

This project is licensed under the MIT License.