serde_derive/
lib.rs

1//! This crate provides Serde's two derive macros.
2//!
3//! ```edition2021
4//! # use serde_derive::{Deserialize, Serialize};
5//! #
6//! #[derive(Serialize, Deserialize)]
7//! # struct S;
8//! #
9//! # fn main() {}
10//! ```
11//!
12//! Please refer to [https://serde.rs/derive.html] for how to set this up.
13//!
14//! [https://serde.rs/derive.html]: https://serde.rs/derive.html
15
16#![doc(html_root_url = "https://docs.rs/serde_derive/1.0.219")]
17#![cfg_attr(not(check_cfg), allow(unexpected_cfgs))]
18// Ignored clippy lints
19#![allow(
20    // clippy false positive: https://github.com/rust-lang/rust-clippy/issues/7054
21    clippy::branches_sharing_code,
22    clippy::cognitive_complexity,
23    // clippy bug: https://github.com/rust-lang/rust-clippy/issues/7575
24    clippy::collapsible_match,
25    clippy::derive_partial_eq_without_eq,
26    clippy::enum_variant_names,
27    // clippy bug: https://github.com/rust-lang/rust-clippy/issues/6797
28    clippy::manual_map,
29    clippy::match_like_matches_macro,
30    clippy::needless_lifetimes,
31    clippy::needless_pass_by_value,
32    clippy::too_many_arguments,
33    clippy::trivially_copy_pass_by_ref,
34    clippy::used_underscore_binding,
35    clippy::wildcard_in_or_patterns,
36    // clippy bug: https://github.com/rust-lang/rust-clippy/issues/5704
37    clippy::unnested_or_patterns,
38)]
39// Ignored clippy_pedantic lints
40#![allow(
41    clippy::cast_possible_truncation,
42    clippy::checked_conversions,
43    clippy::doc_markdown,
44    clippy::elidable_lifetime_names,
45    clippy::enum_glob_use,
46    clippy::indexing_slicing,
47    clippy::items_after_statements,
48    clippy::let_underscore_untyped,
49    clippy::manual_assert,
50    clippy::map_err_ignore,
51    clippy::match_same_arms,
52    // clippy bug: https://github.com/rust-lang/rust-clippy/issues/6984
53    clippy::match_wildcard_for_single_variants,
54    clippy::module_name_repetitions,
55    clippy::must_use_candidate,
56    clippy::similar_names,
57    clippy::single_match_else,
58    clippy::struct_excessive_bools,
59    clippy::too_many_lines,
60    clippy::uninlined_format_args,
61    clippy::unseparated_literal_suffix,
62    clippy::unused_self,
63    clippy::use_self,
64    clippy::wildcard_imports
65)]
66#![cfg_attr(all(test, exhaustive), feature(non_exhaustive_omitted_patterns_lint))]
67
68extern crate proc_macro2;
69extern crate quote;
70extern crate syn;
71
72extern crate proc_macro;
73
74mod internals;
75
76use proc_macro::TokenStream;
77use syn::parse_macro_input;
78use syn::DeriveInput;
79
80#[macro_use]
81mod bound;
82#[macro_use]
83mod fragment;
84
85mod de;
86mod dummy;
87mod pretend;
88mod ser;
89mod this;
90
91#[proc_macro_derive(Serialize, attributes(serde))]
92pub fn derive_serialize(input: TokenStream) -> TokenStream {
93    let mut input = parse_macro_input!(input as DeriveInput);
94    ser::expand_derive_serialize(&mut input)
95        .unwrap_or_else(syn::Error::into_compile_error)
96        .into()
97}
98
99#[proc_macro_derive(Deserialize, attributes(serde))]
100pub fn derive_deserialize(input: TokenStream) -> TokenStream {
101    let mut input = parse_macro_input!(input as DeriveInput);
102    de::expand_derive_deserialize(&mut input)
103        .unwrap_or_else(syn::Error::into_compile_error)
104        .into()
105}