2013-02-28 07:15:32 -06:00
|
|
|
// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
|
2012-12-03 18:48:01 -06:00
|
|
|
// file at the top-level directory of this distribution and at
|
|
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
|
|
|
|
2014-06-09 15:12:30 -05:00
|
|
|
//! The Rust parser and macro expander.
|
|
|
|
//!
|
|
|
|
//! # Note
|
|
|
|
//!
|
|
|
|
//! This API is completely unstable and subject to change.
|
2013-03-29 14:51:10 -05:00
|
|
|
|
2014-07-01 09:12:04 -05:00
|
|
|
#![crate_name = "syntax"]
|
2014-06-18 00:13:36 -05:00
|
|
|
#![experimental]
|
2014-03-21 20:05:05 -05:00
|
|
|
#![license = "MIT/ASL2"]
|
|
|
|
#![crate_type = "dylib"]
|
|
|
|
#![crate_type = "rlib"]
|
|
|
|
#![doc(html_logo_url = "http://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
|
|
|
|
html_favicon_url = "http://www.rust-lang.org/favicon.ico",
|
2014-10-09 12:47:22 -05:00
|
|
|
html_root_url = "http://doc.rust-lang.org/nightly/")]
|
2014-03-21 20:05:05 -05:00
|
|
|
|
2014-09-26 00:48:16 -05:00
|
|
|
#![allow(unknown_features)]
|
|
|
|
#![feature(macro_rules, globs, default_type_params, phase, slicing_syntax)]
|
2014-08-12 22:31:30 -05:00
|
|
|
#![feature(quote, struct_variant, unsafe_destructor, import_shadowing)]
|
2014-01-09 07:05:33 -06:00
|
|
|
|
2014-05-17 18:38:13 -05:00
|
|
|
extern crate arena;
|
2014-05-06 11:52:53 -05:00
|
|
|
extern crate fmt_macros;
|
2014-07-01 11:39:41 -05:00
|
|
|
#[phase(plugin, link)] extern crate log;
|
|
|
|
extern crate serialize;
|
|
|
|
extern crate term;
|
2014-09-28 11:25:48 -05:00
|
|
|
extern crate libc;
|
2012-12-23 16:41:37 -06:00
|
|
|
|
2013-04-03 11:41:40 -05:00
|
|
|
pub mod util {
|
|
|
|
pub mod interner;
|
2013-05-16 19:41:47 -05:00
|
|
|
#[cfg(test)]
|
|
|
|
pub mod parser_testing;
|
2013-11-24 23:18:21 -06:00
|
|
|
pub mod small_vector;
|
2013-04-03 11:41:40 -05:00
|
|
|
}
|
|
|
|
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod diagnostics {
|
|
|
|
pub mod macros;
|
|
|
|
pub mod plugin;
|
|
|
|
pub mod registry;
|
|
|
|
}
|
|
|
|
|
2012-12-13 15:05:22 -06:00
|
|
|
pub mod syntax {
|
|
|
|
pub use ext;
|
|
|
|
pub use parse;
|
2014-05-28 22:19:05 -05:00
|
|
|
pub use ast;
|
2012-12-13 15:05:22 -06:00
|
|
|
}
|
|
|
|
|
2013-03-13 21:25:28 -05:00
|
|
|
pub mod abi;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod ast;
|
|
|
|
pub mod ast_map;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod ast_util;
|
|
|
|
pub mod attr;
|
|
|
|
pub mod codemap;
|
2014-07-24 21:44:24 -05:00
|
|
|
pub mod config;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod diagnostic;
|
2014-09-10 19:55:42 -05:00
|
|
|
pub mod feature_gate;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod fold;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod owned_slice;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod parse;
|
2014-05-17 16:46:40 -05:00
|
|
|
pub mod ptr;
|
2014-07-24 21:44:24 -05:00
|
|
|
pub mod show_span;
|
2014-09-10 17:35:21 -05:00
|
|
|
pub mod std_inject;
|
2014-07-24 21:44:24 -05:00
|
|
|
pub mod test;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod visit;
|
2013-01-29 16:41:40 -06:00
|
|
|
|
|
|
|
pub mod print {
|
|
|
|
pub mod pp;
|
|
|
|
pub mod pprust;
|
2012-03-29 15:48:05 -05:00
|
|
|
}
|
|
|
|
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod ext {
|
2013-03-11 00:08:38 -05:00
|
|
|
pub mod asm;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod base;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod build;
|
|
|
|
pub mod bytes;
|
|
|
|
pub mod cfg;
|
Add a cfg_attr syntax extension
This extends cfg-gating to attributes.
```rust
#[cfg_attr(<cfg pattern>, <attr>)]
```
will expand to
```rust
#[<attr>]
```
if the `<cfg pattern>` matches the current cfg environment, and nothing
if it does not. The grammar for the cfg pattern has a simple
recursive structure:
* `value` and `key = "value"` are cfg patterns,
* `not(<cfg pattern>)` is a cfg pattern and matches if `<cfg pattern>`
does not.
* `all(<cfg pattern>, ...)` is a cfg pattern and matches if all of the
`<cfg pattern>`s do.
* `any(<cfg pattern>, ...)` is a cfg pattern and matches if any of the
`<cfg pattern>`s do.
Examples:
```rust
// only derive Show for assert_eq! in tests
#[cfg_attr(test, deriving(Show))]
struct Foo { ... }
// only derive Show for assert_eq! in tests and debug builds
#[cfg_attr(any(test, not(ndebug)), deriving(Show))]
struct Foo { ... }
// ignore a test in certain cases
#[test]
#[cfg_attr(all(not(target_os = "linux"), target_endian = "big"), ignore)]
fn test_broken_thing() { ... }
// Avoid duplication when fixing staging issues in rustc
#[cfg_attr(not(stage0), lang="iter")]
pub trait Iterator<T> { ... }
```
2014-08-03 16:25:30 -05:00
|
|
|
pub mod cfg_attr;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod concat;
|
|
|
|
pub mod concat_idents;
|
|
|
|
pub mod deriving;
|
|
|
|
pub mod env;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod expand;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod fmt;
|
|
|
|
pub mod format;
|
|
|
|
pub mod log_syntax;
|
|
|
|
pub mod mtwt;
|
2013-01-29 16:41:40 -06:00
|
|
|
pub mod quote;
|
2014-07-01 11:39:41 -05:00
|
|
|
pub mod source_util;
|
|
|
|
pub mod trace_macros;
|
2013-01-29 16:41:40 -06:00
|
|
|
|
|
|
|
pub mod tt {
|
|
|
|
pub mod transcribe;
|
|
|
|
pub mod macro_parser;
|
|
|
|
pub mod macro_rules;
|
2012-06-27 17:29:35 -05:00
|
|
|
}
|
2012-03-29 15:48:05 -05:00
|
|
|
}
|