Install and run a PostgreSQL database locally on Linux, MacOS or Windows. PostgreSQL can be bundled with your application, or downloaded on demand.

This library provides an embedded-like experience for PostgreSQL similar to what you would have with SQLite. This is accomplished by downloading and installing PostgreSQL during runtime. There is also a "bundled" feature that when enabled, will download the PostgreSQL installation archive at compile time, include it in your binary and install from the binary version at runtime. In either case, PostgreSQL will run in a separate process space.

• installing and running PostgreSQL
• running PostgreSQL on ephemeral ports
• async and blocking API
• bundling the PostgreSQL archive in an executable
• semantic version resolution
• support for custom PostgreSQL archives / binaries
• ability to configure PostgreSQL startup options
• URL based configuration
• choice of native-tls vs rustls
• support for installing PostgreSQL extensions

use postgresql_embedded::{PostgreSQL, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let mut postgresql = PostgreSQL::default();
    postgresql.setup().await?;
    postgresql.start().await?;

    let database_name = "test";
    postgresql.create_database(database_name).await?;
    postgresql.database_exists(database_name).await?;
    postgresql.drop_database(database_name).await?;

    postgresql.stop().await
}

These crates use #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

PostgreSQL is covered under The PostgreSQL License.

Supports using PostgreSQL binaries from:

• theseus-rs/postgresql-binaries (default)
• zonkyio/embedded-postgres-binaries

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Projects that inspired this one:

• zonkyio/embedded-postgres-binaries
• faokunega/pg-embed