terra-plr 0.2.4

Terraria player parser
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

use crate::TerrariaFileType;
use cs_datetime_parse::{OutOfRangeError, ParseError};
use std::{io, ops::RangeInclusive};
use thiserror::Error;

pub type Result<T> = core::result::Result<T, Error>;

fn format_u8_array(array: &[u8]) -> String {
	let mut text = String::with_capacity(array.len());
	for byte in array {
		if !byte.is_ascii_graphic() {
			text.push_str("\\x");
			text.push_str(&byte.to_string());
			continue;
		}

		let char = *byte as char;
		if char == '\\' {
			text.push_str("\\\\");
			continue;
		}

		text.push(char);
	}

	text
}

#[derive(Debug, Error)]
pub enum Error {
	#[error("the version {version} is not supported, supported versions: {version_bounds:?}")]
	UnsupportedVersion {
		version: i32,
		version_bounds: RangeInclusive<i32>,
	},

	#[error("invalid magic number expected b\"{}\", found b\"{}\"", format_u8_array(.found), format_u8_array(.expected))]
	InvalidMagicNumber { found: Vec<u8>, expected: Vec<u8> },

	#[error("invalid file type expected {}, found {}", .expected.name(), .found.name())]
	InvalidFileType {
		found: TerrariaFileType,
		expected: TerrariaFileType,
	},

	#[error("io error")]
	Io(#[from] io::Error),

	#[error("{0}")]
	DateTimeCsOutOfRange(#[from] OutOfRangeError),

	#[error("{0}")]
	DateTimeParse(#[from] ParseError),
}