crates/hir/src/lib.rs

   1 //! HIR (previously known as descriptors) provides a high-level object oriented
   2 //! access to Rust code.
   3 //!
   4 //! The principal difference between HIR and syntax trees is that HIR is bound
   5 //! to a particular crate instance. That is, it has cfg flags and features
   6 //! applied. So, the relation between syntax and HIR is many-to-one.
   7 //!
   8 //! HIR is the public API of the all of the compiler logic above syntax trees.
   9 //! It is written in "OO" style. Each type is self contained (as in, it knows it's
  10 //! parents and full context). It should be "clean code".
  11 //!
  12 //! `hir_*` crates are the implementation of the compiler logic.
  13 //! They are written in "ECS" style, with relatively little abstractions.
  14 //! Many types are not self-contained, and explicitly use local indexes, arenas, etc.
  15 //!
  16 //! `hir` is what insulates the "we don't know how to actually write an incremental compiler"
  17 //! from the ide with completions, hovers, etc. It is a (soft, internal) boundary:
  18 //! https://www.tedinski.com/2018/02/06/system-boundaries.html.
  19
  20 #![recursion_limit = "512"]
  21
  22 mod semantics;
  23 pub mod db;
  24 mod source_analyzer;
  25
  26 pub mod diagnostics;
  27
  28 mod from_id;
  29 mod code_model;
  30 mod attrs;
  31 mod has_source;
  32
  33 pub use crate::{
  34     attrs::{HasAttrs, Namespace},
  35     code_model::{
  36         Access, Adt, AsAssocItem, AssocItem, AssocItemContainer, Callable, CallableKind, Const,
  37         Crate, CrateDependency, DefWithBody, Enum, Field, FieldSource, Function, GenericDef,
  38         HasVisibility, Impl, Label, LifetimeParam, Local, MacroDef, Module, ModuleDef, ScopeDef,
  39         Static, Struct, Trait, Type, TypeAlias, TypeParam, Union, Variant, VariantDef,
  40     },
  41     has_source::HasSource,
  42     semantics::{PathResolution, Semantics, SemanticsScope},
  43 };
  44
  45 pub use hir_def::{
  46     adt::StructKind,
  47     attr::{Attrs, Documentation},
  48     body::scope::ExprScopes,
  49     builtin_type::BuiltinType,
  50     find_path::PrefixKind,
  51     import_map,
  52     item_scope::ItemInNs,
  53     nameres::ModuleSource,
  54     path::{ModPath, PathKind},
  55     type_ref::{Mutability, TypeRef},
  56     visibility::Visibility,
  57 };
  58 pub use hir_expand::{
  59     name::{known, AsName, Name},
  60     ExpandResult, HirFileId, InFile, MacroCallId, MacroCallLoc, /* FIXME */ MacroDefId,
  61     MacroFile, Origin,
  62 };
  63 pub use hir_ty::display::HirDisplay;
  64
  65 // These are negative re-exports: pub using these names is forbidden, they
  66 // should remain private to hir internals.
  67 #[allow(unused)]
  68 use {hir_def::path::Path, hir_expand::hygiene::Hygiene};