src/libsyntax_ext/lib.rs

   1 // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 //! Syntax extensions in the Rust compiler.
  12
  13 #![crate_name = "syntax_ext"]
  14 #![crate_type = "dylib"]
  15 #![crate_type = "rlib"]
  16 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
  17        html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
  18        html_root_url = "https://doc.rust-lang.org/nightly/")]
  19
  20 #![feature(rustc_private)]
  21 #![feature(str_char)]
  22
  23 extern crate fmt_macros;
  24 extern crate syntax;
  25
  26 use syntax::ext::base::{MacroExpanderFn, NormalTT};
  27 use syntax::ext::base::{SyntaxEnv, SyntaxExtension};
  28 use syntax::parse::token::intern;
  29
  30 // A variant of 'try!' that panics on Err(FatalError). This is used as a
  31 // crutch on the way towards a non-panic!-prone parser. It should be used
  32 // for fatal parsing errors; eventually we plan to convert all code using
  33 // panictry to just use normal try
  34 macro_rules! panictry {
  35     ($e:expr) => ({
  36         use std::result::Result::{Ok, Err};
  37         use syntax::diagnostic::FatalError;
  38         match $e {
  39             Ok(e) => e,
  40             Err(FatalError) => panic!(FatalError)
  41         }
  42     })
  43 }
  44
  45 mod asm;
  46 mod cfg;
  47 mod concat;
  48 mod concat_idents;
  49 mod deriving;
  50 mod env;
  51 mod format;
  52 mod log_syntax;
  53 mod trace_macros;
  54
  55 pub fn register_builtins(env: &mut SyntaxEnv) {
  56     // utility function to simplify creating NormalTT syntax extensions
  57     fn builtin_normal_expander(f: MacroExpanderFn) -> SyntaxExtension {
  58         NormalTT(Box::new(f), None, false)
  59     }
  60
  61     env.insert(intern("asm"),
  62                builtin_normal_expander(asm::expand_asm));
  63     env.insert(intern("cfg"),
  64                builtin_normal_expander(cfg::expand_cfg));
  65     env.insert(intern("concat"),
  66                builtin_normal_expander(concat::expand_syntax_ext));
  67     env.insert(intern("concat_idents"),
  68                builtin_normal_expander(concat_idents::expand_syntax_ext));
  69     env.insert(intern("env"),
  70                builtin_normal_expander(env::expand_env));
  71     env.insert(intern("option_env"),
  72                builtin_normal_expander(env::expand_option_env));
  73     env.insert(intern("format_args"),
  74                // format_args uses `unstable` things internally.
  75                NormalTT(Box::new(format::expand_format_args), None, true));
  76     env.insert(intern("log_syntax"),
  77                builtin_normal_expander(log_syntax::expand_syntax_ext));
  78     env.insert(intern("trace_macros"),
  79                builtin_normal_expander(trace_macros::expand_trace_macros));
  80
  81     deriving::register_all(env);
  82 }