#![forbid(unsafe_code)]
#![warn(missing_docs)]
mod error;
mod identifier;
mod range;
mod version;
pub use error::Error;
pub use identifier::{Identifier, Identifiers};
pub use range::{Comparator, Op, Range};
pub use version::{split_reference, Version};
#[cfg(doctest)]
#[doc = include_str!("../README.md")]
struct ReadmeDoctests;
use std::cmp::Ordering;
pub const MAX_LENGTH: usize = 256;
pub const MAX_SAFE_INTEGER: u64 = 9_007_199_254_740_991;
pub fn parse(version: &str) -> Result<Version, Error> {
Version::parse(version)
}
pub fn valid(version: &str) -> Option<String> {
Version::parse(version).ok().map(|v| v.to_string())
}
pub fn valid_range(range: &str) -> Option<String> {
Range::parse(range).ok().map(|r| {
let s = r.to_string();
if s.is_empty() {
"*".to_string()
} else {
s
}
})
}
pub fn compare(a: &str, b: &str) -> Result<Ordering, Error> {
Ok(Version::parse(a)?.cmp(&Version::parse(b)?))
}
pub fn satisfies(version: &str, range: &str) -> bool {
if version == range {
return Version::parse(version).is_ok();
}
let Ok(range) = Range::parse(range) else {
return false;
};
let Ok(version) = Version::parse(version) else {
return false;
};
range.test(&version)
}
pub fn max_satisfying<'a, I>(versions: I, range: &str) -> Option<&'a str>
where
I: IntoIterator<Item = &'a str>,
{
let range = Range::parse(range).ok()?;
let mut best: Option<(&'a str, Version)> = None;
for s in versions {
let Ok(v) = Version::parse(s) else { continue };
if !range.test(&v) {
continue;
}
match &best {
Some((_, b)) if *b >= v => {}
_ => best = Some((s, v)),
}
}
best.map(|(s, _)| s)
}
pub fn min_satisfying<'a, I>(versions: I, range: &str) -> Option<&'a str>
where
I: IntoIterator<Item = &'a str>,
{
let range = Range::parse(range).ok()?;
let mut best: Option<(&'a str, Version)> = None;
for s in versions {
let Ok(v) = Version::parse(s) else { continue };
if !range.test(&v) {
continue;
}
match &best {
Some((_, b)) if *b <= v => {}
_ => best = Some((s, v)),
}
}
best.map(|(s, _)| s)
}
pub fn sort(versions: &mut [Version]) {
versions.sort();
}
pub fn rsort(versions: &mut [Version]) {
versions.sort_by(|a, b| b.cmp(a));
}