use std::collections::BTreeMap;
use serde::{Deserialize, Serialize};
use url::Url;
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VersionManifest {
pub latest: LatestVersions,
pub versions: Vec<VersionReference>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct LatestVersions {
pub release: String,
pub snapshot: String,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct VersionReference {
pub id: String,
#[serde(rename = "type")]
pub kind: VersionType,
pub url: Url,
pub time: String,
pub release_time: String,
#[serde(default)]
pub sha1: Option<String>,
#[serde(default)]
pub compliance_level: Option<u8>,
}
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(transparent)]
pub struct VersionType(pub String);
impl VersionType {
pub const RELEASE: &'static str = "release";
pub const SNAPSHOT: &'static str = "snapshot";
#[must_use]
pub fn as_str(&self) -> &str {
&self.0
}
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct VersionMetadata {
pub id: String,
#[serde(rename = "type")]
pub kind: VersionType,
pub main_class: String,
pub assets: String,
pub asset_index: AssetIndexReference,
pub downloads: VersionDownloads,
#[serde(default)]
pub libraries: Vec<Library>,
#[serde(default)]
pub logging: Option<LoggingConfiguration>,
#[serde(default)]
pub arguments: Option<Arguments>,
#[serde(default)]
pub minecraft_arguments: Option<String>,
#[serde(default)]
pub java_version: Option<JavaVersionRequirement>,
#[serde(default)]
pub inherits_from: Option<String>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VersionDownloads {
pub client: DownloadInfo,
#[serde(default)]
pub server: Option<DownloadInfo>,
#[serde(default, rename = "client_mappings")]
pub client_mappings: Option<DownloadInfo>,
#[serde(default, rename = "server_mappings")]
pub server_mappings: Option<DownloadInfo>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct DownloadInfo {
#[serde(default)]
pub path: Option<String>,
#[serde(default)]
pub sha1: Option<String>,
#[serde(default)]
pub size: Option<u64>,
pub url: Url,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AssetIndexReference {
pub id: String,
pub sha1: String,
pub size: u64,
#[serde(default)]
pub total_size: Option<u64>,
pub url: Url,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Library {
pub name: String,
#[serde(default)]
pub checksums: Vec<String>,
#[serde(default)]
pub downloads: Option<LibraryDownloads>,
#[serde(default)]
pub rules: Vec<Rule>,
#[serde(default)]
pub natives: BTreeMap<String, String>,
#[serde(default)]
pub extract: Option<ExtractRules>,
#[serde(default)]
pub url: Option<Url>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Default)]
pub struct LibraryDownloads {
#[serde(default)]
pub artifact: Option<DownloadInfo>,
#[serde(default)]
pub classifiers: BTreeMap<String, DownloadInfo>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize, Default)]
pub struct ExtractRules {
#[serde(default)]
pub exclude: Vec<String>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Default)]
pub struct Arguments {
#[serde(default)]
pub game: Vec<Argument>,
#[serde(default)]
pub jvm: Vec<Argument>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum Argument {
Plain(String),
Conditional {
rules: Vec<Rule>,
value: ArgumentValue,
},
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ArgumentValue {
One(String),
Many(Vec<String>),
}
impl ArgumentValue {
#[must_use]
pub fn values(&self) -> Vec<&str> {
match self {
Self::One(value) => vec![value],
Self::Many(values) => values.iter().map(String::as_str).collect(),
}
}
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Rule {
pub action: RuleAction,
#[serde(default)]
pub os: Option<RuleOs>,
#[serde(default)]
pub features: BTreeMap<String, bool>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum RuleAction {
Allow,
Disallow,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct RuleOs {
#[serde(default)]
pub name: Option<String>,
#[serde(default)]
pub arch: Option<String>,
#[serde(default)]
pub version: Option<String>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct JavaVersionRequirement {
#[serde(default)]
pub component: Option<String>,
pub major_version: u16,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct LoggingConfiguration {
#[serde(default)]
pub client: Option<LoggingClient>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct LoggingClient {
pub argument: String,
pub file: LoggingFile,
#[serde(rename = "type")]
pub kind: String,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct LoggingFile {
pub id: String,
pub sha1: String,
pub size: u64,
pub url: Url,
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parses_catalog_and_modern_version_metadata() {
let catalog = r#"{
"latest":{"release":"1.21.8","snapshot":"25w10a"},
"versions":[{"id":"1.21.8","type":"release","url":"https://example.test/v.json","time":"x","releaseTime":"y","sha1":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]
}"#;
let parsed: VersionManifest = serde_json::from_str(catalog).expect("catalog");
assert_eq!(parsed.versions[0].kind.as_str(), "release");
let metadata = r#"{
"id":"1.21.8","type":"release","mainClass":"net.minecraft.client.main.Main","assets":"19",
"assetIndex":{"id":"19","sha1":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","size":12,"url":"https://example.test/assets.json"},
"downloads":{"client":{"sha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","size":42,"url":"https://example.test/client.jar"}},
"libraries":[],"arguments":{"game":["--demo"],"jvm":["-cp","${classpath}"]},
"javaVersion":{"majorVersion":21,"component":"java-runtime-delta"},"unknownFutureField":true
}"#;
let parsed: VersionMetadata = serde_json::from_str(metadata).expect("metadata");
assert_eq!(parsed.java_version.expect("Java").major_version, 21);
}
#[test]
fn parses_legacy_arguments() {
let metadata = r#"{
"id":"1.6.4","type":"release","mainClass":"net.minecraft.client.Minecraft","assets":"legacy",
"assetIndex":{"id":"legacy","sha1":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","size":12,"url":"https://example.test/assets.json"},
"downloads":{"client":{"sha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","size":42,"url":"https://example.test/client.jar"}},
"minecraftArguments":"--username ${auth_player_name}","libraries":[]
}"#;
let parsed: VersionMetadata = serde_json::from_str(metadata).expect("metadata");
assert!(parsed.arguments.is_none());
assert!(parsed.minecraft_arguments.is_some());
}
}