wow-wdt 0.7.0

Parser, validator, and converter for World of Warcraft WDT (World Data Table) files
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

//! Error types for the WDT library

use std::io;
use thiserror::Error;

/// Result type alias for WDT operations
pub type Result<T> = std::result::Result<T, Error>;

/// Errors that can occur during WDT operations
#[derive(Error, Debug)]
pub enum Error {
    /// I/O error occurred
    #[error("I/O error: {0}")]
    Io(#[from] io::Error),

    /// Invalid magic bytes for a chunk
    #[error("Invalid chunk magic: expected {expected:?}, found {found:?}")]
    InvalidMagic { expected: [u8; 4], found: [u8; 4] },

    /// Unexpected chunk size
    #[error("Invalid chunk size for {chunk}: expected {expected}, found {found}")]
    InvalidChunkSize {
        chunk: String,
        expected: usize,
        found: usize,
    },

    /// Invalid WDT version
    #[error("Invalid WDT version: expected 18, found {0}")]
    InvalidVersion(u32),

    /// Missing required chunk
    #[error("Missing required chunk: {0}")]
    MissingChunk(String),

    /// Invalid data within a chunk
    #[error("Invalid {chunk} data: {message}")]
    InvalidChunkData { chunk: String, message: String },

    /// Version conversion error
    #[error("Cannot convert from {from} to {to}: {reason}")]
    ConversionError {
        from: String,
        to: String,
        reason: String,
    },

    /// Validation error
    #[error("Validation failed: {0}")]
    ValidationError(String),

    /// Unsupported feature for version
    #[error("Feature {feature} is not supported in version {version}")]
    UnsupportedFeature { feature: String, version: String },

    /// String encoding error
    #[error("Invalid string encoding in {context}: {message}")]
    StringError { context: String, message: String },

    /// File size exceeded limit
    #[error("File size {size} exceeds limit {limit} for {context}")]
    SizeLimit {
        size: usize,
        limit: usize,
        context: String,
    },
}

impl Error {
    /// Create an invalid magic error with chunk name
    pub fn invalid_magic_str(_chunk: &str, expected: &[u8; 4], found: &[u8; 4]) -> Self {
        Error::InvalidMagic {
            expected: *expected,
            found: *found,
        }
    }

    /// Create an invalid chunk data error
    pub fn invalid_data(chunk: impl Into<String>, message: impl Into<String>) -> Self {
        Error::InvalidChunkData {
            chunk: chunk.into(),
            message: message.into(),
        }
    }

    /// Create a validation error
    pub fn validation(message: impl Into<String>) -> Self {
        Error::ValidationError(message.into())
    }
}