2013-02-28 13:15:32 +00:00
|
|
|
// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
|
2012-12-03 16:48:01 -08: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 13:12:30 -07:00
|
|
|
//! The Rust parser and macro expander.
|
|
|
|
//!
|
|
|
|
//! # Note
|
|
|
|
//!
|
|
|
|
//! This API is completely unstable and subject to change.
|
2013-03-29 12:51:10 -07:00
|
|
|
|
2014-07-01 07:12:04 -07:00
|
|
|
#![crate_name = "syntax"]
|
2014-06-17 22:13:36 -07:00
|
|
|
#![experimental]
|
2014-03-21 18:05:05 -07:00
|
|
|
#![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 10:47:22 -07:00
|
|
|
html_root_url = "http://doc.rust-lang.org/nightly/")]
|
2014-03-21 18:05:05 -07:00
|
|
|
|
2014-09-26 17:48:16 +12:00
|
|
|
#![allow(unknown_features)]
|
2014-12-09 14:08:10 -08:00
|
|
|
#![feature(macro_rules, globs, default_type_params, phase, slicing_syntax)]
|
2014-11-20 00:21:32 +01:00
|
|
|
#![feature(quote, unsafe_destructor, import_shadowing)]
|
2014-01-09 15:05:33 +02:00
|
|
|
|
2014-05-18 02:38:13 +03:00
|
|
|
extern crate arena;
|
2014-05-06 09:52:53 -07:00
|
|
|
extern crate fmt_macros;
|
2014-07-01 18:39:41 +02:00
|
|
|
#[phase(plugin, link)] extern crate log;
|
|
|
|
extern crate serialize;
|
|
|
|
extern crate term;
|
2014-09-28 09:25:48 -07:00
|
|
|
extern crate libc;
|
2012-12-23 17:41:37 -05:00
|
|
|
|
2013-04-03 09:41:40 -07:00
|
|
|
pub mod util {
|
|
|
|
pub mod interner;
|
2013-05-16 17:41:47 -07:00
|
|
|
#[cfg(test)]
|
|
|
|
pub mod parser_testing;
|
2013-11-24 21:18:21 -08:00
|
|
|
pub mod small_vector;
|
2013-04-03 09:41:40 -07:00
|
|
|
}
|
|
|
|
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod diagnostics {
|
|
|
|
pub mod macros;
|
|
|
|
pub mod plugin;
|
|
|
|
pub mod registry;
|
|
|
|
}
|
|
|
|
|
2012-12-13 13:05:22 -08:00
|
|
|
pub mod syntax {
|
|
|
|
pub use ext;
|
|
|
|
pub use parse;
|
2014-05-29 12:19:05 +09:00
|
|
|
pub use ast;
|
2012-12-13 13:05:22 -08:00
|
|
|
}
|
|
|
|
|
2013-03-13 22:25:28 -04:00
|
|
|
pub mod abi;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod ast;
|
|
|
|
pub mod ast_map;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod ast_util;
|
|
|
|
pub mod attr;
|
|
|
|
pub mod codemap;
|
2014-07-25 14:44:24 +12:00
|
|
|
pub mod config;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod diagnostic;
|
2014-09-11 12:55:42 +12:00
|
|
|
pub mod feature_gate;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod fold;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod owned_slice;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod parse;
|
2014-05-18 00:46:40 +03:00
|
|
|
pub mod ptr;
|
2014-07-25 14:44:24 +12:00
|
|
|
pub mod show_span;
|
2014-09-11 10:35:21 +12:00
|
|
|
pub mod std_inject;
|
2014-07-25 14:44:24 +12:00
|
|
|
pub mod test;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod visit;
|
2013-01-29 14:41:40 -08:00
|
|
|
|
|
|
|
pub mod print {
|
|
|
|
pub mod pp;
|
|
|
|
pub mod pprust;
|
2012-03-29 13:48:05 -07:00
|
|
|
}
|
|
|
|
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod ext {
|
2013-03-10 22:08:38 -07:00
|
|
|
pub mod asm;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod base;
|
2014-07-01 18:39:41 +02: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 14:25:30 -07:00
|
|
|
pub mod cfg_attr;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod concat;
|
|
|
|
pub mod concat_idents;
|
|
|
|
pub mod deriving;
|
|
|
|
pub mod env;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod expand;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod fmt;
|
|
|
|
pub mod format;
|
|
|
|
pub mod log_syntax;
|
|
|
|
pub mod mtwt;
|
2013-01-29 14:41:40 -08:00
|
|
|
pub mod quote;
|
2014-07-01 18:39:41 +02:00
|
|
|
pub mod source_util;
|
|
|
|
pub mod trace_macros;
|
2013-01-29 14:41:40 -08:00
|
|
|
|
|
|
|
pub mod tt {
|
|
|
|
pub mod transcribe;
|
|
|
|
pub mod macro_parser;
|
|
|
|
pub mod macro_rules;
|
2012-06-27 15:29:35 -07:00
|
|
|
}
|
2012-03-29 13:48:05 -07:00
|
|
|
}
|