rust/src/rustdoc/fold.rs

export Fold;
export default_seq_fold;
export default_seq_fold_doc;
export default_seq_fold_crate;
export default_seq_fold_item;
export default_seq_fold_mod;
export default_seq_fold_nmod;
export default_seq_fold_fn;
export default_seq_fold_const;
export default_seq_fold_enum;
export default_seq_fold_trait;
export default_seq_fold_impl;
export default_seq_fold_type;
export default_par_fold;
export default_par_fold_mod;
export default_par_fold_nmod;
export default_any_fold;
export default_any_fold_mod;
export default_any_fold_nmod;

enum Fold<T> = Fold_<T>;

type FoldDoc<T> = fn~(fold: Fold<T>, doc: doc::Doc) -> doc::Doc;
type FoldCrate<T> = fn~(fold: Fold<T>, doc: doc::CrateDoc) -> doc::CrateDoc;
type FoldItem<T> = fn~(fold: Fold<T>, doc: doc::ItemDoc) -> doc::ItemDoc;
type FoldMod<T> = fn~(fold: Fold<T>, doc: doc::ModDoc) -> doc::ModDoc;
type FoldNmod<T> = fn~(fold: Fold<T>, doc: doc::NmodDoc) -> doc::NmodDoc;
type FoldFn<T> = fn~(fold: Fold<T>, doc: doc::FnDoc) -> doc::FnDoc;
type FoldConst<T> = fn~(fold: Fold<T>, doc: doc::ConstDoc) -> doc::ConstDoc;
type FoldEnum<T> = fn~(fold: Fold<T>, doc: doc::EnumDoc) -> doc::EnumDoc;
type FoldTrait<T> = fn~(fold: Fold<T>, doc: doc::TraitDoc) -> doc::TraitDoc;
type FoldImpl<T> = fn~(fold: Fold<T>, doc: doc::ImplDoc) -> doc::ImplDoc;
type FoldType<T> = fn~(fold: Fold<T>, doc: doc::TyDoc) -> doc::TyDoc;

type Fold_<T> = {
    ctxt: T,
    fold_doc: FoldDoc<T>,
    fold_crate: FoldCrate<T>,
    fold_item: FoldItem<T>,
    fold_mod: FoldMod<T>,
    fold_nmod: FoldNmod<T>,
    fold_fn: FoldFn<T>,
    fold_const: FoldConst<T>,
    fold_enum: FoldEnum<T>,
    fold_trait: FoldTrait<T>,
    fold_impl: FoldImpl<T>,
    fold_type: FoldType<T>
};


// This exists because fn types don't infer correctly as record
// initializers, but they do as function arguments
fn mk_fold<T:Copy>(
    ctxt: T,
    +fold_doc: FoldDoc<T>,
    +fold_crate: FoldCrate<T>,
    +fold_item: FoldItem<T>,
    +fold_mod: FoldMod<T>,
    +fold_nmod: FoldNmod<T>,
    +fold_fn: FoldFn<T>,
    +fold_const: FoldConst<T>,
    +fold_enum: FoldEnum<T>,
    +fold_trait: FoldTrait<T>,
    +fold_impl: FoldImpl<T>,
    +fold_type: FoldType<T>
) -> Fold<T> {
    Fold({
        ctxt: ctxt,
        fold_doc: fold_doc,
        fold_crate: fold_crate,
        fold_item: fold_item,
        fold_mod: fold_mod,
        fold_nmod: fold_nmod,
        fold_fn: fold_fn,
        fold_const: fold_const,
        fold_enum: fold_enum,
        fold_trait: fold_trait,
        fold_impl: fold_impl,
        fold_type: fold_type
    })
}

fn default_any_fold<T:Send Copy>(ctxt: T) -> Fold<T> {
    mk_fold(
        ctxt,
        |f, d| default_seq_fold_doc(f, d),
        |f, d| default_seq_fold_crate(f, d),
        |f, d| default_seq_fold_item(f, d),
        |f, d| default_any_fold_mod(f, d),
        |f, d| default_any_fold_nmod(f, d),
        |f, d| default_seq_fold_fn(f, d),
        |f, d| default_seq_fold_const(f, d),
        |f, d| default_seq_fold_enum(f, d),
        |f, d| default_seq_fold_trait(f, d),
        |f, d| default_seq_fold_impl(f, d),
        |f, d| default_seq_fold_type(f, d)
    )
}

