emit_macros 1.20.1

Internal proc macro crate for emit.
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

Templates are text literals that include regular text with _holes_. A hole is a point in the template where a property should be interpolated in.

# Examples

Creating a template with captured properties in the literal:

```ignore
let x = 42;
let y = true;

let template = emit::tpl!("got {x} and {y}");
```

Creating a template with captured properties after the literal:

```ignore
let x = 42;
let y = true;

let template = emit::tpl!("something of note", x, y);
```

# Syntax

```text
template_literal
```

where

- `template_literal`: `"` `(text | hole)*` `"`
- `text`: A fragment of plain text where `{` are escaped as `{{` and `}` are escaped as `}}`.
- `hole`: `{` `property` `}`
- `property`: A Rust field-value expression.

The following are all examples of templates:

```text
"some text"
 ├───────┘
 text
```

```text
"some text and {x}"
 ├────────────┘ │
 text           property
```

```text
"some {{text}} and {x: 42} and {y}"
 ├────────────────┘ ├───┘ └───┤ │
 text               property  │ property
                              text
```

See [the guide](https://emit-rs.io/reference/templates.html) for more details and examples of templates.

# Returns

An `emit::Template`.