src/librustdoc/doctree.rs

   1 //! This module is used to store stuff from Rust's AST in a more convenient
   2 //! manner (and with prettier names) before cleaning.
   3 crate use self::StructType::*;
   4
   5 use rustc_ast as ast;
   6 use rustc_span::{self, Span, Symbol};
   7
   8 use rustc_hir as hir;
   9
  10 crate struct Module<'hir> {
  11     crate name: Option<Symbol>,
  12     crate attrs: &'hir [ast::Attribute],
  13     crate where_outer: Span,
  14     crate where_inner: Span,
  15     crate imports: Vec<Import<'hir>>,
  16     crate mods: Vec<Module<'hir>>,
  17     crate id: hir::HirId,
  18     // (item, renamed)
  19     crate items: Vec<(&'hir hir::Item<'hir>, Option<Symbol>)>,
  20     crate foreigns: Vec<(&'hir hir::ForeignItem<'hir>, Option<Symbol>)>,
  21     crate macros: Vec<(&'hir hir::MacroDef<'hir>, Option<Symbol>)>,
  22     crate is_crate: bool,
  23 }
  24
  25 impl Module<'hir> {
  26     crate fn new(name: Option<Symbol>, attrs: &'hir [ast::Attribute]) -> Module<'hir> {
  27         Module {
  28             name,
  29             id: hir::CRATE_HIR_ID,
  30             where_outer: rustc_span::DUMMY_SP,
  31             where_inner: rustc_span::DUMMY_SP,
  32             attrs,
  33             imports: Vec::new(),
  34             mods: Vec::new(),
  35             items: Vec::new(),
  36             foreigns: Vec::new(),
  37             macros: Vec::new(),
  38             is_crate: false,
  39         }
  40     }
  41 }
  42
  43 #[derive(Debug, Clone, Copy)]
  44 crate enum StructType {
  45     /// A braced struct
  46     Plain,
  47     /// A tuple struct
  48     Tuple,
  49     /// A unit struct
  50     Unit,
  51 }
  52
  53 crate struct Variant<'hir> {
  54     crate name: Symbol,
  55     crate id: hir::HirId,
  56     crate def: &'hir hir::VariantData<'hir>,
  57 }
  58
  59 #[derive(Debug)]
  60 crate struct Import<'hir> {
  61     crate name: Symbol,
  62     crate id: hir::HirId,
  63     crate vis: &'hir hir::Visibility<'hir>,
  64     crate attrs: &'hir [ast::Attribute],
  65     crate path: &'hir hir::Path<'hir>,
  66     crate glob: bool,
  67     crate span: Span,
  68 }
  69
  70 crate fn struct_type_from_def(vdata: &hir::VariantData<'_>) -> StructType {
  71     match *vdata {
  72         hir::VariantData::Struct(..) => Plain,
  73         hir::VariantData::Tuple(..) => Tuple,
  74         hir::VariantData::Unit(..) => Unit,
  75     }
  76 }