fold.rs 3.8 KB
Newer Older
1
use crate::clean::*;
2

3
crate struct StripItem(pub Item);
4

M
Mark Rousskov 已提交
5
impl StripItem {
6
    crate fn strip(self) -> Option<Item> {
M
Mark Rousskov 已提交
7
        match self.0 {
8
            Item { kind: StrippedItem(..), .. } => Some(self.0),
M
Mark Rousskov 已提交
9
            mut i => {
10
                i.kind = StrippedItem(box i.kind);
11 12 13 14 15 16
                Some(i)
            }
        }
    }
}

17
crate trait DocFolder: Sized {
18 19 20 21 22
    fn fold_item(&mut self, item: Item) -> Option<Item> {
        self.fold_item_recur(item)
    }

    /// don't override!
23 24
    fn fold_inner_recur(&mut self, kind: ItemKind) -> ItemKind {
        match kind {
25
            StrippedItem(..) => unreachable!(),
M
Mark Rousskov 已提交
26
            ModuleItem(i) => ModuleItem(self.fold_mod(i)),
27
            StructItem(mut i) => {
M
mitaa 已提交
28 29
                let num_fields = i.fields.len();
                i.fields = i.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
M
Mark Rousskov 已提交
30 31
                i.fields_stripped |=
                    num_fields != i.fields.len() || i.fields.iter().any(|f| f.is_stripped());
32
                StructItem(i)
M
Mark Rousskov 已提交
33
            }
V
Vadim Petrochenkov 已提交
34 35 36
            UnionItem(mut i) => {
                let num_fields = i.fields.len();
                i.fields = i.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
M
Mark Rousskov 已提交
37 38
                i.fields_stripped |=
                    num_fields != i.fields.len() || i.fields.iter().any(|f| f.is_stripped());
V
Vadim Petrochenkov 已提交
39
                UnionItem(i)
M
Mark Rousskov 已提交
40
            }
41
            EnumItem(mut i) => {
M
mitaa 已提交
42 43
                let num_variants = i.variants.len();
                i.variants = i.variants.into_iter().filter_map(|x| self.fold_item(x)).collect();
M
Mark Rousskov 已提交
44 45
                i.variants_stripped |=
                    num_variants != i.variants.len() || i.variants.iter().any(|f| f.is_stripped());
46
                EnumItem(i)
M
Mark Rousskov 已提交
47
            }
48
            TraitItem(mut i) => {
M
mitaa 已提交
49
                i.items = i.items.into_iter().filter_map(|x| self.fold_item(x)).collect();
50
                TraitItem(i)
M
Mark Rousskov 已提交
51
            }
52
            ImplItem(mut i) => {
M
mitaa 已提交
53
                i.items = i.items.into_iter().filter_map(|x| self.fold_item(x)).collect();
54
                ImplItem(i)
M
Mark Rousskov 已提交
55
            }
56 57 58
            VariantItem(i) => {
                let i2 = i.clone(); // this clone is small
                match i.kind {
59
                    VariantKind::Struct(mut j) => {
M
mitaa 已提交
60 61
                        let num_fields = j.fields.len();
                        j.fields = j.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
M
Mark Rousskov 已提交
62 63 64 65 66
                        j.fields_stripped |= num_fields != j.fields.len()
                            || j.fields.iter().any(|f| f.is_stripped());
                        VariantItem(Variant { kind: VariantKind::Struct(j), ..i2 })
                    }
                    _ => VariantItem(i2),
67
                }
M
Mark Rousskov 已提交
68 69
            }
            x => x,
70 71 72 73 74
        }
    }

    /// don't override!
    fn fold_item_recur(&mut self, item: Item) -> Option<Item> {
75
        let Item { attrs, name, source, visibility, def_id, kind, stability, deprecation } = item;
76

77
        let kind = match kind {
78
            StrippedItem(box i) => StrippedItem(box self.fold_inner_recur(i)),
79
            _ => self.fold_inner_recur(kind),
80 81
        };

82
        Some(Item { attrs, name, source, kind, visibility, stability, deprecation, def_id })
83 84 85
    }

    fn fold_mod(&mut self, m: Module) -> Module {
86 87
        Module {
            is_crate: m.is_crate,
M
Mark Rousskov 已提交
88
            items: m.items.into_iter().filter_map(|i| self.fold_item(i)).collect(),
89
        }
90 91 92
    }

    fn fold_crate(&mut self, mut c: Crate) -> Crate {
93
        c.module = c.module.take().and_then(|module| self.fold_item(module));
94

95
        {
96 97 98 99 100
            let external_traits = { std::mem::take(&mut *c.external_traits.borrow_mut()) };
            for (k, mut v) in external_traits {
                v.items = v.items.into_iter().filter_map(|i| self.fold_item(i)).collect();
                c.external_traits.borrow_mut().insert(k, v);
            }
101
        }
M
mitaa 已提交
102
        c
103 104
    }
}