e520bb1b2f
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> { ... }
```
106 lines
2.3 KiB
Rust
106 lines
2.3 KiB
Rust
// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
|
|
// 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.
|
|
|
|
//! The Rust parser and macro expander.
|
|
//!
|
|
//! # Note
|
|
//!
|
|
//! This API is completely unstable and subject to change.
|
|
|
|
#![crate_name = "syntax"]
|
|
#![experimental]
|
|
#![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",
|
|
html_root_url = "http://doc.rust-lang.org/master/")]
|
|
|
|
#![feature(macro_rules, globs, default_type_params, phase)]
|
|
#![feature(quote, struct_variant, unsafe_destructor, import_shadowing)]
|
|
#![allow(deprecated)]
|
|
|
|
extern crate arena;
|
|
extern crate fmt_macros;
|
|
extern crate debug;
|
|
#[phase(plugin, link)] extern crate log;
|
|
extern crate serialize;
|
|
extern crate term;
|
|
|
|
pub mod util {
|
|
pub mod interner;
|
|
#[cfg(test)]
|
|
pub mod parser_testing;
|
|
pub mod small_vector;
|
|
}
|
|
|
|
pub mod diagnostics {
|
|
pub mod macros;
|
|
pub mod plugin;
|
|
pub mod registry;
|
|
}
|
|
|
|
pub mod syntax {
|
|
pub use ext;
|
|
pub use parse;
|
|
pub use ast;
|
|
}
|
|
|
|
pub mod abi;
|
|
pub mod ast;
|
|
pub mod ast_map;
|
|
pub mod ast_util;
|
|
pub mod attr;
|
|
pub mod codemap;
|
|
pub mod config;
|
|
pub mod crateid;
|
|
pub mod diagnostic;
|
|
pub mod feature_gate;
|
|
pub mod fold;
|
|
pub mod owned_slice;
|
|
pub mod parse;
|
|
pub mod ptr;
|
|
pub mod show_span;
|
|
pub mod std_inject;
|
|
pub mod test;
|
|
pub mod visit;
|
|
|
|
pub mod print {
|
|
pub mod pp;
|
|
pub mod pprust;
|
|
}
|
|
|
|
pub mod ext {
|
|
pub mod asm;
|
|
pub mod base;
|
|
pub mod build;
|
|
pub mod bytes;
|
|
pub mod cfg;
|
|
pub mod cfg_attr;
|
|
pub mod concat;
|
|
pub mod concat_idents;
|
|
pub mod deriving;
|
|
pub mod env;
|
|
pub mod expand;
|
|
pub mod fmt;
|
|
pub mod format;
|
|
pub mod log_syntax;
|
|
pub mod mtwt;
|
|
pub mod quote;
|
|
pub mod source_util;
|
|
pub mod trace_macros;
|
|
|
|
pub mod tt {
|
|
pub mod transcribe;
|
|
pub mod macro_parser;
|
|
pub mod macro_rules;
|
|
}
|
|
}
|