azure_data_cosmos 0.34.0

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.

//! Account endpoint types for Azure Cosmos DB.

use azure_core::http::Url;

/// The endpoint URL for a Cosmos DB account.
///
/// This is a newtype wrapper around [`Url`] that provides a strongly-typed representation
/// of a Cosmos DB account endpoint, such as `https://myaccount.documents.azure.com/`.
///
/// # Examples
///
/// Parsing from a string:
///
/// ```rust
/// use azure_data_cosmos::AccountEndpoint;
///
/// let endpoint: AccountEndpoint = "https://myaccount.documents.azure.com/".parse().unwrap();
/// ```
///
/// Converting from a [`Url`](azure_core::http::Url):
///
/// ```rust
/// use azure_data_cosmos::AccountEndpoint;
/// use azure_core::http::Url;
///
/// let url: Url = "https://myaccount.documents.azure.com/".parse().unwrap();
/// let endpoint = AccountEndpoint::from(url);
/// ```
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct AccountEndpoint(Url);

impl AccountEndpoint {
    /// Returns a reference to the underlying [`Url`].
    pub fn url(&self) -> &Url {
        &self.0
    }

    /// Consumes this endpoint and returns the underlying [`Url`].
    pub fn into_url(self) -> Url {
        self.0
    }
}

impl std::str::FromStr for AccountEndpoint {
    type Err = crate::CosmosError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let url: Url = s.parse().map_err(|e: url::ParseError| {
            crate::DriverCosmosError::builder()
                .with_status(crate::CosmosStatus::CLIENT_INVALID_ACCOUNT_ENDPOINT_URL)
                .with_message("invalid account endpoint URL")
                .with_arc_source(std::sync::Arc::new(e))
                .build()
        })?;
        Ok(Self(url))
    }
}

impl From<Url> for AccountEndpoint {
    fn from(url: Url) -> Self {
        Self(url)
    }
}

impl std::fmt::Display for AccountEndpoint {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.0.fmt(f)
    }
}