doku 0.21.1

A framework for documenting Rust data structures
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
77
78
79
80
81
82
83
84
85
86
87
88

mod for_adjacently_tagged_enum;
mod for_externally_tagged_enum;
mod for_internally_tagged_enum;
mod for_untagged_enum;

use super::*;

impl<'ty> Ctxt<'_, 'ty, '_> {
    pub(super) fn try_expanding_variants(&mut self, ty: &'ty Type) -> bool {
        self.try_expanding_adjacently_tagged_variants(ty)
            || self.try_expanding_externally_tagged_variants(ty)
            || self.try_expanding_internally_tagged_variants(ty)
            || self.try_expanding_untagged_variants(ty)
    }

    /// Starts by collecting the visible variants of an enum, and then
    /// recursively walks through them to find all nested enums
    /// and convert them to new variants with equivalent structs.
    fn collect_variants(&self, variants: &[Variant]) -> Vec<Variant> {
        let variants = variants
            .iter()
            .filter(|variant| {
                self.vis
                    .allows(variant.serializable, variant.deserializable)
            })
            .map(ToOwned::to_owned);

        collect_variants(variants)
    }
}

fn collect_variants(
    variants: impl IntoIterator<Item = Variant>,
) -> Vec<Variant> {
    let mut modified = false;
    let mut new_variants = Vec::new();

    'outer: for variant in variants {
        match &variant.fields {
            Fields::Named { fields } => {
                for (i, (name, field)) in fields.iter().enumerate() {
                    if let Some(structs) = field.ty.enum_to_structs() {
                        for s in structs {
                            let mut new_variant = variant.clone();
                            if let Fields::Named { fields } =
                                &mut new_variant.fields
                            {
                                let mut new_field = field.to_owned();
                                new_field.ty = s;
                                fields[i] = (name, new_field);
                            }
                            new_variants.push(new_variant);
                        }
                        modified = true;
                        continue 'outer;
                    }
                }
            }
            Fields::Unnamed { fields } => {
                for (i, field) in fields.iter().enumerate() {
                    if let Some(structs) = field.ty.enum_to_structs() {
                        for s in structs {
                            let mut new_variant = variant.clone();
                            if let Fields::Unnamed { fields } =
                                &mut new_variant.fields
                            {
                                let mut new_field = field.to_owned();
                                new_field.ty = s;
                                fields[i] = new_field;
                            }
                            new_variants.push(new_variant);
                        }
                        modified = true;
                        continue 'outer;
                    }
                }
            }
            Fields::Unit => {}
        };
        new_variants.push(variant);
    }

    if modified {
        collect_variants(new_variants)
    } else {
        new_variants
    }
}