src/libsyntax/lib.rs

   1 // Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 //! The Rust parser and macro expander.
  12 //!
  13 //! # Note
  14 //!
  15 //! This API is completely unstable and subject to change.
  16
  17 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
  18        html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
  19        html_root_url = "https://doc.rust-lang.org/nightly/",
  20        test(attr(deny(warnings))))]
  21 #![deny(warnings)]
  22
  23 #![feature(unicode)]
  24 #![feature(rustc_diagnostic_macros)]
  25 #![feature(match_default_bindings)]
  26 #![feature(non_exhaustive)]
  27 #![feature(i128_type)]
  28 #![feature(const_atomic_usize_new)]
  29 #![feature(rustc_attrs)]
  30
  31 // See librustc_cratesio_shim/Cargo.toml for a comment explaining this.
  32 #[allow(unused_extern_crates)]
  33 extern crate rustc_cratesio_shim;
  34
  35 #[macro_use] extern crate bitflags;
  36 extern crate serialize;
  37 #[macro_use] extern crate log;
  38 extern crate std_unicode;
  39 pub extern crate rustc_errors as errors;
  40 extern crate syntax_pos;
  41 extern crate rustc_data_structures;
  42
  43 extern crate serialize as rustc_serialize; // used by deriving
  44
  45 // A variant of 'try!' that panics on an Err. This is used as a crutch on the
  46 // way towards a non-panic!-prone parser. It should be used for fatal parsing
  47 // errors; eventually we plan to convert all code using panictry to just use
  48 // normal try.
  49 // Exported for syntax_ext, not meant for general use.
  50 #[macro_export]
  51 macro_rules! panictry {
  52     ($e:expr) => ({
  53         use std::result::Result::{Ok, Err};
  54         use errors::FatalError;
  55         match $e {
  56             Ok(e) => e,
  57             Err(mut e) => {
  58                 e.emit();
  59                 FatalError.raise()
  60             }
  61         }
  62     })
  63 }
  64
  65 #[macro_export]
  66 macro_rules! unwrap_or {
  67     ($opt:expr, $default:expr) => {
  68         match $opt {
  69             Some(x) => x,
  70             None => $default,
  71         }
  72     }
  73 }
  74
  75 #[macro_use]
  76 pub mod diagnostics {
  77     #[macro_use]
  78     pub mod macros;
  79     pub mod plugin;
  80     pub mod metadata;
  81 }
  82
  83 // NB: This module needs to be declared first so diagnostics are
  84 // registered before they are used.
  85 pub mod diagnostic_list;
  86
  87 pub mod util {
  88     pub mod lev_distance;
  89     pub mod node_count;
  90     pub mod parser;
  91     #[cfg(test)]
  92     pub mod parser_testing;
  93     pub mod small_vector;
  94     pub mod move_map;
  95
  96     mod thin_vec;
  97     pub use self::thin_vec::ThinVec;
  98
  99     mod rc_slice;
 100     pub use self::rc_slice::RcSlice;
 101 }
 102
 103 pub mod json;
 104
 105 pub mod syntax {
 106     pub use ext;
 107     pub use parse;
 108     pub use ast;
 109 }
 110
 111 pub mod abi;
 112 pub mod ast;
 113 pub mod attr;
 114 pub mod codemap;
 115 #[macro_use]
 116 pub mod config;
 117 pub mod entry;
 118 pub mod epoch;
 119 pub mod feature_gate;
 120 pub mod fold;
 121 pub mod parse;
 122 pub mod ptr;
 123 pub mod show_span;
 124 pub mod std_inject;
 125 pub mod str;
 126 pub use syntax_pos::symbol;
 127 pub mod test;
 128 pub mod tokenstream;
 129 pub mod visit;
 130
 131 pub mod print {
 132     pub mod pp;
 133     pub mod pprust;
 134 }
 135
 136 pub mod ext {
 137     pub use syntax_pos::hygiene;
 138     pub mod base;
 139     pub mod build;
 140     pub mod derive;
 141     pub mod expand;
 142     pub mod placeholders;
 143     pub mod quote;
 144     pub mod source_util;
 145
 146     pub mod tt {
 147         pub mod transcribe;
 148         pub mod macro_parser;
 149         pub mod macro_rules;
 150         pub mod quoted;
 151     }
 152 }
 153
 154 #[cfg(test)]
 155 mod test_snippet;
 156
 157 __build_diagnostic_array! { libsyntax, DIAGNOSTICS }