mcvm_core 0.9.0

Core functionality for launching Minecraft
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

use crate::net::download;
use mcvm_shared::util::{ARCH_STRING, OS_STRING, PREFERRED_ARCHIVE};

use anyhow::{anyhow, Context};
use reqwest::Client;

/// Downloading Adoptium JDK
pub mod adoptium {
	use anyhow::bail;
	use serde::Deserialize;

	use super::*;

	/// Gets the newest Adoptium binaries download for a major Java version
	pub async fn get_latest(major_version: &str, client: &Client) -> anyhow::Result<PackageFormat> {
		let url = json_url(major_version);
		let mut manifest = download::json::<Vec<PackageFormat>>(&url, client)
			.await
			.context("Failed to download manifest of Adoptium versions")?;
		if manifest.is_empty() {
			bail!("A valid installation was not found");
		}
		let version = manifest.swap_remove(0);

		Ok(version)
	}

	/// Gets the URL to the JSON file for a major Java version
	fn json_url(major_version: &str) -> String {
		format!(
			"https://api.adoptium.net/v3/assets/latest/{major_version}/hotspot?image_type=jre&vendor=eclipse&architecture={}&os={}",
			get_arch_arg(),
			get_os_arg(),
		)
	}

	/// Get the OS argument for the API
	fn get_os_arg() -> &'static str {
		if cfg!(target_os = "macos") {
			"mac"
		} else {
			OS_STRING
		}
	}

	/// Get the arch argument for the API
	fn get_arch_arg() -> &'static str {
		if cfg!(target_arch = "x86_64") {
			"x64"
		} else {
			ARCH_STRING
		}
	}

	/// A single package info for Adoptium
	#[derive(Deserialize, Debug)]
	pub struct PackageFormat {
		/// Information about the binary
		pub binary: Binary,
		/// Name of the Java release
		pub release_name: String,
	}

	/// Binary for an Adoptium package
	#[derive(Deserialize, Debug)]
	pub struct Binary {
		/// Package field that contains the download link
		pub package: BinaryPackage,
	}

	/// Package field inside the binary struct
	#[derive(Deserialize, Debug)]
	pub struct BinaryPackage {
		/// Link to the JRE download
		pub link: String,
	}
}

/// Downloading Azul Zulu
pub mod zulu {
	use super::*;

	use mcvm_shared::util::preferred_archive_extension;
	use serde::Deserialize;

	/// Gets the newest Zulu package for a major Java version
	pub async fn get_latest(major_version: &str, client: &Client) -> anyhow::Result<PackageFormat> {
		let url = json_url(major_version);
		let manifest = download::json::<Vec<PackageFormat>>(&url, client)
			.await
			.context("Failed to download manifest of Zulu versions")?;
		let package = manifest
			.first()
			.ok_or(anyhow!("A valid installation was not found"))?;

		Ok(package.to_owned())
	}

	/// Gets the URL to the JSON file for a major Java version
	fn json_url(major_version: &str) -> String {
		format!(
			"https://api.azul.com/metadata/v1/zulu/packages/?java_version={major_version}&os={OS_STRING}&arch={ARCH_STRING}&archive_type={PREFERRED_ARCHIVE}&java_package_type=jre&latest=true&java_package_features=headfull&release_status=ga&availability_types=CA&certifications=tck&page=1&page_size=100"
		)
	}

	/// Format of the metadata JSON with download info for Zulu
	#[derive(Deserialize, Clone)]
	pub struct PackageFormat {
		/// Name of the Zulu version
		pub name: String,
		/// Download URL for the package
		pub download_url: String,
	}

	/// Gets the name of the extracted directory by removing the archive file extension
	pub fn extract_dir_name(name: &str) -> String {
		name.replacen(&preferred_archive_extension(), "", 1)
	}

	#[cfg(test)]
	mod tests {
		use super::*;

		#[test]
		fn test_extract_dir_name() {
			let name = format!("hello.{PREFERRED_ARCHIVE}");
			assert_eq!(extract_dir_name(&name), "hello");
		}
	}
}

/// Downloading GraalVM
pub mod graalvm {
	use bytes::Bytes;
	use mcvm_shared::util::preferred_archive_extension;

	use super::*;

	/// Downloads the contents of the GraalVM archive
	pub async fn get_latest(major_version: &str, client: &Client) -> anyhow::Result<Bytes> {
		let url = download_url(major_version);
		download::bytes(url, client).await
	}

	/// Gets the download URL
	fn download_url(major_version: &str) -> String {
		format!(
			"https://download.oracle.com/graalvm/{major_version}/latest/graalvm-jdk-{major_version}_{}-{}_bin{}",
			OS_STRING,
			ARCH_STRING,
			preferred_archive_extension()
		)
	}
}