#parser #untrusted #input #primitive

no-std untrustended

Untrustended - Untrusted Extended. A compilation of primitives for parsing values from untrusted input.

9 unstable releases

0.4.2 Jan 13, 2025
0.4.1 Jan 3, 2024
0.4.0 Jul 19, 2021
0.3.0 Jul 30, 2019
0.0.2 Jul 23, 2017

#3 in #untrusted

Download history 84/week @ 2024-10-02 45/week @ 2024-10-09 205/week @ 2024-10-16 151/week @ 2024-10-23 141/week @ 2024-10-30 135/week @ 2024-11-06 103/week @ 2024-11-13 90/week @ 2024-11-20 155/week @ 2024-11-27 118/week @ 2024-12-04 175/week @ 2024-12-11 40/week @ 2024-12-18 2/week @ 2024-12-25 57/week @ 2025-01-01 266/week @ 2025-01-08 143/week @ 2025-01-15

468 downloads per month

ISC license

26KB
326 lines

untrustended Crates.ioCircleCI

Untrustended is a compilation of primitives for parsing values from untrusted input. It's building on top of untrusted's Reader::read_byte().

Please, consult untrusted's documentation about how to use that crate before attempting to use this one.

Example

See usage example in untrustended documentation.

License

See LICENSE.txt. ISC license.


lib.rs:

Untrustended - Untrusted Extended.

Untrustended is a compilation of primitives for parsing values from untrusted input. It's building on top of untrusted's Reader::read_byte() and Reader::read_bytes().

Please, consult untrusted's documentation about how to use that crate before attempting to use this one.

To use the new methods provided by this crate:

use untrustended::ReaderExt;

then construct a Reader as usual and enjoy.

Example:

use untrusted::{Input, Reader};
use untrustended::{ReaderExt, Error};

fn read_stuff(input: &mut Reader<'_>) -> Result<(u8, u16, u32), Error> {
    let one_byte = input.read_u8()?;
    let big_endian_u16 = input.read_u16be()?;
    let little_endian_u32 = input.read_u32le()?;
    Ok((one_byte, big_endian_u16, little_endian_u32))
}

fn main() {
    let buf = vec![0, 1, 2, 3, 4, 5, 6];
    let input = Input::from(&buf);

    input.read_all(Error::UnknownError, read_stuff).expect("read_all to succeed");
}

Dependencies

~28KB