footing 0.1.19

Feature-gated foundations for Rust backend services
Documentation
use uuid::Uuid;

#[must_use]
/// Reads the test database URL from `DATABASE_URL`.
pub fn database_url_from_env() -> Option<String> {
    std::env::var("DATABASE_URL")
        .ok()
        .map(|value| value.trim().to_owned())
        .filter(|value| !value.is_empty())
}

#[must_use]
/// Generates a process-scoped unique database name.
pub fn unique_database_name(prefix: &str) -> String {
    let prefix = prefix.trim().trim_matches('_');
    let prefix = if prefix.is_empty() { "test" } else { prefix };
    format!("{prefix}_{}", Uuid::now_v7().simple())
}

#[must_use]
/// Replaces the database name in a PostgreSQL URL.
/// Preserves connection options and encodes ordinary names as one path segment.
/// Dot-only names use `dbname` because URL paths normalize them away. Any
/// existing `dbname` option is updated to avoid overriding the requested name.
/// Invalid or non-PostgreSQL URLs are returned unchanged.
pub fn database_url_with_name(base_url: &str, database_name: &str) -> String {
    let Ok(mut url) = url::Url::parse(base_url) else {
        return base_url.to_owned();
    };
    if !matches!(url.scheme(), "postgres" | "postgresql") {
        return base_url.to_owned();
    }
    let Ok(mut segments) = url.path_segments_mut() else {
        return base_url.to_owned();
    };
    segments.clear().push(database_name);
    drop(segments);
    if matches!(database_name, "." | "..") || url.query_pairs().any(|(key, _)| key == "dbname") {
        let options = url
            .query_pairs()
            .filter(|(key, _)| key != "dbname")
            .map(|(key, value)| (key.into_owned(), value.into_owned()))
            .collect::<Vec<_>>();
        url.query_pairs_mut()
            .clear()
            .extend_pairs(options)
            .append_pair("dbname", database_name);
    }
    url.into()
}