nestify 0.3.3

Nestify offers a macro to simplify and beautify nested struct definitions in Rust, enabling cleaner, more readable code structures with less verbosity. It's especially valuable for handling API responses.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use crate::special_data::Special;
use crate::unpack::Unpack;
use crate::unpack_context::UnpackContext;
use proc_macro_error::{abort_call_site, proc_macro_error};
use syn::parse_macro_input;

#[cfg(test)]
mod tests;
pub(crate) mod attributes;
pub(crate) mod discriminant;
pub(crate) mod fish;
pub(crate) mod special_data;
pub(crate) mod ty;
pub(crate) mod unpack_context;

/// Provides functionality for unpacking special data structures.
///
/// This module defines traits and implementations for recursively unpacking
/// data structures annotated with custom attributes, facilitating a form of
/// metaprogramming within Rust macros.
pub(crate) mod unpack;


/// Allows for the expansion of "nested" items
///
/// # Learn
/// See [Guide](https://github.com/snowfoxsh/nestify)
///
/// # Examples
///
/// Define a user profile with nested address and preferences structures
/// ```
/// nestify::nest! {
///     struct UserProfile {
///         name: String,
///         address: struct Address {
///             street: String,
///             city: String,
///         },
///         preferences: struct Preferences {
///             newsletter: bool,
///         },
///     }
/// }
/// ```
///
/// Define a task with a nested status enum
/// ```
/// nestify::nest! {
///     struct Task {
///         id: i32,
///         description: String,
///         status: enum Status {
///             Pending,
///             InProgress,
///             Completed,
///         },
///     }
/// }
/// ```
#[proc_macro]
#[proc_macro_error]
pub fn nest(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
    if input.is_empty() {
        abort_call_site!(
            "Nest! macro expansion failed: The input is empty.";
            note = "The nest! macro expects a non-empty `struct` or `enum` definition to function properly.";
            help = "Please ensure that you are using the nest! macro with a valid `struct` or `enum`.\
            Refer to documentation for information on how to use this macro and more examples";
        );
    }

    let def = parse_macro_input!(input as Special);

    def.unpack(UnpackContext::default(), Vec::default(), None, false).into()
}