Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

1.8 KB
Raw Blame
use std::fmt;

use anyhow::{ensure, Context, Error, Result};
use serde::Deserialize;
use url::Url;

#[derive(Debug, Deserialize)]
#[serde(try_from = "String")]
pub struct WebUrl(Url);

impl WebUrl {
    fn new(url: Url) -> Result<Self> {
        ensure!(
            matches!(url.scheme(), "http" | "https"),
            "The server returned a {} URL. The CLI only opens http and https URLs, so check that your PostHog host is correct",
            url.scheme()
        );
        // On WSL, `wslview` puts the URL in a double-quoted PowerShell string, where none of
        // these characters is syntax. PostHog URLs use no others.
        ensure!(
            url.as_str()
                .chars()
                .all(|c| c.is_ascii_alphanumeric() || "-._~:/?#[]@&=+,%".contains(c)),
            "The server returned a URL with characters that the CLI does not open, so check that your PostHog host is correct"
        );
        Ok(Self(url))
    }

    pub fn with_query_pair(mut self, name: &str, value: &str) -> Result<Self> {
        self.0.query_pairs_mut().append_pair(name, value);
        Self::new(self.0)
    }

    /// Only `that_detached` avoids `cmd` on Windows. Elsewhere `that` reports a failed opener.
    #[allow(clippy::disallowed_methods)]
    pub fn open_in_browser(&self) -> Result<()> {
        #[cfg(windows)]
        let opened = open::that_detached(self.0.as_str());
        #[cfg(not(windows))]
        let opened = open::that(self.0.as_str());
        opened.context("Failed to open browser")
    }
}

impl TryFrom<String> for WebUrl {
    type Error = Error;

    fn try_from(raw: String) -> Result<Self> {
        Self::new(Url::parse(&raw).context("The server returned a URL that is not valid")?)
    }
}

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