minecraft_registry_api 1.0.1

Typed API clients for Minecraft modding platforms — Modrinth, Mojang, Paper, Purpur, Fabric, Forge, NeoForge
Documentation
use crate::{error::ApiError, purpur::{PurpurClient, BASE, models::{PurpurVersion, VersionQuery, BuildDownload}}};

impl PurpurClient {
    /// Fetches version info with build list from Purpur API.
    ///
    /// # Errors
    ///
    /// Returns [`ApiError::Http`] if the request or parsing fails.
    pub async fn get_version(&self, params: VersionQuery<'_>) -> Result<PurpurVersion, ApiError> {
        let url = format!("{BASE}/purpur/{}", params.version);
        let resp = self.client.get(&url).send().await?.error_for_status()?;
        Ok(resp.json().await?)
    }

    /// Downloads a specific build of Purpur.
    ///
    /// # Errors
    ///
    /// Returns [`ApiError::Http`] if the request or parsing fails.
    pub async fn download_build(&self, params: BuildDownload<'_>) -> Result<Vec<u8>, ApiError> {
        let url = format!("{BASE}/purpur/{}/{}", params.version, params.build);
        let resp = self.client.get(&url).send().await?.error_for_status()?;
        Ok(resp.bytes().await?.to_vec())
    }
}

#[cfg(test)]
#[allow(clippy::unwrap_used)]
mod tests {
    use super::*;
    use crate::purpur::models::VersionQuery;
    use reqwest::Client;

    #[tokio::test]
    async fn test_get_purpur_version() {
        let client = PurpurClient::new(Client::new());
        let v = client.get_version(VersionQuery { version: "1.21.4" }).await.unwrap();
        assert_eq!(v.version, "1.21.4");
    }
}