pgdb_cli-0.5.0 is not a library.
pgdb_cli
A command-line interface for creating temporary PostgreSQL databases for development and testing.
Installation
The easiest way to install is to do so straight from crates.io:
Usage
Start a temporary PostgreSQL instance:
This will:
- Start a PostgreSQL server on port 15432 (by default), with a data directory in your temporary directory
- Create a user
devwith passworddev - Create a database
devowned by the user - Display connection information
- Keep running until interrupted (Ctrl+C)
External Database Support
You can use pgdb_cli with an existing PostgreSQL server by setting the PGDB_TESTS_URL environment variable:
PGDB_TESTS_URL=postgres://postgres:password@localhost:5432/postgres
When using an external database:
- The URL must use the
postgres://scheme and include superuser credentials pgdb_cliwill create the specified user and database on the external server- The connection details (host, port) will match the external server
- A temporary directory is still created for consistency
Requirements
PostgreSQL binaries (postgres, initdb, psql) must be available in your PATH, pgdb_cli does not ship or install
PostgreSQL.