commit	a96a3fab00e9a4ec03059ce4e80ac3731f4f5a96	[log] [tgz]
author	David Tolnay <dtolnay@gmail.com>	Sat Sep 24 07:17:42 2016 -0700
committer	David Tolnay <dtolnay@gmail.com>	Sat Sep 24 07:17:42 2016 -0700
tree	31b2cb9ea1a223343ef1f5f57d69d0fe6a6ae45d
parent	ad2271a5b226a9373ac49dc2b3d8256d6488bec6 [diff]

tree: 31b2cb9ea1a223343ef1f5f57d69d0fe6a6ae45d

README.md

Nom parser for Rust items

Parse Rust structs and enums without a Syntex dependency, intended for use with Macros 1.1.

Designed for fast compile time.

Compile time for syn (from scratch including all dependencies): 4 seconds
Compile time for the syntex/quasi/aster stack: 60+ seconds

[dependencies]
syn = "0.6"

extern crate syn;

let source = "
    #[derive(Debug, Clone, Eq, PartialEq)]
    pub struct Item {
        pub ident: Ident,
        pub vis: Visibility,
        pub attrs: Vec<Attribute>,
        pub generics: Generics,
        pub body: Body,
    }
";

let ast = syn::parse_macro_input(source).unwrap();

Usage with Macros 1.1

[dependencies]
syn = "0.6"
quote = "0.1"

[lib]
rustc-macro = true

#![feature(rustc_macro, rustc_macro_lib)]

extern crate rustc_macro;
use rustc_macro::TokenStream;

extern crate syn;

#[macro_use]
extern crate quote;

#[rustc_macro_derive(MyMacro)]
pub fn my_macro(input: TokenStream) -> TokenStream {
    let source = input.to_string();

    // Parse a string of items to an AST
    let ast = syn::parse_macro_input(&source).unwrap();

    // Build the output, possibly using quasi-quotation
    let expanded = quote! {
        // ...
    };

    // Parse this back to a token stream and return it
    expanded.to_string().parse().unwrap()
}

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.