#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ParsedSpec {
Npm {
pkg: String,
name: String,
},
Github {
owner: String,
repo: String,
name: String,
},
Unknown {
ecosystem: String,
payload: String,
name: String,
},
}
impl ParsedSpec {
pub fn name(&self) -> &str {
match self {
ParsedSpec::Npm { name, .. }
| ParsedSpec::Github { name, .. }
| ParsedSpec::Unknown { name, .. } => name,
}
}
}
pub fn parse_spec(spec: &str) -> ParsedSpec {
let Some(colon_idx) = spec.find(':') else {
return ParsedSpec::Unknown {
ecosystem: String::new(),
payload: spec.to_string(),
name: spec.to_string(),
};
};
let ecosystem = &spec[..colon_idx];
let payload = &spec[colon_idx + 1..];
if ecosystem == "npm" {
return ParsedSpec::Npm {
pkg: payload.to_string(),
name: slugify_npm_name(payload),
};
}
if ecosystem == "github" {
match payload.split_once('/') {
Some((owner, repo)) => {
return ParsedSpec::Github {
owner: owner.to_string(),
repo: repo.to_string(),
name: repo.to_string(),
};
}
None => {
return ParsedSpec::Unknown {
ecosystem: ecosystem.to_string(),
payload: payload.to_string(),
name: payload.to_string(),
};
}
}
}
ParsedSpec::Unknown {
ecosystem: ecosystem.to_string(),
payload: payload.to_string(),
name: payload.to_string(),
}
}
pub fn library_name_from_spec(spec: &str) -> String {
parse_spec(spec).name().to_string()
}
pub fn split_explicit_version(input: &str) -> (&str, Option<&str>) {
match input.rfind('@') {
None => (input, None),
Some(0) => (input, None),
Some(idx) if input.as_bytes()[idx - 1] == b':' => (input, None),
Some(idx) => (&input[..idx], Some(&input[idx + 1..])),
}
}
pub fn slugify_npm_name(pkg_name: &str) -> String {
if is_scoped_pkg(pkg_name) {
pkg_name[1..].replacen('/', "-", 1)
} else {
pkg_name.to_string()
}
}
fn is_scoped_pkg(s: &str) -> bool {
let Some(rest) = s.strip_prefix('@') else {
return false;
};
match rest.split_once('/') {
Some((scope, name)) => !scope.is_empty() && !name.is_empty() && !name.contains('/'),
None => false,
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn npm_unscoped() {
assert_eq!(
parse_spec("npm:next"),
ParsedSpec::Npm {
pkg: "next".into(),
name: "next".into()
}
);
}
#[test]
fn npm_scoped_is_flattened() {
assert_eq!(
parse_spec("npm:@mastra/client-js"),
ParsedSpec::Npm {
pkg: "@mastra/client-js".into(),
name: "mastra-client-js".into(),
}
);
}
#[test]
fn github_repo_keeps_dots() {
assert_eq!(
parse_spec("github:vercel/next.js"),
ParsedSpec::Github {
owner: "vercel".into(),
repo: "next.js".into(),
name: "next.js".into(),
}
);
}
#[test]
fn github_without_slash_is_unknown() {
assert_eq!(
parse_spec("github:justarepo"),
ParsedSpec::Unknown {
ecosystem: "github".into(),
payload: "justarepo".into(),
name: "justarepo".into(),
}
);
}
#[test]
fn no_colon_is_unknown_empty_ecosystem() {
assert_eq!(
parse_spec("next"),
ParsedSpec::Unknown {
ecosystem: String::new(),
payload: "next".into(),
name: "next".into(),
}
);
}
#[test]
fn unknown_ecosystem_passthrough() {
assert_eq!(
parse_spec("pypi:fastapi"),
ParsedSpec::Unknown {
ecosystem: "pypi".into(),
payload: "fastapi".into(),
name: "fastapi".into(),
}
);
}
#[test]
fn github_owner_repo_with_subpath_splits_on_first_slash() {
assert_eq!(
parse_spec("github:owner/repo/extra"),
ParsedSpec::Github {
owner: "owner".into(),
repo: "repo/extra".into(),
name: "repo/extra".into(),
}
);
}
#[test]
fn library_name_helper_matches_variant_name() {
assert_eq!(
library_name_from_spec("npm:@mastra/client-js"),
"mastra-client-js"
);
assert_eq!(library_name_from_spec("github:vercel/next.js"), "next.js");
assert_eq!(library_name_from_spec("react"), "react");
}
#[test]
fn split_explicit_version_cases() {
assert_eq!(
split_explicit_version("npm:next@14"),
("npm:next", Some("14"))
);
assert_eq!(
split_explicit_version("github:vercel/next.js@v14.2.3"),
("github:vercel/next.js", Some("v14.2.3"))
);
assert_eq!(split_explicit_version("@vercel/ai"), ("@vercel/ai", None));
assert_eq!(
split_explicit_version("npm:@vercel/ai"),
("npm:@vercel/ai", None)
);
assert_eq!(
split_explicit_version("npm:@vercel/ai@5.0.0"),
("npm:@vercel/ai", Some("5.0.0"))
);
assert_eq!(split_explicit_version("next"), ("next", None));
}
#[test]
fn slugify_edge_cases() {
assert_eq!(slugify_npm_name("next"), "next");
assert_eq!(slugify_npm_name("@scope/pkg"), "scope-pkg");
assert_eq!(slugify_npm_name("@notscoped"), "@notscoped");
assert_eq!(slugify_npm_name("@a/b/c"), "@a/b/c");
}
}