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"]
|
2015-01-07 15:48:16 -08: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 06:26:08 -08:00
|
|
|
#![staged_api]
|
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)]
|
2015-01-06 09:24:46 -08:00
|
|
|
#![feature(slicing_syntax)]
|
2015-01-07 15:15:34 +01:00
|
|
|
#![feature(box_syntax)]
|
2014-12-04 01:58:26 +02:00
|
|
|
#![feature(quote, unsafe_destructor)]
|
2015-01-08 21:45:49 +11:00
|
|
|
#![allow(unknown_features)] #![feature(int_uint)]
|
2015-01-16 22:33:24 -08:00
|
|
|
#![allow(unstable)]
|
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
|
|
|
extern crate serialize;
|
|
|
|
extern crate term;
|
2014-09-28 09:25:48 -07:00
|
|
|
extern crate libc;
|
2015-01-06 09:24:46 -08:00
|
|
|
#[macro_use] extern crate log;
|
2015-01-16 12:20:03 -08:00
|
|
|
#[macro_use] #[no_link] extern crate rustc_bitflags;
|
2014-12-31 20:43:46 -08:00
|
|
|
|
2014-12-18 22:52:48 -08:00
|
|
|
extern crate "serialize" as rustc_serialize; // used by deriving
|
|
|
|
|
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 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 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
|
|
|
}
|