# proc-macro2-impersonated
> Adapted from [`proc-macro2`](https://github.com/alexcrichton/proc-macro2)
> Removed wrap proc-macro for correct span outside rust sources 
> Not use in proc-macro context if you don't know what you do

[![Build Status](https://api.travis-ci.com/botika/proc-macro2-impersonated.svg?branch=master)](https://travis-ci.com/botika/proc-macro2-impersonated)
[![Latest Version](https://img.shields.io/crates/v/proc-macro2-impersonated.svg)](https://crates.io/crates/proc-macro2-impersonated)
[![Rust Documentation](https://img.shields.io/badge/api-rustdoc-blue.svg)](https://docs.rs/proc-macro2-impersonated)

A wrapper around the procedural macro API of the compiler's `proc_macro` crate.
This library serves two purposes:

- **Bring proc-macro-like functionality to other contexts like build.rs and
  main.rs.** Types from `proc_macro` are entirely specific to procedural macros
  and cannot ever exist in code outside of a procedural macro. Meanwhile
  `proc_macro2` types may exist anywhere including non-macro code. By developing
  foundational libraries like [syn] and [quote] against `proc_macro2` rather
  than `proc_macro`, the procedural macro ecosystem becomes easily applicable to
  many other use cases and we avoid reimplementing non-macro equivalents of
  those libraries.

- **Make procedural macros unit testable.** As a consequence of being specific
  to procedural macros, nothing that uses `proc_macro` can be executed from a
  unit test. In order for helper libraries or components of a macro to be
  testable in isolation, they must be implemented using `proc_macro2`.

[syn]: https://github.com/botika/syn-impersonated
[quote]: https://github.com/botika/quote-impersonated

## Usage

```toml
[dependencies]
proc-macro2-impersonated = "1.0"
```
#### License

<sup>
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
</sup>

<br>

<sub>
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.
</sub>