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 #![crate_name = "syntax"]
  18 #![unstable(feature = "rustc_private", issue = "27812")]
  19 #![crate_type = "dylib"]
  20 #![crate_type = "rlib"]
  21 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
  22        html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
  23        html_root_url = "https://doc.rust-lang.org/nightly/",
  24        test(attr(deny(warnings))))]
  25 #![deny(warnings)]
  26
  27 #![feature(associated_consts)]
  28 #![feature(const_fn)]
  29 #![feature(optin_builtin_traits)]
  30 #![feature(rustc_private)]
  31 #![feature(staged_api)]
  32 #![feature(str_escape)]
  33 #![feature(unicode)]
  34 #![feature(rustc_diagnostic_macros)]
  35 #![feature(specialization)]
  36 #![feature(i128_type)]
  37
  38 extern crate serialize;
  39 #[macro_use] extern crate log;
  40 #[macro_use] #[no_link] extern crate rustc_bitflags;
  41 extern crate std_unicode;
  42 pub extern crate rustc_errors as errors;
  43 extern crate syntax_pos;
  44 extern crate rustc_data_structures;
  45
  46 extern crate serialize as rustc_serialize; // used by deriving
  47
  48 // A variant of 'try!' that panics on an Err. This is used as a crutch on the
  49 // way towards a non-panic!-prone parser. It should be used for fatal parsing
  50 // errors; eventually we plan to convert all code using panictry to just use
  51 // normal try.
  52 // Exported for syntax_ext, not meant for general use.
  53 #[macro_export]
  54 macro_rules! panictry {
  55     ($e:expr) => ({
  56         use std::result::Result::{Ok, Err};
  57         use errors::FatalError;
  58         match $e {
  59             Ok(e) => e,
  60             Err(mut e) => {
  61                 e.emit();
  62                 panic!(FatalError);
  63             }
  64         }
  65     })
  66 }
  67
  68 #[macro_export]
  69 macro_rules! unwrap_or {
  70     ($opt:expr, $default:expr) => {
  71         match $opt {
  72             Some(x) => x,
  73             None => $default,
  74         }
  75     }
  76 }
  77
  78 #[macro_use]
  79 pub mod diagnostics {
  80     #[macro_use]
  81     pub mod macros;
  82     pub mod plugin;
  83     pub mod metadata;
  84 }
  85
  86 // NB: This module needs to be declared first so diagnostics are
  87 // registered before they are used.
  88 pub mod diagnostic_list;
  89
  90 pub mod util {
  91     pub mod lev_distance;
  92     pub mod node_count;
  93     pub mod parser;
  94     #[cfg(test)]
  95     pub mod parser_testing;
  96     pub mod small_vector;
  97     pub mod move_map;
  98
  99     mod thin_vec;
 100     pub use self::thin_vec::ThinVec;
 101
 102     mod rc_slice;
 103     pub use self::rc_slice::RcSlice;
 104 }
 105
 106 pub mod json;
 107
 108 pub mod syntax {
 109     pub use ext;
 110     pub use parse;
 111     pub use ast;
 112 }
 113
 114 pub mod abi;
 115 pub mod ast;
 116 pub mod attr;
 117 pub mod codemap;
 118 #[macro_use]
 119 pub mod config;
 120 pub mod entry;
 121 pub mod feature_gate;
 122 pub mod fold;
 123 pub mod parse;
 124 pub mod ptr;
 125 pub mod show_span;
 126 pub mod std_inject;
 127 pub mod str;
 128 pub mod symbol;
 129 pub mod test;
 130 pub mod tokenstream;
 131 pub mod visit;
 132
 133 pub mod print {
 134     pub mod pp;
 135     pub mod pprust;
 136 }
 137
 138 pub mod ext {
 139     pub mod base;
 140     pub mod build;
 141     pub mod derive;
 142     pub mod expand;
 143     pub mod placeholders;
 144     pub mod hygiene;
 145     pub mod quote;
 146     pub mod source_util;
 147
 148     pub mod tt {
 149         pub mod transcribe;
 150         pub mod macro_parser;
 151         pub mod macro_rules;
 152         pub mod quoted;
 153     }
 154 }
 155
 156 #[cfg(test)]
 157 mod test_snippet;
 158
 159 // __build_diagnostic_array! { libsyntax, DIAGNOSTICS }