ident-str 0.1.0

A macro to convert string literals into identifiers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<!-- Readme generated with `cargo-readme`: https://github.com/webern/cargo-readme -->

# ident-str

[![Crates.io](https://img.shields.io/crates/v/ident-str.svg)](https://crates.io/crates/ident-str)
[![Documentation](https://docs.rs/ident-str/badge.svg)](https://docs.rs/ident-str/)
[![Dependency status](https://deps.rs/repo/github/funnyboy-roks/ident-str/status.svg)](https://deps.rs/repo/github/funnyboy-roks/ident-str)

A macro to convert string literals into identifiers.  The primary use-case is to allow
declarative macros to produce identifiers that are unique to each call.  The alternative is to
accept each identifier as an argument to the macro call, which gets unweildy with many
identifiers.

## Usage

```rust
macro_rules! my_macro {
    ($name: ident) => {
        ident_str::ident_str! {
            #name_a = concat!(stringify!($name), "_a"),
            #name_b = concat!(stringify!($name), "_b")
            => {
                fn #name_a() {}
                fn #name_b() {}
            }
        }
    };
}

my_macro!(foo);
```

expands to

```rust
fn foo_a() {}
fn foo_b() {}
```

## Supported Macros

This crate takes advantage of [`MacroString`](https://github.com/dtolnay/macro-string/) and
supports all macros supported by it.  Those macros are:
- `concat!`
- `stringify!`
- `env!`
- `include!`
- `include_str!`

## Ignore Variable

When any unknown variables are encountered, `ident_str!` will error, if that behaviour is not
desired, you can add `#<var> = None` to the declarations:

```rust
ident_str::ident_str! {
    #ignore = None
    => #ignore
}
```

This exapands into

```rust
#ignore
```