fn default_seq_fold<T:Copy>(ctxt: T) -> Fold<T> {
    mk_fold(
        ctxt,
        |f, d| default_seq_fold_doc(f, d),
        |f, d| default_seq_fold_crate(f, d),
        |f, d| default_seq_fold_item(f, d),
        |f, d| default_seq_fold_mod(f, d),
        |f, d| default_seq_fold_nmod(f, d),
        |f, d| default_seq_fold_fn(f, d),
        |f, d| default_seq_fold_const(f, d),
        |f, d| default_seq_fold_enum(f, d),
        |f, d| default_seq_fold_trait(f, d),
        |f, d| default_seq_fold_impl(f, d),
        |f, d| default_seq_fold_type(f, d)
    )
}

fn default_par_fold<T:Send Copy>(ctxt: T) -> Fold<T> {
    mk_fold(
        ctxt,
        |f, d| default_seq_fold_doc(f, d),
        |f, d| default_seq_fold_crate(f, d),
        |f, d| default_seq_fold_item(f, d),
        |f, d| default_par_fold_mod(f, d),
        |f, d| default_par_fold_nmod(f, d),
        |f, d| default_seq_fold_fn(f, d),
        |f, d| default_seq_fold_const(f, d),
        |f, d| default_seq_fold_enum(f, d),
        |f, d| default_seq_fold_trait(f, d),
        |f, d| default_seq_fold_impl(f, d),
        |f, d| default_seq_fold_type(f, d)
    )
}

fn default_seq_fold_doc<T>(fold: Fold<T>, doc: doc::Doc) -> doc::Doc {
    doc::Doc_({
        pages: do vec::map(doc.pages) |page| {
            match page {
              doc::CratePage(doc) => {
                doc::CratePage(fold.fold_crate(fold, doc))
              }
              doc::ItemPage(doc) => {
                doc::ItemPage(fold_ItemTag(fold, doc))
              }
            }
        },
        .. *doc
    })
}

fn default_seq_fold_crate<T>(
    fold: Fold<T>,
    doc: doc::CrateDoc
) -> doc::CrateDoc {
    {
        topmod: fold.fold_mod(fold, doc.topmod)
    }
}

fn default_seq_fold_item<T>(
    _fold: Fold<T>,
    doc: doc::ItemDoc
) -> doc::ItemDoc {
    doc
}

fn default_any_fold_mod<T:Send Copy>(
    fold: Fold<T>,
    doc: doc::ModDoc
) -> doc::ModDoc {
    doc::ModDoc_({
        item: fold.fold_item(fold, doc.item),
        items: par::map(doc.items, |ItemTag, copy fold| {
            fold_ItemTag(fold, ItemTag)
        }),
        .. *doc
    })
}

fn default_seq_fold_mod<T>(
    fold: Fold<T>,
    doc: doc::ModDoc
) -> doc::ModDoc {
    doc::ModDoc_({
        item: fold.fold_item(fold, doc.item),
        items: vec::map(doc.items, |ItemTag| {
            fold_ItemTag(fold, ItemTag)
        }),
        .. *doc
    })
}

fn default_par_fold_mod<T:Send Copy>(
    fold: Fold<T>,
    doc: doc::ModDoc
) -> doc::ModDoc {
    doc::ModDoc_({
        item: fold.fold_item(fold, doc.item),
        items: par::map(doc.items, |ItemTag, copy fold| {
            fold_ItemTag(fold, ItemTag)
        }),
        .. *doc
    })
}

fn default_any_fold_nmod<T:Send Copy>(
    fold: Fold<T>,
    doc: doc::NmodDoc
) -> doc::NmodDoc {
    {
        item: fold.fold_item(fold, doc.item),
        fns: par::map(doc.fns, |FnDoc, copy fold| {
            fold.fold_fn(fold, FnDoc)
        }),
        .. doc
    }
}

