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 // Do not remove on snapshot creation. Needed for bootstrap. (Issue #22364)
  18 #![cfg_attr(stage0, feature(custom_attribute))]
  19 #![crate_name = "syntax"]
  20 #![unstable(feature = "rustc_private", issue = "27812")]
  21 #![staged_api]
  22 #![crate_type = "dylib"]
  23 #![crate_type = "rlib"]
  24 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
  25        html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
  26        html_root_url = "https://doc.rust-lang.org/nightly/",
  27        issue_tracker_base_url = "https://github.com/rust-lang/rust/issues/")]
  28
  29 #![feature(associated_consts)]
  30 #![feature(drain)]
  31 #![feature(filling_drop)]
  32 #![feature(libc)]
  33 #![feature(ref_slice)]
  34 #![feature(rustc_private)]
  35 #![feature(set_stdio)]
  36 #![feature(staged_api)]
  37 #![feature(str_char)]
  38 #![feature(str_escape)]
  39 #![feature(unicode)]
  40 #![feature(vec_push_all)]
  41 #![feature(vec_resize)]
  42
  43 extern crate fmt_macros;
  44 extern crate serialize;
  45 extern crate term;
  46 extern crate libc;
  47 #[macro_use] extern crate log;
  48 #[macro_use] #[no_link] extern crate rustc_bitflags;
  49
  50 extern crate serialize as rustc_serialize; // used by deriving
  51
  52 // A variant of 'try!' that panics on Err(FatalError). This is used as a
  53 // crutch on the way towards a non-panic!-prone parser. It should be used
  54 // for fatal parsing errors; eventually we plan to convert all code using
  55 // panictry to just use normal try
  56 macro_rules! panictry {
  57     ($e:expr) => ({
  58         use std::result::Result::{Ok, Err};
  59         use diagnostic::FatalError;
  60         match $e {
  61             Ok(e) => e,
  62             Err(FatalError) => panic!(FatalError)
  63         }
  64     })
  65 }
  66
  67 pub mod util {
  68     pub mod interner;
  69     #[cfg(test)]
  70     pub mod parser_testing;
  71     pub mod small_vector;
  72 }
  73
  74 pub mod diagnostics {
  75     pub mod macros;
  76     pub mod plugin;
  77     pub mod registry;
  78     pub mod metadata;
  79 }
  80
  81 pub mod syntax {
  82     pub use ext;
  83     pub use parse;
  84     pub use ast;
  85 }
  86
  87 pub mod abi;
  88 pub mod ast;
  89 pub mod ast_util;
  90 pub mod attr;
  91 pub mod codemap;
  92 pub mod config;
  93 pub mod diagnostic;
  94 pub mod feature_gate;
  95 pub mod fold;
  96 pub mod owned_slice;
  97 pub mod parse;
  98 pub mod ptr;
  99 pub mod show_span;
 100 pub mod std_inject;
 101 pub mod str;
 102 pub mod test;
 103 pub mod visit;
 104
 105 pub mod print {
 106     pub mod pp;
 107     pub mod pprust;
 108 }
 109
 110 pub mod ext {
 111     pub mod asm;
 112     pub mod base;
 113     pub mod build;
 114     pub mod cfg;
 115     pub mod concat;
 116     pub mod concat_idents;
 117     pub mod deriving;
 118     pub mod env;
 119     pub mod expand;
 120     pub mod format;
 121     pub mod log_syntax;
 122     pub mod mtwt;
 123     pub mod quote;
 124     pub mod pushpop_safe;
 125     pub mod source_util;
 126     pub mod trace_macros;
 127
 128     pub mod tt {
 129         pub mod transcribe;
 130         pub mod macro_parser;
 131         pub mod macro_rules;
 132     }
 133 }