mcdata-rs 0.1.2

Library to access Minecraft data provided by PrismarineJS/minecraft-data
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

pub use crate::version::Edition;
use std::path::PathBuf;
use thiserror::Error; // Re-export Edition for convenience

/// Represents errors that can occur within the mcdata-rs library.
#[derive(Error, Debug)]
pub enum McDataError {
    // Errors related to version resolution.
    #[error("Version string '{0}' is invalid or unsupported")]
    InvalidVersion(String),

    #[error("Version '{mc_version}' (major: {major_version}) not found for edition {edition:?}")]
    VersionNotFound {
        mc_version: String,
        major_version: String,
        edition: Edition,
    },

    // Errors related to finding and loading data files.
    #[error(
        "Data key '{data_key}' not found in dataPaths.json for version {mc_version} ({edition:?})"
    )]
    DataPathNotFound {
        mc_version: String, // The major version used for lookup (e.g., "1.18")
        edition: Edition,
        data_key: String, // The data key (e.g., "blocks")
    },

    #[error("Data file not found for key '{data_key}' at expected path pattern: {path:?}")]
    DataFileNotFound { data_key: String, path: PathBuf },

    #[error("I/O error accessing path {path:?}: {source}")]
    IoError {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },

    #[error("Failed to parse JSON file {path:?}: {source}")]
    JsonParseError {
        path: PathBuf,
        #[source]
        source: serde_json::Error,
    },

    // Errors related to the download and caching mechanism.
    #[error("Could not determine a valid cache directory for application data")]
    CacheDirNotFound,

    #[error("Failed to download minecraft-data: {0}")]
    DownloadError(String), // Wraps errors from reqwest or response handling.

    #[error("Failed to process downloaded archive: {0}")]
    ArchiveError(String), // Wraps errors from the zip library or I/O during extraction.

    #[error("Failed to verify data after download/extraction in {0:?}")]
    DownloadVerificationFailed(PathBuf), // Indicates expected files/dirs were missing post-extraction.

    // Other internal or unexpected errors.
    #[error("Internal error: {0}")]
    Internal(String), // For unexpected states or logic errors.

    #[error("Cached operation failed previously: {0}")]
    CachedError(String), // Indicates a cached OnceCell holds a previous error result.
}