2 releases

0.1.1 Nov 2, 2021
0.1.0 Feb 1, 2020

#1949 in Rust patterns

Download history 21/week @ 2023-12-17 57/week @ 2023-12-31 1/week @ 2024-01-07 18/week @ 2024-01-14 10/week @ 2024-01-21 1/week @ 2024-02-04 26/week @ 2024-02-18 25/week @ 2024-02-25

52 downloads per month

MIT/Apache

9KB

Struple

Crate Docs

Derive a trait for tuple <-> struct conversion for your own struct.

Basic example

use struple::Struple

#[derive(Struple)]
struct Foo(&'static str, u64, f32);

fn main() {
    let string = "hello";
    let int = 3u64;
    let float = 0.5f32;

    let foo = Foo::from_tuple((string, int, float));
    let (string, int, float) = foo.into_tuple(); 
}

Use cases

The main reason as to why I made this crate is because of nom and it's tuple parser combinator. This combinator allows easy chaining of serveral parsers in sequence but has the downside that you gotta destructure the tuple manually to put the data into the corresponding struct. This is cumbersome and bloats the code(at least in my opinion). With this one can just derive a tuple constructor for the struct and pass that constructor to the map function to map the tuple to the struct. It even allows to create a new combinator just for this:

pub fn struple<I, O1, O2, E, List>(l: List) -> impl Fn(I) -> nom::IResult<I, O2, E>
where
    I: Clone,
    O1: struple::GenericTuple,
    O2: struple::Struple<Tuple = O1>,
    E: nom::error::ParseError<I>,
    List: nom::sequence::Tuple<I, O1, E>,
{
    map(tuple(l), struple::Struple::from_tuple)
}

struct Vector3 {
    x: f32,
    y: f32,
    z: f32
}
// with struple
let (i, vec): (_, Vector3) = struple((le_f32, le_f32, le_f32))?;
// without struple
let (i, vec) = map(
    tuple((le_f32, le_f32, le_f32)),
    |(x, y, z)| Vector3 { x, y, z}
)?;

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~1.5MB
~33K SLoC