161 lines
4.0 KiB
Rust
Executable File
161 lines
4.0 KiB
Rust
Executable File
// Some utility interfaces
|
|
import doc::item_utils;
|
|
import doc::item;
|
|
import 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 {
|
|
|
|
#[doc(
|
|
brief =
|
|
"Run a series of passes over the document",
|
|
args(
|
|
srv =
|
|
"The AST service to provide to the passes",
|
|
doc =
|
|
"The document to transform",
|
|
passes =
|
|
"The list of passes used to transform the document"
|
|
),
|
|
return =
|
|
"The transformed document that results from folding the \
|
|
original through each pass"
|
|
)];
|
|
|
|
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"
|
|
with 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"
|
|
with 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) |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)
|
|
});
|
|
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)
|
|
)
|
|
]);
|
|
}
|
|
}
|