lgui-services 0.2.1

Desktop service contracts and adapters for LGUI
Documentation
use std::{fmt, sync::Arc};

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct OpenUrlError(String);

impl OpenUrlError {
    pub(crate) fn new(message: impl Into<String>) -> Self {
        Self(message.into())
    }
}

impl fmt::Display for OpenUrlError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        formatter.write_str(&self.0)
    }
}

impl std::error::Error for OpenUrlError {}

pub trait UrlOpener: Send + Sync + 'static {
    fn open(&self, url: &str) -> Result<(), OpenUrlError>;
}

#[derive(Clone)]
pub struct OpenUrlHandle(Arc<dyn UrlOpener>);

impl OpenUrlHandle {
    pub fn new(opener: impl UrlOpener) -> Self {
        Self(Arc::new(opener))
    }

    pub fn open(&self, url: &str) -> Result<(), OpenUrlError> {
        self.0.open(url)
    }
}

#[derive(Clone, Copy, Debug, Default)]
pub struct SystemUrlOpener;

impl UrlOpener for SystemUrlOpener {
    fn open(&self, url: &str) -> Result<(), OpenUrlError> {
        validate_external_url(url)?;
        open::that_detached(url).map_err(|error| OpenUrlError::new(error.to_string()))
    }
}

pub fn system_url_opener() -> OpenUrlHandle {
    OpenUrlHandle::new(SystemUrlOpener)
}

pub fn open_url(url: &str) -> Result<(), OpenUrlError> {
    SystemUrlOpener.open(url)
}

fn validate_external_url(url: &str) -> Result<(), OpenUrlError> {
    let scheme = url.split_once(':').map(|(scheme, _)| scheme);
    if !matches!(scheme, Some("http" | "https" | "mailto")) {
        Err(OpenUrlError::new(
            "external URLs must use http, https, or mailto",
        ))
    } else {
        Ok(())
    }
}

#[cfg(test)]
#[path = "open_url_test.rs"]
mod tests;