macroific_macro 3.0.1

Proc macros for the macroific crate
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

//! Proc macros for the [macroific](https://docs.rs/macroific) crate.

#![deny(clippy::correctness, clippy::suspicious)]
#![warn(clippy::complexity, clippy::perf, clippy::style, clippy::pedantic)]
#![allow(
    clippy::module_name_repetitions,
    clippy::wildcard_imports,
    clippy::uninlined_format_args
)]
#![warn(missing_docs)]

#[allow(unused_imports)]
use proc_macro::TokenStream as BaseTokenStream;

#[cfg(feature = "attr_parse")]
mod attr_parse;

/// Derive the `AttributeOptions` trait for a struct.
///
/// | Field options |  |
/// | ----- | ----- |
/// | `#[attr_opts(rename = "new_ident")]` | Use this ident when parsing instead of the struct field's name |
/// | `#[attr_opts(default = some_module::default_fn)]` | Use this function for the default value |
/// | `#[attr_opts(default = false)]` | Make this option required and error if it isn't provided |
///
/// The alternative syntax is fine too, `#[attr_opts(default(false))]`
#[cfg(feature = "attr_parse")]
#[proc_macro_derive(AttributeOptions, attributes(attr_opts))]
pub fn derive_attribute_options(input: BaseTokenStream) -> BaseTokenStream {
    attr_parse::run::<attr_parse::AttrOptionsDerive>(input)
}

/// Derive the `ParseOption` trait for a struct. Uses the same field options as [`AttributeOptions`].
///
/// | Container Options |  |
/// | ----- | ----- |
/// | `#[attr_opts(from_parse)]` | Call [`Parse::parse`](::syn::parse::Parse::parse) to implement `ParseOption`. `Parse` will also get implemented if this option is omitted or `false` |
#[cfg(feature = "attr_parse")]
#[proc_macro_derive(ParseOption, attributes(attr_opts))]
pub fn derive_parse_option(input: BaseTokenStream) -> BaseTokenStream {
    attr_parse::run::<attr_parse::ParseOptionDerive>(input)
}