Skip to content

Commit 5f3fd99

Browse files
Make serializer/deserializer internals doc(hidden)
1 parent d6de911 commit 5f3fd99

File tree

2 files changed

+21
-0
lines changed

2 files changed

+21
-0
lines changed

serde_derive/src/de.rs

+18
Original file line numberDiff line numberDiff line change
@@ -419,6 +419,7 @@ fn deserialize_unit_struct(params: &Parameters, cattrs: &attr::Container) -> Fra
419419
let expecting = cattrs.expecting().unwrap_or(&expecting);
420420

421421
quote_block! {
422+
#[doc(hidden)]
422423
struct __Visitor;
423424

424425
impl<'de> _serde::de::Visitor<'de> for __Visitor {
@@ -515,6 +516,7 @@ fn deserialize_tuple(
515516
};
516517

517518
quote_block! {
519+
#[doc(hidden)]
518520
struct __Visitor #de_impl_generics #where_clause {
519521
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
520522
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -605,6 +607,7 @@ fn deserialize_tuple_in_place(
605607
let place_life = place_lifetime();
606608

607609
quote_block! {
610+
#[doc(hidden)]
608611
struct __Visitor #in_place_impl_generics #where_clause {
609612
place: &#place_life mut #this_type #ty_generics,
610613
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -1020,6 +1023,7 @@ fn deserialize_struct(
10201023
quote_block! {
10211024
#field_visitor
10221025

1026+
#[doc(hidden)]
10231027
struct __Visitor #de_impl_generics #where_clause {
10241028
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
10251029
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -1132,6 +1136,7 @@ fn deserialize_struct_in_place(
11321136
Some(quote_block! {
11331137
#field_visitor
11341138

1139+
#[doc(hidden)]
11351140
struct __Visitor #in_place_impl_generics #where_clause {
11361141
place: &#place_life mut #this_type #ty_generics,
11371142
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -1203,6 +1208,7 @@ fn prepare_enum_variant_enum(
12031208
let variants_stmt = {
12041209
let variant_names = variant_names_idents.iter().map(|(name, _, _)| name);
12051210
quote! {
1211+
#[doc(hidden)]
12061212
const VARIANTS: &'static [&'static str] = &[ #(#variant_names),* ];
12071213
}
12081214
};
@@ -1275,6 +1281,7 @@ fn deserialize_externally_tagged_enum(
12751281
quote_block! {
12761282
#variant_visitor
12771283

1284+
#[doc(hidden)]
12781285
struct __Visitor #de_impl_generics #where_clause {
12791286
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
12801287
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -1522,6 +1529,7 @@ fn deserialize_adjacently_tagged_enum(
15221529

15231530
#variants_stmt
15241531

1532+
#[doc(hidden)]
15251533
struct __Seed #de_impl_generics #where_clause {
15261534
field: __Field,
15271535
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
@@ -1541,6 +1549,7 @@ fn deserialize_adjacently_tagged_enum(
15411549
}
15421550
}
15431551

1552+
#[doc(hidden)]
15441553
struct __Visitor #de_impl_generics #where_clause {
15451554
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
15461555
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -1643,6 +1652,7 @@ fn deserialize_adjacently_tagged_enum(
16431652
}
16441653
}
16451654

1655+
#[doc(hidden)]
16461656
const FIELDS: &'static [&'static str] = &[#tag, #content];
16471657
_serde::Deserializer::deserialize_struct(
16481658
__deserializer,
@@ -1954,11 +1964,13 @@ fn deserialize_generated_identifier(
19541964

19551965
quote_block! {
19561966
#[allow(non_camel_case_types)]
1967+
#[doc(hidden)]
19571968
enum __Field #lifetime {
19581969
#(#field_idents,)*
19591970
#ignore_variant
19601971
}
19611972

1973+
#[doc(hidden)]
19621974
struct __FieldVisitor;
19631975

19641976
impl<'de> _serde::de::Visitor<'de> for __FieldVisitor {
@@ -2046,11 +2058,13 @@ fn deserialize_custom_identifier(
20462058
None
20472059
} else if is_variant {
20482060
let variants = quote! {
2061+
#[doc(hidden)]
20492062
const VARIANTS: &'static [&'static str] = &[ #(#names),* ];
20502063
};
20512064
Some(variants)
20522065
} else {
20532066
let fields = quote! {
2067+
#[doc(hidden)]
20542068
const FIELDS: &'static [&'static str] = &[ #(#names),* ];
20552069
};
20562070
Some(fields)
@@ -2072,6 +2086,7 @@ fn deserialize_custom_identifier(
20722086
quote_block! {
20732087
#names_const
20742088

2089+
#[doc(hidden)]
20752090
struct __FieldVisitor #de_impl_generics #where_clause {
20762091
marker: _serde::__private::PhantomData<#this_type #ty_generics>,
20772092
lifetime: _serde::__private::PhantomData<&#delife ()>,
@@ -2406,6 +2421,7 @@ fn deserialize_struct_as_struct_visitor(
24062421
.flat_map(|(_, _, aliases)| aliases);
24072422

24082423
quote_block! {
2424+
#[doc(hidden)]
24092425
const FIELDS: &'static [&'static str] = &[ #(#field_names),* ];
24102426
}
24112427
};
@@ -2684,6 +2700,7 @@ fn deserialize_struct_as_struct_in_place_visitor(
26842700
let fields_stmt = {
26852701
let field_names = field_names_idents.iter().map(|(name, _, _)| name);
26862702
quote_block! {
2703+
#[doc(hidden)]
26872704
const FIELDS: &'static [&'static str] = &[ #(#field_names),* ];
26882705
}
26892706
};
@@ -2864,6 +2881,7 @@ fn wrap_deserialize_with(
28642881
let delife = params.borrowed.de_lifetime();
28652882

28662883
let wrapper = quote! {
2884+
#[doc(hidden)]
28672885
struct __DeserializeWith #de_impl_generics #where_clause {
28682886
value: #value_ty,
28692887
phantom: _serde::__private::PhantomData<#this_type #ty_generics>,

serde_derive/src/ser.rs

+3
Original file line numberDiff line numberDiff line change
@@ -719,6 +719,7 @@ fn serialize_adjacently_tagged_variant(
719719
let (wrapper_impl_generics, wrapper_ty_generics, _) = wrapper_generics.split_for_impl();
720720

721721
quote_block! {
722+
#[doc(hidden)]
722723
struct __AdjacentlyTagged #wrapper_generics #where_clause {
723724
data: (#(&'__a #fields_ty,)*),
724725
phantom: _serde::__private::PhantomData<#this_type #ty_generics>,
@@ -982,6 +983,7 @@ fn serialize_struct_variant_with_flatten(
982983
let (wrapper_impl_generics, wrapper_ty_generics, _) = wrapper_generics.split_for_impl();
983984

984985
quote_block! {
986+
#[doc(hidden)]
985987
struct __EnumFlatten #wrapper_generics #where_clause {
986988
data: (#(&'__a #fields_ty,)*),
987989
phantom: _serde::__private::PhantomData<#this_type #ty_generics>,
@@ -1212,6 +1214,7 @@ fn wrap_serialize_with(
12121214
});
12131215

12141216
quote!({
1217+
#[doc(hidden)]
12151218
struct __SerializeWith #wrapper_impl_generics #where_clause {
12161219
values: (#(&'__a #field_tys, )*),
12171220
phantom: _serde::__private::PhantomData<#this_type #ty_generics>,

0 commit comments

Comments
 (0)