#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Provider {
YouTube,
Vimeo,
}
impl Provider {
#[must_use]
pub fn name(self) -> &'static str {
match self {
Self::YouTube => "YouTube",
Self::Vimeo => "Vimeo",
}
}
#[must_use]
pub fn aspect_ratio(self) -> &'static str {
"16 / 9"
}
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct EmbedTarget {
pub provider: Provider,
pub src: String,
pub aspect_ratio: &'static str,
}
#[must_use]
pub fn resolve(url: &str) -> Option<EmbedTarget> {
let trimmed = url.trim();
if let Some(id) = youtube_id(trimmed) {
return Some(EmbedTarget {
provider: Provider::YouTube,
src: format!("https://www.youtube.com/embed/{id}"),
aspect_ratio: Provider::YouTube.aspect_ratio(),
});
}
if let Some(id) = vimeo_id(trimmed) {
return Some(EmbedTarget {
provider: Provider::Vimeo,
src: format!("https://player.vimeo.com/video/{id}"),
aspect_ratio: Provider::Vimeo.aspect_ratio(),
});
}
None
}
fn split_host(url: &str) -> Option<(String, &str)> {
let after = url.split_once("://").map_or(url, |(_, r)| r);
let (host, rest) = match after.find(['/', '?', '#']) {
Some(i) => (&after[..i], &after[i..]),
None => (after, ""),
};
let host = host.rsplit('@').next().unwrap_or(host);
let host = host.split(':').next().unwrap_or(host);
if host.is_empty() {
return None;
}
Some((host.to_ascii_lowercase(), rest))
}
fn host_matches(host: &str, domain: &str) -> bool {
host == domain || host.ends_with(&format!(".{domain}"))
}
fn youtube_id(url: &str) -> Option<String> {
let (host, rest) = split_host(url)?;
if host_matches(&host, "youtu.be") {
return first_segment(rest).filter(|s| is_id(s));
}
if host_matches(&host, "youtube.com") || host_matches(&host, "youtube-nocookie.com") {
if let Some(v) = query_param(rest, "v") {
return Some(v).filter(|s| is_id(s));
}
let path = rest.split(['?', '#']).next().unwrap_or("");
let mut segs = path.split('/').filter(|s| !s.is_empty());
if let Some(prefix) = segs.next() {
if matches!(prefix, "embed" | "shorts" | "v" | "live") {
return segs.next().map(str::to_owned).filter(|s| is_id(s));
}
}
}
None
}
fn vimeo_id(url: &str) -> Option<String> {
let (host, rest) = split_host(url)?;
if !host_matches(&host, "vimeo.com") {
return None;
}
let path = rest.split(['?', '#']).next().unwrap_or("");
let segs: Vec<&str> = path.split('/').filter(|s| !s.is_empty()).collect();
let candidate = match segs.as_slice() {
["video", id, ..] => *id,
[id, ..] => *id,
_ => return None,
};
if !candidate.is_empty() && candidate.chars().all(|c| c.is_ascii_digit()) {
Some(candidate.to_owned())
} else {
None
}
}
fn first_segment(rest: &str) -> Option<String> {
let path = rest.split(['?', '#']).next().unwrap_or("");
path.split('/').find(|s| !s.is_empty()).map(str::to_owned)
}
fn query_param(rest: &str, key: &str) -> Option<String> {
let q = rest.split_once('?')?.1;
let q = q.split('#').next().unwrap_or(q);
q.split('&')
.filter_map(|p| p.split_once('='))
.find(|(k, _)| *k == key)
.map(|(_, v)| v.to_owned())
}
fn is_id(s: &str) -> bool {
!s.is_empty()
&& s.chars()
.all(|c| c.is_ascii_alphanumeric() || c == '_' || c == '-')
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn youtube_watch_url() {
let t = resolve("https://www.youtube.com/watch?v=dQw4w9WgXcQ").unwrap();
assert_eq!(t.provider, Provider::YouTube);
assert_eq!(t.src, "https://www.youtube.com/embed/dQw4w9WgXcQ");
assert_eq!(t.aspect_ratio, "16 / 9");
}
#[test]
fn youtube_watch_with_extra_params() {
let t = resolve("https://youtube.com/watch?v=dQw4w9WgXcQ&t=42s&feature=share").unwrap();
assert_eq!(t.src, "https://www.youtube.com/embed/dQw4w9WgXcQ");
}
#[test]
fn youtube_short_link_and_shorts_and_embed() {
assert_eq!(
resolve("https://youtu.be/dQw4w9WgXcQ?t=10").unwrap().src,
"https://www.youtube.com/embed/dQw4w9WgXcQ"
);
assert_eq!(
resolve("https://www.youtube.com/shorts/abc123XYZ_-")
.unwrap()
.src,
"https://www.youtube.com/embed/abc123XYZ_-"
);
assert_eq!(
resolve("https://www.youtube.com/embed/dQw4w9WgXcQ")
.unwrap()
.src,
"https://www.youtube.com/embed/dQw4w9WgXcQ"
);
}
#[test]
fn youtube_nocookie_and_subdomain() {
assert_eq!(
resolve("https://m.youtube.com/watch?v=dQw4w9WgXcQ")
.unwrap()
.src,
"https://www.youtube.com/embed/dQw4w9WgXcQ"
);
assert_eq!(
resolve("https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ")
.unwrap()
.src,
"https://www.youtube.com/embed/dQw4w9WgXcQ"
);
}
#[test]
fn vimeo_page_and_player_urls() {
let t = resolve("https://vimeo.com/123456789").unwrap();
assert_eq!(t.provider, Provider::Vimeo);
assert_eq!(t.src, "https://player.vimeo.com/video/123456789");
assert_eq!(
resolve("https://player.vimeo.com/video/123456789?h=abc")
.unwrap()
.src,
"https://player.vimeo.com/video/123456789"
);
}
#[test]
fn vimeo_rejects_non_numeric_path() {
assert!(resolve("https://vimeo.com/channels/staffpicks").is_none());
}
#[test]
fn unknown_provider_is_none() {
assert!(resolve("https://example.com/video/abc").is_none());
assert!(resolve("https://twitter.com/jack/status/20").is_none());
assert!(resolve("not a url").is_none());
assert!(resolve("").is_none());
}
#[test]
fn watch_without_v_param_is_none() {
assert!(resolve("https://www.youtube.com/watch?feature=share").is_none());
}
#[test]
fn scheme_relative_and_no_scheme() {
assert_eq!(
resolve("youtube.com/watch?v=dQw4w9WgXcQ").unwrap().src,
"https://www.youtube.com/embed/dQw4w9WgXcQ"
);
}
}