ogre 0.1.7

A rusty, dual-wielding Quake and Half-Life texture WAD 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
55
56

//! `nom` functions for parsing the WAD format.

pub mod repr;

mod color;
mod directory;
mod entry;
mod header;
mod image;
mod palette;
mod texture;
mod wad;

pub use color::*;
pub use directory::*;
pub use entry::*;
pub use header::*;
pub use image::*;
pub use palette::*;
pub use texture::*;
pub use wad::*;

use nom::IResult;

/// Given a length, returns a function that parses a null-terminated string slice from a byte slice.
pub fn parse_byte_string(length: usize) -> impl Fn(&[u8]) -> IResult<&[u8], &str> {
    move |i: &[u8]| {
        let string_len = i
            .iter()
            .take(length)
            .position(|i| *i == b'\0')
            .unwrap_or(length);

        let byte_string = std::str::from_utf8(&i[..string_len])
            .expect("Failed to convert name into a string slice");

        Ok((&i[length..], byte_string))
    }
}

/// Implements [`std::convert::TryFrom`] for type `$ty` using parser function `$parser`.
#[macro_export]
macro_rules! impl_try_from {
    ($ty:ty, $parser:tt) => {
        impl<'a> std::convert::TryFrom<&'a [u8]> for $ty {
            type Error = String;

            fn try_from(value: &'a [u8]) -> Result<Self, Self::Error> {
                match $parser(value) {
                    Ok((_, o)) => Ok(o),
                    Err(e) => Err(format!("{}", e)),
                }
            }
        }
    };
}