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.
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.
11 //! The Rust parser and macro expander.
15 //! This API is completely unstable and subject to change.
17 #![crate_name = "syntax"]
18 #![crate_type = "dylib"]
19 #![crate_type = "rlib"]
20 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
21 html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
22 html_root_url = "https://doc.rust-lang.org/nightly/",
23 test(attr(deny(warnings))))]
27 #![feature(rustc_diagnostic_macros)]
28 #![feature(i128_type)]
30 #![cfg_attr(stage0, unstable(feature = "rustc_private", issue = "27812"))]
31 #![cfg_attr(stage0, feature(rustc_private))]
32 #![cfg_attr(stage0, feature(staged_api))]
34 extern crate serialize;
35 #[macro_use] extern crate log;
36 #[macro_use] extern crate bitflags;
37 extern crate std_unicode;
38 pub extern crate rustc_errors as errors;
39 extern crate syntax_pos;
40 extern crate rustc_data_structures;
42 extern crate serialize as rustc_serialize; // used by deriving
44 // A variant of 'try!' that panics on an Err. This is used as a crutch on the
45 // way towards a non-panic!-prone parser. It should be used for fatal parsing
46 // errors; eventually we plan to convert all code using panictry to just use
48 // Exported for syntax_ext, not meant for general use.
50 macro_rules! panictry {
52 use std::result::Result::{Ok, Err};
53 use errors::FatalError;
65 macro_rules! unwrap_or {
66 ($opt:expr, $default:expr) => {
82 // NB: This module needs to be declared first so diagnostics are
83 // registered before they are used.
84 pub mod diagnostic_list;
91 pub mod parser_testing;
96 pub use self::thin_vec::ThinVec;
99 pub use self::rc_slice::RcSlice;
117 pub mod feature_gate;
124 pub use syntax_pos::symbol;
135 pub use syntax_pos::hygiene;
140 pub mod placeholders;
146 pub mod macro_parser;
155 // __build_diagnostic_array! { libsyntax, DIAGNOSTICS }