144 lines
3.6 KiB
Rust
Executable File
144 lines
3.6 KiB
Rust
Executable File
// Some utility interfaces
|
|
use doc::ItemUtils;
|
|
use doc::Item;
|
|
use doc::util;
|
|
|
|
/// A single operation on the document model
|
|
type Pass = {
|
|
name: ~str,
|
|
f: fn~(srv: astsrv::Srv, doc: doc::Doc) -> doc::Doc
|
|
};
|
|
|
|
fn run_passes(
|
|
srv: astsrv::Srv,
|
|
doc: doc::Doc,
|
|
passes: ~[Pass]
|
|
) -> doc::Doc {
|
|
let mut passno = 0;
|
|
do vec::foldl(doc, passes) |doc, pass| {
|
|
log(debug, fmt!("pass #%d", passno));
|
|
passno += 1;
|
|
log(debug, doc);
|
|
do time(pass.name) {
|
|
pass.f(srv, doc)
|
|
}
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_run_passes() {
|
|
fn pass1(
|
|
_srv: astsrv::Srv,
|
|
doc: doc::Doc
|
|
) -> doc::Doc {
|
|
doc::Doc_({
|
|
pages: ~[
|
|
doc::CratePage({
|
|
topmod: doc::ModDoc_({
|
|
item: {
|
|
name: doc.cratemod().name() + ~"two",
|
|
.. doc.cratemod().item
|
|
},
|
|
items: ~[],
|
|
index: None
|
|
})
|
|
})
|
|
]
|
|
})
|
|
}
|
|
fn pass2(
|
|
_srv: astsrv::Srv,
|
|
doc: doc::Doc
|
|
) -> doc::Doc {
|
|
doc::Doc_({
|
|
pages: ~[
|
|
doc::CratePage({
|
|
topmod: doc::ModDoc_({
|
|
item: {
|
|
name: doc.cratemod().name() + ~"three",
|
|
.. doc.cratemod().item
|
|
},
|
|
items: ~[],
|
|
index: None
|
|
})
|
|
})
|
|
]
|
|
})
|
|
}
|
|
let source = ~"";
|
|
do astsrv::from_str(source) |srv| {
|
|
let passes = ~[
|
|
{
|
|
name: ~"",
|
|
f: pass1
|
|
},
|
|
{
|
|
name: ~"",
|
|
f: pass2
|
|
}
|
|
];
|
|
let doc = extract::from_srv(srv, ~"one");
|
|
let doc = run_passes(srv, doc, passes);
|
|
assert doc.cratemod().name() == ~"onetwothree";
|
|
}
|
|
}
|
|
|
|
fn main(args: ~[~str]) {
|
|
|
|
if vec::contains(args, ~"-h") {
|
|
config::usage();
|
|
return;
|
|
}
|
|
|
|
let config = match config::parse_config(args) {
|
|
result::Ok(config) => config,
|
|
result::Err(err) => {
|
|
io::println(fmt!("error: %s", err));
|
|
return;
|
|
}
|
|
};
|
|
|
|
run(config);
|
|
}
|
|
|
|
fn time<T>(what: ~str, f: fn() -> T) -> T {
|
|
let start = std::time::precise_time_s();
|
|
let rv = f();
|
|
let end = std::time::precise_time_s();
|
|
info!("time: %3.3f s %s", end - start, what);
|
|
return rv;
|
|
}
|
|
|
|
/// Runs rustdoc over the given file
|
|
fn run(config: config::Config) {
|
|
|
|
let source_file = config.input_crate;
|
|
do astsrv::from_file(source_file.to_str()) |srv| {
|
|
do time(~"wait_ast") {
|
|
do astsrv::exec(srv) |_ctxt| { }
|
|
};
|
|
let doc = time(~"extract", || {
|
|
let default_name = source_file;
|
|
extract::from_srv(srv, default_name.to_str())
|
|
});
|
|
run_passes(srv, doc, ~[
|
|
tystr_pass::mk_pass(),
|
|
path_pass::mk_pass(),
|
|
attr_pass::mk_pass(),
|
|
escape_pass::mk_pass(),
|
|
prune_hidden_pass::mk_pass(),
|
|
desc_to_brief_pass::mk_pass(),
|
|
unindent_pass::mk_pass(),
|
|
sectionalize_pass::mk_pass(),
|
|
trim_pass::mk_pass(),
|
|
sort_item_name_pass::mk_pass(),
|
|
sort_item_type_pass::mk_pass(),
|
|
markdown_index_pass::mk_pass(config),
|
|
page_pass::mk_pass(config.output_style),
|
|
markdown_pass::mk_pass(
|
|
markdown_writer::make_writer_factory(config)
|
|
)
|
|
]);
|
|
}
|
|
}
|