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"]
|
2015-01-07 17:48:16 -06:00
|
|
|
#![unstable]
|
Preliminary feature staging
This partially implements the feature staging described in the
[release channel RFC][rc]. It does not yet fully conform to the RFC as
written, but does accomplish its goals sufficiently for the 1.0 alpha
release.
It has three primary user-visible effects:
* On the nightly channel, use of unstable APIs generates a warning.
* On the beta channel, use of unstable APIs generates a warning.
* On the beta channel, use of feature gates generates a warning.
Code that does not trigger these warnings is considered 'stable',
modulo pre-1.0 bugs.
Disabling the warnings for unstable APIs continues to be done in the
existing (i.e. old) style, via `#[allow(...)]`, not that specified in
the RFC. I deem this marginally acceptable since any code that must do
this is not using the stable dialect of Rust.
Use of feature gates is itself gated with the new 'unstable_features'
lint, on nightly set to 'allow', and on beta 'warn'.
The attribute scheme used here corresponds to an older version of the
RFC, with the `#[staged_api]` crate attribute toggling the staging
behavior of the stability attributes, but the user impact is only
in-tree so I'm not concerned about having to make design changes later
(and I may ultimately prefer the scheme here after all, with the
`#[staged_api]` crate attribute).
Since the Rust codebase itself makes use of unstable features the
compiler and build system to a midly elaborate dance to allow it to
bootstrap while disobeying these lints (which would otherwise be
errors because Rust builds with `-D warnings`).
This patch includes one significant hack that causes a
regression. Because the `format_args!` macro emits calls to unstable
APIs it would trigger the lint. I added a hack to the lint to make it
not trigger, but this in turn causes arguments to `println!` not to be
checked for feature gates. I don't presently understand macro
expansion well enough to fix. This is bug #20661.
Closes #16678
[rc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
2015-01-06 08:26:08 -06:00
|
|
|
#![staged_api]
|
2014-03-21 20:05:05 -05: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 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)]
|
2015-01-06 11:24:46 -06:00
|
|
|
#![feature(slicing_syntax)]
|
2015-01-07 08:15:34 -06:00
|
|
|
#![feature(box_syntax)]
|
2014-12-03 17:58:26 -06:00
|
|
|
#![feature(quote, unsafe_destructor)]
|
2015-01-08 04:45:49 -06:00
|
|
|
#![allow(unknown_features)] #![feature(int_uint)]
|
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
|
|
|
extern crate serialize;
|
|
|
|
extern crate term;
|
2014-09-28 11:25:48 -05:00
|
|
|
extern crate libc;
|
2015-01-06 11:24:46 -06:00
|
|
|
#[macro_use] extern crate log;
|
2014-12-31 22:43:46 -06:00
|
|
|
|
2014-12-19 00:52:48 -06:00
|
|
|
extern crate "serialize" as rustc_serialize; // used by deriving
|
|
|
|
|
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 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 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
|
|
|
}
|