3425901d93
If a reexport comes from a non-public module, then the documentation for the reexport will be inlined into the module that exports it, but if the reexport is targeted at a public type (like the prelude), then it is not inlined but rather hyperlinked.
291 lines
9.8 KiB
Rust
291 lines
9.8 KiB
Rust
// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
//! Rust AST Visitor. Extracts useful information and massages it into a form
|
|
//! usable for clean
|
|
|
|
use syntax::abi::AbiSet;
|
|
use syntax::ast;
|
|
use syntax::ast_util;
|
|
use syntax::ast_map;
|
|
use syntax::codemap::Span;
|
|
|
|
use core;
|
|
use doctree::*;
|
|
|
|
pub struct RustdocVisitor<'a> {
|
|
module: Module,
|
|
attrs: ~[ast::Attribute],
|
|
cx: &'a core::DocContext,
|
|
analysis: Option<&'a core::CrateAnalysis>,
|
|
}
|
|
|
|
impl<'a> RustdocVisitor<'a> {
|
|
pub fn new<'b>(cx: &'b core::DocContext,
|
|
analysis: Option<&'b core::CrateAnalysis>) -> RustdocVisitor<'b> {
|
|
RustdocVisitor {
|
|
module: Module::new(None),
|
|
attrs: ~[],
|
|
cx: cx,
|
|
analysis: analysis,
|
|
}
|
|
}
|
|
|
|
pub fn visit(&mut self, crate: &ast::Crate) {
|
|
self.attrs = crate.attrs.clone();
|
|
|
|
self.module = self.visit_mod_contents(crate.span, crate.attrs.clone(),
|
|
ast::public, ast::CRATE_NODE_ID,
|
|
&crate.module, None);
|
|
}
|
|
|
|
pub fn visit_struct_def(&mut self, item: &ast::item, sd: @ast::struct_def,
|
|
|
|
generics: &ast::Generics) -> Struct {
|
|
debug!("Visiting struct");
|
|
let struct_type = struct_type_from_def(sd);
|
|
Struct {
|
|
id: item.id,
|
|
struct_type: struct_type,
|
|
name: item.ident,
|
|
vis: item.vis,
|
|
attrs: item.attrs.clone(),
|
|
generics: generics.clone(),
|
|
fields: sd.fields.clone(),
|
|
where: item.span
|
|
}
|
|
}
|
|
|
|
pub fn visit_enum_def(&mut self, it: &ast::item, def: &ast::enum_def,
|
|
params: &ast::Generics) -> Enum {
|
|
debug!("Visiting enum");
|
|
let mut vars: ~[Variant] = ~[];
|
|
for x in def.variants.iter() {
|
|
vars.push(Variant {
|
|
name: x.node.name,
|
|
attrs: x.node.attrs.clone(),
|
|
vis: x.node.vis,
|
|
id: x.node.id,
|
|
kind: x.node.kind.clone(),
|
|
where: x.span,
|
|
});
|
|
}
|
|
Enum {
|
|
name: it.ident,
|
|
variants: vars,
|
|
vis: it.vis,
|
|
generics: params.clone(),
|
|
attrs: it.attrs.clone(),
|
|
id: it.id,
|
|
where: it.span,
|
|
}
|
|
}
|
|
|
|
pub fn visit_fn(&mut self, item: &ast::item, fd: &ast::fn_decl,
|
|
purity: &ast::purity, _abi: &AbiSet,
|
|
gen: &ast::Generics) -> Function {
|
|
debug!("Visiting fn");
|
|
Function {
|
|
id: item.id,
|
|
vis: item.vis,
|
|
attrs: item.attrs.clone(),
|
|
decl: fd.clone(),
|
|
name: item.ident,
|
|
where: item.span,
|
|
generics: gen.clone(),
|
|
purity: *purity,
|
|
}
|
|
}
|
|
|
|
pub fn visit_mod_contents(&mut self, span: Span, attrs: ~[ast::Attribute],
|
|
vis: ast::visibility, id: ast::NodeId,
|
|
m: &ast::_mod,
|
|
name: Option<ast::Ident>) -> Module {
|
|
let mut om = Module::new(name);
|
|
for item in m.view_items.iter() {
|
|
self.visit_view_item(item, &mut om);
|
|
}
|
|
om.where = span;
|
|
om.attrs = attrs;
|
|
om.vis = vis;
|
|
om.id = id;
|
|
for i in m.items.iter() {
|
|
self.visit_item(*i, &mut om);
|
|
}
|
|
om
|
|
}
|
|
|
|
pub fn visit_view_item(&mut self, item: &ast::view_item, om: &mut Module) {
|
|
if item.vis != ast::public {
|
|
return om.view_items.push(item.clone());
|
|
}
|
|
let item = match item.node {
|
|
ast::view_item_use(ref paths) => {
|
|
// rustc no longer supports "use foo, bar;"
|
|
assert_eq!(paths.len(), 1);
|
|
match self.visit_view_path(paths[0], om) {
|
|
None => return,
|
|
Some(path) => {
|
|
ast::view_item {
|
|
node: ast::view_item_use(~[path]),
|
|
.. item.clone()
|
|
}
|
|
}
|
|
}
|
|
}
|
|
ast::view_item_extern_mod(..) => item.clone()
|
|
};
|
|
om.view_items.push(item);
|
|
}
|
|
|
|
fn visit_view_path(&mut self, path: @ast::view_path,
|
|
om: &mut Module) -> Option<@ast::view_path> {
|
|
match path.node {
|
|
ast::view_path_simple(_, _, id) => {
|
|
if self.resolve_id(id, false, om) { return None }
|
|
}
|
|
ast::view_path_list(ref p, ref paths, ref b) => {
|
|
let mut mine = ~[];
|
|
for path in paths.iter() {
|
|
if !self.resolve_id(path.node.id, false, om) {
|
|
mine.push(path.clone());
|
|
}
|
|
}
|
|
|
|
if mine.len() == 0 { return None }
|
|
return Some(@::syntax::codemap::Spanned {
|
|
node: ast::view_path_list(p.clone(), mine, b.clone()),
|
|
span: path.span,
|
|
})
|
|
}
|
|
|
|
// these are feature gated anyway
|
|
ast::view_path_glob(_, id) => {
|
|
if self.resolve_id(id, true, om) { return None }
|
|
}
|
|
}
|
|
return Some(path);
|
|
}
|
|
|
|
fn resolve_id(&mut self, id: ast::NodeId, glob: bool,
|
|
om: &mut Module) -> bool {
|
|
let def = {
|
|
let dm = match self.cx.tycx {
|
|
Some(tcx) => tcx.def_map.borrow(),
|
|
None => return false,
|
|
};
|
|
ast_util::def_id_of_def(*dm.get().get(&id))
|
|
};
|
|
if !ast_util::is_local(def) { return false }
|
|
let analysis = match self.analysis {
|
|
Some(analysis) => analysis, None => return false
|
|
};
|
|
if analysis.public_items.contains(&def.node) { return false }
|
|
|
|
let item = {
|
|
let items = self.cx.tycx.unwrap().items.borrow();
|
|
*items.get().get(&def.node)
|
|
};
|
|
match item {
|
|
ast_map::node_item(it, _) => {
|
|
if glob {
|
|
match it.node {
|
|
ast::item_mod(ref m) => {
|
|
for vi in m.view_items.iter() {
|
|
self.visit_view_item(vi, om);
|
|
}
|
|
for i in m.items.iter() {
|
|
self.visit_item(*i, om);
|
|
}
|
|
}
|
|
_ => { fail!("glob not mapped to a module"); }
|
|
}
|
|
} else {
|
|
self.visit_item(it, om);
|
|
}
|
|
true
|
|
}
|
|
_ => false,
|
|
}
|
|
}
|
|
|
|
pub fn visit_item(&mut self, item: &ast::item, om: &mut Module) {
|
|
debug!("Visiting item {:?}", item);
|
|
match item.node {
|
|
ast::item_mod(ref m) => {
|
|
om.mods.push(self.visit_mod_contents(item.span, item.attrs.clone(),
|
|
item.vis, item.id, m,
|
|
Some(item.ident)));
|
|
},
|
|
ast::item_enum(ref ed, ref gen) =>
|
|
om.enums.push(self.visit_enum_def(item, ed, gen)),
|
|
ast::item_struct(sd, ref gen) =>
|
|
om.structs.push(self.visit_struct_def(item, sd, gen)),
|
|
ast::item_fn(fd, ref pur, ref abi, ref gen, _) =>
|
|
om.fns.push(self.visit_fn(item, fd, pur, abi, gen)),
|
|
ast::item_ty(ty, ref gen) => {
|
|
let t = Typedef {
|
|
ty: ty,
|
|
gen: gen.clone(),
|
|
name: item.ident,
|
|
id: item.id,
|
|
attrs: item.attrs.clone(),
|
|
where: item.span,
|
|
vis: item.vis,
|
|
};
|
|
om.typedefs.push(t);
|
|
},
|
|
ast::item_static(ty, ref mut_, ref exp) => {
|
|
let s = Static {
|
|
type_: ty,
|
|
mutability: mut_.clone(),
|
|
expr: exp.clone(),
|
|
id: item.id,
|
|
name: item.ident,
|
|
attrs: item.attrs.clone(),
|
|
where: item.span,
|
|
vis: item.vis,
|
|
};
|
|
om.statics.push(s);
|
|
},
|
|
ast::item_trait(ref gen, ref tr, ref met) => {
|
|
let t = Trait {
|
|
name: item.ident,
|
|
methods: met.clone(),
|
|
generics: gen.clone(),
|
|
parents: tr.clone(),
|
|
id: item.id,
|
|
attrs: item.attrs.clone(),
|
|
where: item.span,
|
|
vis: item.vis,
|
|
};
|
|
om.traits.push(t);
|
|
},
|
|
ast::item_impl(ref gen, ref tr, ty, ref meths) => {
|
|
let i = Impl {
|
|
generics: gen.clone(),
|
|
trait_: tr.clone(),
|
|
for_: ty,
|
|
methods: meths.clone(),
|
|
attrs: item.attrs.clone(),
|
|
id: item.id,
|
|
where: item.span,
|
|
vis: item.vis,
|
|
};
|
|
om.impls.push(i);
|
|
},
|
|
ast::item_foreign_mod(ref fm) => {
|
|
om.foreigns.push(fm.clone());
|
|
}
|
|
_ => (),
|
|
}
|
|
}
|
|
}
|