elemental-driver 0.2.0

Driver library for Elemental, providing implementations for interacting with different modloaders and game versions.
Documentation
use elemental_infra::SafeRelativePath;
use reqwest::Url;

use crate::error::{Error, Result};
use crate::http::fetch_text;
use crate::url::{require_http_scheme, with_directory_path};

use super::snapshot::decode_snapshot_metadata;
use super::url::artifact_url;
use super::{MavenArtifactDownload, MavenCoordinate};

#[derive(Debug, Clone)]
pub struct MavenRepository {
    base_url: Url,
}

impl MavenRepository {
    pub fn parse(base_url: &str, invalid_label: &str) -> Result<Self> {
        let parsed = Url::parse(base_url).map_err(|source| {
            Error::invalid_url(
                format!("parse {invalid_label} url failed"),
                base_url,
                source,
            )
        })?;
        require_http_scheme(&parsed, format!("{invalid_label} url"))?;
        let base_url = with_directory_path(parsed)?;

        Ok(Self { base_url })
    }

    pub fn base_url(&self) -> &str {
        self.base_url.as_str()
    }

    pub fn artifact_download(
        &self,
        artifact_path: SafeRelativePath,
    ) -> Result<MavenArtifactDownload> {
        let url = artifact_url(&self.base_url, &artifact_path)?;
        Ok(MavenArtifactDownload {
            path: artifact_path,
            url,
        })
    }

    pub async fn resolve_snapshot_artifact(
        &self,
        client: &reqwest::Client,
        coordinate: &MavenCoordinate,
    ) -> Result<MavenArtifactDownload> {
        let metadata_path = coordinate.safe_metadata_path()?;
        let metadata_url = artifact_url(&self.base_url, &metadata_path)?;
        let raw_metadata =
            fetch_text(client, metadata_url.as_str(), "maven snapshot metadata").await?;
        let metadata = decode_snapshot_metadata(raw_metadata.as_str(), metadata_url)?;
        let resolved_version = self.resolve_snapshot_version(coordinate, &metadata)?;
        let path = coordinate.safe_artifact_path_for_version(resolved_version.as_str())?;
        let url = artifact_url(&self.base_url, &path)?;

        Ok(MavenArtifactDownload { path, url })
    }
}