musli_macros/
lib.rs

1//! [<img alt="github" src="https://img.shields.io/badge/github-udoprog/musli-8da0cb?style=for-the-badge&logo=github" height="20">](https://github.com/udoprog/musli)
2//! [<img alt="crates.io" src="https://img.shields.io/crates/v/musli-macros.svg?style=for-the-badge&color=fc8d62&logo=rust" height="20">](https://crates.io/crates/musli-macros)
3//! [<img alt="docs.rs" src="https://img.shields.io/badge/docs.rs-musli--macros-66c2a5?style=for-the-badge&logoColor=white&logo=data:image/svg+xml;base64,PHN2ZyByb2xlPSJpbWciIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDUxMiA1MTIiPjxwYXRoIGZpbGw9IiNmNWY1ZjUiIGQ9Ik00ODguNiAyNTAuMkwzOTIgMjE0VjEwNS41YzAtMTUtOS4zLTI4LjQtMjMuNC0zMy43bC0xMDAtMzcuNWMtOC4xLTMuMS0xNy4xLTMuMS0yNS4zIDBsLTEwMCAzNy41Yy0xNC4xIDUuMy0yMy40IDE4LjctMjMuNCAzMy43VjIxNGwtOTYuNiAzNi4yQzkuMyAyNTUuNSAwIDI2OC45IDAgMjgzLjlWMzk0YzAgMTMuNiA3LjcgMjYuMSAxOS45IDMyLjJsMTAwIDUwYzEwLjEgNS4xIDIyLjEgNS4xIDMyLjIgMGwxMDMuOS01MiAxMDMuOSA1MmMxMC4xIDUuMSAyMi4xIDUuMSAzMi4yIDBsMTAwLTUwYzEyLjItNi4xIDE5LjktMTguNiAxOS45LTMyLjJWMjgzLjljMC0xNS05LjMtMjguNC0yMy40LTMzLjd6TTM1OCAyMTQuOGwtODUgMzEuOXYtNjguMmw4NS0zN3Y3My4zek0xNTQgMTA0LjFsMTAyLTM4LjIgMTAyIDM4LjJ2LjZsLTEwMiA0MS40LTEwMi00MS40di0uNnptODQgMjkxLjFsLTg1IDQyLjV2LTc5LjFsODUtMzguOHY3NS40em0wLTExMmwtMTAyIDQxLjQtMTAyLTQxLjR2LS42bDEwMi0zOC4yIDEwMiAzOC4ydi42em0yNDAgMTEybC04NSA0Mi41di03OS4xbDg1LTM4Ljh2NzUuNHptMC0xMTJsLTEwMiA0MS40LTEwMi00MS40di0uNmwxMDItMzguMiAxMDIgMzguMnYuNnoiPjwvcGF0aD48L3N2Zz4K" height="20">](https://docs.rs/musli-macros)
4//!
5//! This crate provides the macros used in [Müsli]. The API of these macros is
6//! not expected to be stable and **must not** be used directly.
7//!
8//! Use the macros through the [`musli`] or [`musli_core`] crates instead.
9//!
10//! Please refer to <https://docs.rs/musli> for documentation.
11//!
12//! [`musli_core`]: <https://docs.rs/musli_core>
13//! [`musli`]: <https://docs.rs/musli>
14//! [Müsli]: <https://docs.rs/musli>
15
16#![allow(clippy::too_many_arguments)]
17#![allow(clippy::needless_late_init)]
18#![allow(clippy::type_complexity)]
19#![allow(missing_docs)]
20
21mod de;
22mod display;
23mod en;
24mod expander;
25mod internals;
26mod types;
27
28use proc_macro::TokenStream;
29use quote::ToTokens;
30use syn::parse::ParseStream;
31
32const MUSLI_CRATE: &str = "musli";
33const MUSLI_CORE_CRATE: &str = "musli_core";
34
35#[proc_macro_derive(Encode, attributes(musli))]
36#[doc(hidden)]
37pub fn musli_derive_encode(input: TokenStream) -> TokenStream {
38    derive_encode(input, MUSLI_CRATE)
39}
40
41#[proc_macro_derive(Decode, attributes(musli))]
42#[doc(hidden)]
43pub fn musli_derive_decode(input: TokenStream) -> TokenStream {
44    derive_decode(input, MUSLI_CRATE)
45}
46
47#[proc_macro_derive(MusliCoreEncode, attributes(musli))]
48#[doc(hidden)]
49pub fn musli_core_derive_encode(input: TokenStream) -> TokenStream {
50    derive_encode(input, MUSLI_CORE_CRATE)
51}
52
53#[proc_macro_derive(MusliCoreDecode, attributes(musli))]
54#[doc(hidden)]
55pub fn musli_core_derive_decode(input: TokenStream) -> TokenStream {
56    derive_decode(input, MUSLI_CORE_CRATE)
57}
58
59fn derive_encode(input: TokenStream, crate_default: &str) -> TokenStream {
60    let input = syn::parse_macro_input!(input as syn::DeriveInput);
61    let expander = expander::Expander::new(&input, crate_default);
62
63    match expander.expand_encode() {
64        Ok(tokens) => tokens.into(),
65        Err(()) => to_compile_errors(expander.into_errors()).into(),
66    }
67}
68
69fn derive_decode(input: TokenStream, crate_default: &str) -> TokenStream {
70    let input = syn::parse_macro_input!(input as syn::DeriveInput);
71    let expander = expander::Expander::new(&input, crate_default);
72
73    match expander.expand_decode() {
74        Ok(tokens) => tokens.into(),
75        Err(()) => to_compile_errors(expander.into_errors()).into(),
76    }
77}
78
79#[proc_macro_attribute]
80#[doc(hidden)]
81pub fn musli_trait_defaults(attr: TokenStream, input: TokenStream) -> TokenStream {
82    trait_defaults(attr, input, MUSLI_CRATE)
83}
84
85#[proc_macro_attribute]
86#[doc(hidden)]
87pub fn musli_core_trait_defaults(attr: TokenStream, input: TokenStream) -> TokenStream {
88    trait_defaults(attr, input, MUSLI_CORE_CRATE)
89}
90
91fn trait_defaults(
92    attr: TokenStream,
93    input: TokenStream,
94    default_crate: &'static str,
95) -> TokenStream {
96    let attr = syn::parse_macro_input!(attr as types::Attr);
97    let parser = move |input: ParseStream| types::parse(input, attr, default_crate);
98
99    match syn::parse::Parser::parse(parser, input) {
100        Ok(types) => types.to_token_stream().into(),
101        Err(err) => err.to_compile_error().into(),
102    }
103}
104
105fn to_compile_errors(errors: Vec<syn::Error>) -> proc_macro2::TokenStream {
106    let mut output = proc_macro2::TokenStream::new();
107
108    for e in errors {
109        output.extend(e.to_compile_error());
110    }
111
112    output
113}
musli_macros/lib.rs

musli_macros/
lib.rs
