android_xml_converter/
lib.rs

1use std::io;
2use thiserror::Error;
3
4#[derive(Error, Debug)]
5pub enum ConversionError {
6    #[error("IO error: {0}")]
7    Io(#[from] io::Error),
8
9    #[error(
10        "Invalid ABX file format - magic header mismatch. Expected: {expected:02X?}, got: {actual:02X?}"
11    )]
12    InvalidMagicHeader { expected: [u8; 4], actual: [u8; 4] },
13
14    #[error("Failed to read {0} from stream")]
15    ReadError(String),
16
17    #[error("Invalid interned string index: {0}")]
18    InvalidInternedStringIndex(u16),
19
20    #[error("Unknown attribute type: {0}")]
21    UnknownAttributeType(u8),
22
23    #[error("Parse error: {0}")]
24    ParseError(String),
25
26    #[error("XML parsing failed: {0}")]
27    XmlParsing(String),
28
29    #[error("String too long: {0} bytes (max: {1})")]
30    StringTooLong(usize, usize),
31
32    #[error("Binary data too long: {0} bytes (max: {1})")]
33    BinaryDataTooLong(usize, usize),
34
35    #[error("Invalid hex string")]
36    InvalidHex,
37
38    #[error("Invalid base64 string")]
39    InvalidBase64,
40
41    #[error("UTF-8 conversion error: {0}")]
42    Utf8Error(#[from] std::str::Utf8Error),
43}
44
45// convert quick_xml errors
46impl From<quick_xml::Error> for ConversionError {
47    fn from(err: quick_xml::Error) -> Self {
48        ConversionError::XmlParsing(err.to_string())
49    }
50}
51
52impl From<quick_xml::events::attributes::AttrError> for ConversionError {
53    fn from(err: quick_xml::events::attributes::AttrError) -> Self {
54        ConversionError::XmlParsing(err.to_string())
55    }
56}
57
58pub type Result<T> = std::result::Result<T, ConversionError>;
59
60// ============================================================================
61// Protocol Constants
62// ============================================================================
63
64/// Magic header for ABX format version 0
65pub const PROTOCOL_MAGIC_VERSION_0: [u8; 4] = [0x41, 0x42, 0x58, 0x00];
66
67// Token types (lower 4 bits)
68pub const START_DOCUMENT: u8 = 0;
69pub const END_DOCUMENT: u8 = 1;
70pub const START_TAG: u8 = 2;
71pub const END_TAG: u8 = 3;
72pub const TEXT: u8 = 4;
73pub const CDSECT: u8 = 5;
74pub const ENTITY_REF: u8 = 6;
75pub const IGNORABLE_WHITESPACE: u8 = 7;
76pub const PROCESSING_INSTRUCTION: u8 = 8;
77pub const COMMENT: u8 = 9;
78pub const DOCDECL: u8 = 10;
79pub const ATTRIBUTE: u8 = 15;
80
81// Type information (upper 4 bits)
82pub const TYPE_NULL: u8 = 1 << 4;
83pub const TYPE_STRING: u8 = 2 << 4;
84pub const TYPE_STRING_INTERNED: u8 = 3 << 4;
85pub const TYPE_BYTES_HEX: u8 = 4 << 4;
86pub const TYPE_BYTES_BASE64: u8 = 5 << 4;
87pub const TYPE_INT: u8 = 6 << 4;
88pub const TYPE_INT_HEX: u8 = 7 << 4;
89pub const TYPE_LONG: u8 = 8 << 4;
90pub const TYPE_LONG_HEX: u8 = 9 << 4;
91pub const TYPE_FLOAT: u8 = 10 << 4;
92pub const TYPE_DOUBLE: u8 = 11 << 4;
93pub const TYPE_BOOLEAN_TRUE: u8 = 12 << 4;
94pub const TYPE_BOOLEAN_FALSE: u8 = 13 << 4;
95
96// ============================================================================
97// Shared Utilities
98// ============================================================================
99
100/// Maximum value for a u16 (used for length limits)
101pub const MAX_UNSIGNED_SHORT: u16 = 65535;
102
103/// Special marker indicating a new interned string follows
104pub const INTERNED_STRING_NEW_MARKER: u16 = 0xFFFF;
105
106/// Initial capacity for string pool
107pub const INITIAL_STRING_POOL_CAPACITY: usize = 64;
108
109/// Initial capacity for XML event buffer
110pub const INITIAL_EVENT_BUFFER_CAPACITY: usize = 8192;
111
112#[inline]
113pub fn encode_xml_entities(text: &str) -> std::borrow::Cow<'_, str> {
114    // Fast path: check if escaping is needed
115    if !text
116        .bytes()
117        .any(|b| matches!(b, b'&' | b'<' | b'>' | b'"' | b'\''))
118    {
119        return std::borrow::Cow::Borrowed(text);
120    }
121
122    let mut result = String::with_capacity(text.len() + 16);
123    for ch in text.chars() {
124        match ch {
125            '&' => result.push_str("&amp;"),
126            '<' => result.push_str("&lt;"),
127            '>' => result.push_str("&gt;"),
128            '"' => result.push_str("&quot;"),
129            '\'' => result.push_str("&apos;"),
130            _ => result.push(ch),
131        }
132    }
133    std::borrow::Cow::Owned(result)
134}
135
136/// Shows a warning message for unsupported XML features
137#[inline]
138pub fn show_warning(feature: &str, details: Option<&str>) {
139    eprintln!("WARNING: {} is not supported and might be lost.", feature);
140    if let Some(details) = details {
141        eprintln!("  {}", details);
142    }
143}
144
145// ============================================================================
146// Type Detection Utilities
147// ============================================================================
148
149pub mod type_detection {
150    /// checks if a string represents a boolean value
151    #[inline]
152    pub fn is_boolean(s: &str) -> bool {
153        matches!(s, "true" | "false")
154    }
155
156    /// Checks if a string contains only whitespace
157    #[inline]
158    pub fn is_whitespace_only(s: &str) -> bool {
159        s.bytes().all(|b| matches!(b, b' ' | b'\t' | b'\n' | b'\r'))
160    }
161}
android_xml_converter/lib.rs

android_xml_converter/
lib.rs
