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

3 4
crate fn strip_item(mut item: Item) -> Item {
    if !matches!(*item.kind, StrippedItem(..)) {
E
est31 已提交
5
        item.kind = box StrippedItem(item.kind);
6
    }
7
    item
8 9
}

10
crate trait DocFolder: Sized {
11
    fn fold_item(&mut self, item: Item) -> Option<Item> {
12
        Some(self.fold_item_recur(item))
13 14 15
    }

    /// don't override!
16 17
    fn fold_inner_recur(&mut self, kind: ItemKind) -> ItemKind {
        match kind {
18
            StrippedItem(..) => unreachable!(),
M
Mark Rousskov 已提交
19
            ModuleItem(i) => ModuleItem(self.fold_mod(i)),
20
            StructItem(mut i) => {
M
mitaa 已提交
21 22
                let num_fields = i.fields.len();
                i.fields = i.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
23 24 25 26
                if !i.fields_stripped {
                    i.fields_stripped =
                        num_fields != i.fields.len() || i.fields.iter().any(|f| f.is_stripped());
                }
27
                StructItem(i)
M
Mark Rousskov 已提交
28
            }
V
Vadim Petrochenkov 已提交
29 30 31
            UnionItem(mut i) => {
                let num_fields = i.fields.len();
                i.fields = i.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
32 33 34 35
                if !i.fields_stripped {
                    i.fields_stripped =
                        num_fields != i.fields.len() || i.fields.iter().any(|f| f.is_stripped());
                }
V
Vadim Petrochenkov 已提交
36
                UnionItem(i)
M
Mark Rousskov 已提交
37
            }
38
            EnumItem(mut i) => {
M
mitaa 已提交
39 40
                let num_variants = i.variants.len();
                i.variants = i.variants.into_iter().filter_map(|x| self.fold_item(x)).collect();
41 42 43 44
                if !i.variants_stripped {
                    i.variants_stripped = num_variants != i.variants.len()
                        || i.variants.iter().any(|f| f.is_stripped());
                }
45
                EnumItem(i)
M
Mark Rousskov 已提交
46
            }
47
            TraitItem(mut i) => {
M
mitaa 已提交
48
                i.items = i.items.into_iter().filter_map(|x| self.fold_item(x)).collect();
49
                TraitItem(i)
M
Mark Rousskov 已提交
50
            }
51
            ImplItem(mut i) => {
M
mitaa 已提交
52
                i.items = i.items.into_iter().filter_map(|x| self.fold_item(x)).collect();
53
                ImplItem(i)
M
Mark Rousskov 已提交
54
            }
N
Noah Lev 已提交
55 56 57 58
            VariantItem(i) => match i {
                Variant::Struct(mut j) => {
                    let num_fields = j.fields.len();
                    j.fields = j.fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
59 60 61 62
                    if !j.fields_stripped {
                        j.fields_stripped = num_fields != j.fields.len()
                            || j.fields.iter().any(|f| f.is_stripped());
                    }
N
Noah Lev 已提交
63
                    VariantItem(Variant::Struct(j))
64
                }
N
Noah Lev 已提交
65 66 67 68 69 70
                Variant::Tuple(fields) => {
                    let fields = fields.into_iter().filter_map(|x| self.fold_item(x)).collect();
                    VariantItem(Variant::Tuple(fields))
                }
                Variant::CLike => VariantItem(Variant::CLike),
            },
71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
            ExternCrateItem { src: _ }
            | ImportItem(_)
            | FunctionItem(_)
            | TypedefItem(_, _)
            | OpaqueTyItem(_)
            | StaticItem(_)
            | ConstantItem(_)
            | TraitAliasItem(_)
            | TyMethodItem(_)
            | MethodItem(_, _)
            | StructFieldItem(_)
            | ForeignFunctionItem(_)
            | ForeignStaticItem(_)
            | ForeignTypeItem
            | MacroItem(_)
            | ProcMacroItem(_)
            | PrimitiveItem(_)
            | AssocConstItem(_, _)
89
            | AssocTypeItem(..)
90
            | KeywordItem(_) => kind,
91 92 93 94
        }
    }

    /// don't override!
95
    fn fold_item_recur(&mut self, mut item: Item) -> Item {
E
est31 已提交
96 97
        item.kind = box match *item.kind {
            StrippedItem(box i) => StrippedItem(box self.fold_inner_recur(i)),
98
            _ => self.fold_inner_recur(*item.kind),
E
est31 已提交
99
        };
100
        item
101 102 103
    }

    fn fold_mod(&mut self, m: Module) -> Module {
J
Joshua Nelson 已提交
104 105 106 107
        Module {
            span: m.span,
            items: m.items.into_iter().filter_map(|i| self.fold_item(i)).collect(),
        }
108 109 110
    }

    fn fold_crate(&mut self, mut c: Crate) -> Crate {
111
        c.module = self.fold_item(c.module).unwrap();
112

113 114 115 116
        let external_traits = { std::mem::take(&mut *c.external_traits.borrow_mut()) };
        for (k, mut v) in external_traits {
            v.trait_.items = v.trait_.items.into_iter().filter_map(|i| self.fold_item(i)).collect();
            c.external_traits.borrow_mut().insert(k, v);
117
        }
118

M
mitaa 已提交
119
        c
120 121
    }
}