rustc_middle/
lib.rs

1//! The "main crate" of the Rust compiler. This crate contains common
2//! type definitions that are used by the other crates in the rustc
3//! "family". The following are some prominent examples.
4//!
5//! - **HIR.** The "high-level (H) intermediate representation (IR)" is
6//!   defined in the [`hir`] module.
7//! - **THIR.** The "typed high-level (H) intermediate representation (IR)"
8//!   is defined in the [`thir`] module.
9//! - **MIR.** The "mid-level (M) intermediate representation (IR)" is
10//!   defined in the [`mir`] module. This module contains only the
11//!   *definition* of the MIR; the passes that transform and operate
12//!   on MIR are found in `rustc_const_eval` crate.
13//! - **Types.** The internal representation of types used in rustc is
14//!   defined in the [`ty`] module. This includes the
15//!   [**type context**][ty::TyCtxt] (or `tcx`), which is the central
16//!   context during most of compilation, containing the interners and
17//!   other things.
18//!
19//! For more information about how rustc works, see the [rustc dev guide].
20//!
21//! [rustc dev guide]: https://rustc-dev-guide.rust-lang.org/
22//!
23//! # Note
24//!
25//! This API is completely unstable and subject to change.
26
27// tidy-alphabetical-start
28#![allow(internal_features)]
29#![allow(rustc::diagnostic_outside_of_impl)]
30#![allow(rustc::potential_query_instability)]
31#![allow(rustc::untranslatable_diagnostic)]
32#![cfg_attr(bootstrap, feature(trait_upcasting))]
33#![doc(html_root_url = "https://doc.rust-lang.org/nightly/nightly-rustc/")]
34#![doc(rust_logo)]
35#![feature(allocator_api)]
36#![feature(array_windows)]
37#![feature(assert_matches)]
38#![feature(associated_type_defaults)]
39#![feature(box_as_ptr)]
40#![feature(box_patterns)]
41#![feature(closure_track_caller)]
42#![feature(core_intrinsics)]
43#![feature(coroutines)]
44#![feature(debug_closure_helpers)]
45#![feature(decl_macro)]
46#![feature(discriminant_kind)]
47#![feature(extern_types)]
48#![feature(extract_if)]
49#![feature(file_buffered)]
50#![feature(if_let_guard)]
51#![feature(intra_doc_pointers)]
52#![feature(iter_from_coroutine)]
53#![feature(let_chains)]
54#![feature(min_specialization)]
55#![feature(negative_impls)]
56#![feature(never_type)]
57#![feature(ptr_alignment_type)]
58#![feature(rustc_attrs)]
59#![feature(rustdoc_internals)]
60#![feature(trusted_len)]
61#![feature(try_blocks)]
62#![feature(try_trait_v2)]
63#![feature(try_trait_v2_yeet)]
64#![feature(type_alias_impl_trait)]
65#![feature(yeet_expr)]
66#![warn(unreachable_pub)]
67// tidy-alphabetical-end
68
69#[cfg(test)]
70mod tests;
71
72#[macro_use]
73mod macros;
74
75#[macro_use]
76pub mod arena;
77pub mod error;
78pub mod hir;
79pub mod hooks;
80pub mod infer;
81pub mod lint;
82pub mod metadata;
83pub mod middle;
84pub mod mir;
85pub mod thir;
86pub mod traits;
87pub mod ty;
88pub mod util;
89mod values;
90
91#[macro_use]
92pub mod query;
93#[macro_use]
94pub mod dep_graph;
95
96// Allows macros to refer to this crate as `::rustc_middle`
97extern crate self as rustc_middle;
98
99rustc_fluent_macro::fluent_messages! { "../messages.ftl" }