fn default_seq_fold_nmod<T>(
    fold: Fold<T>,
    doc: doc::NmodDoc
) -> doc::NmodDoc {
    {
        item: fold.fold_item(fold, doc.item),
        fns: vec::map(doc.fns, |FnDoc| {
            fold.fold_fn(fold, FnDoc)
        }),
        .. doc
    }
}

fn default_par_fold_nmod<T:Send Copy>(
    fold: Fold<T>,
    doc: doc::NmodDoc
) -> doc::NmodDoc {
    {
        item: fold.fold_item(fold, doc.item),
        fns: par::map(doc.fns, |FnDoc, copy fold| {
            fold.fold_fn(fold, FnDoc)
        }),
        .. doc
    }
}

fn fold_ItemTag<T>(fold: Fold<T>, doc: doc::ItemTag) -> doc::ItemTag {
    match doc {
      doc::ModTag(ModDoc) => {
        doc::ModTag(fold.fold_mod(fold, ModDoc))
      }
      doc::NmodTag(nModDoc) => {
        doc::NmodTag(fold.fold_nmod(fold, nModDoc))
      }
      doc::FnTag(FnDoc) => {
        doc::FnTag(fold.fold_fn(fold, FnDoc))
      }
      doc::ConstTag(ConstDoc) => {
        doc::ConstTag(fold.fold_const(fold, ConstDoc))
      }
      doc::EnumTag(EnumDoc) => {
        doc::EnumTag(fold.fold_enum(fold, EnumDoc))
      }
      doc::TraitTag(TraitDoc) => {
        doc::TraitTag(fold.fold_trait(fold, TraitDoc))
      }
      doc::ImplTag(ImplDoc) => {
        doc::ImplTag(fold.fold_impl(fold, ImplDoc))
      }
      doc::TyTag(TyDoc) => {
        doc::TyTag(fold.fold_type(fold, TyDoc))
      }
    }
}

fn default_seq_fold_fn<T>(
    fold: Fold<T>,
    doc: doc::FnDoc
) -> doc::FnDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

fn default_seq_fold_const<T>(
    fold: Fold<T>,
    doc: doc::ConstDoc
) -> doc::ConstDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

fn default_seq_fold_enum<T>(
    fold: Fold<T>,
    doc: doc::EnumDoc
) -> doc::EnumDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

fn default_seq_fold_trait<T>(
    fold: Fold<T>,
    doc: doc::TraitDoc
) -> doc::TraitDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

fn default_seq_fold_impl<T>(
    fold: Fold<T>,
    doc: doc::ImplDoc
) -> doc::ImplDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

fn default_seq_fold_type<T>(
    fold: Fold<T>,
    doc: doc::TyDoc
) -> doc::TyDoc {
    {
        item: fold.fold_item(fold, doc.item),
        .. doc
    }
}

#[test]
fn default_fold_should_produce_same_doc() {
    let source = ~"mod a { fn b() { } mod c { fn d() { } } }";
    let ast = parse::from_str(source);
    let doc = extract::extract(ast, ~"");
    let fld = default_seq_fold(());
    let folded = fld.fold_doc(fld, doc);
    assert doc == folded;
}

#[test]
fn default_fold_should_produce_same_consts() {
    let source = ~"const a: int = 0;";
    let ast = parse::from_str(source);
    let doc = extract::extract(ast, ~"");
    let fld = default_seq_fold(());
    let folded = fld.fold_doc(fld, doc);
    assert doc == folded;
}

#[test]
fn default_fold_should_produce_same_enums() {
    let source = ~"enum a { b }";
    let ast = parse::from_str(source);
    let doc = extract::extract(ast, ~"");
    let fld = default_seq_fold(());
    let folded = fld.fold_doc(fld, doc);
    assert doc == folded;
}

#[test]
fn default_parallel_fold_should_produce_same_doc() {
    let source = ~"mod a { fn b() { } mod c { fn d() { } } }";
    let ast = parse::from_str(source);
    let doc = extract::extract(ast, ~"");
    let fld = default_par_fold(());
    let folded = fld.fold_doc(fld, doc);
    assert doc == folded;
}