pgdb 0.6.0

Creates and runs Postgres databases through Rust in temporary directories, cleaned up on drop
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! `pgdb` errors.
//!
//! Contains all errors produced by any part of this crate.

use std::{io, process};

use thiserror::Error;

/// A Postgres server error.
#[derive(Debug, Error)]
pub enum Error {
    #[error("could not find `postgres` binary")]
    FindPostgres(which::Error),
    /// Failed to find the `initdb` binary.
    #[error("could not find `initdb` binary")]
    FindInitdb(which::Error),
    /// Failed to find the `pg_isready` binary.
    #[error("could not find `pg_isready` binary")]
    FindPgIsready(which::Error),
    /// Failed to find the `postgres` binary.
    #[error("could not find `psql` binary")]
    FindPsql(which::Error),
    /// Could not create the temporary directory.
    #[error("could not create temporary directory for database")]
    CreateDatabaseDir(io::Error),
    /// Could not write the temporary password to a file.
    #[error("error writing temporary password")]
    WriteTemporaryPw(io::Error),
    /// Starting `initdb` failed.
    #[error("failed to run `initdb`")]
    RunInitDb(io::Error),
    /// Running `initdb` was not successful.
    #[error("`initdb` exited with status {}", 0)]
    InitDbFailed(process::ExitStatus),
    /// Postgres could not be launched.
    #[error("failed to launch `postgres`")]
    LaunchPostgres(io::Error),
    /// Postgres was launched but did not become ready in time.
    #[error("postgres did not become ready in time")]
    StartupTimeout,
    /// `psql` could not be launched.
    #[error("failed to run `psql`")]
    RunPsql(io::Error),
    /// Running `psql` returned an error.
    #[error("`psql` exited with status {}", 0)]
    PsqlFailed(process::ExitStatus),
    /// Invalid external test URL.
    #[error("invalid PGDB_TESTS_URL")]
    InvalidExternalUrl(#[source] ExternalUrlError),
}

/// Errors that can occur when parsing an external database URL.
#[derive(Debug, Error)]
pub enum ExternalUrlError {
    /// URL parsing failed.
    #[error("invalid URL: {0}")]
    ParseError(#[source] url::ParseError),
    /// Wrong URL scheme.
    #[error("must use postgres:// scheme")]
    InvalidScheme,
    /// Missing host.
    #[error("must include a host")]
    MissingHost,
    /// Missing username.
    #[error("must include a username")]
    MissingUsername,
}