token-parser-derive 0.5.0

Derive macros to make structs parsable into tokens
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

# Token Parser Derive

Derive macros for the [`token-parser`](https://gitlab.com/porky11/token-parser) crate. Automatically implements the `Parsable` trait for structs.

## Features

- **`Parsable`** on tuple structs: parses unnamed fields sequentially using `Parsable::parse_next`.
- **`Parsable`** on named structs: parses one sub-list per field in any order (`((name1 value1) (name2 value2) …)`); requires `Default`, missing fields keep their default, unknown field names yield `UnknownField`.
- **`Parsable`** on unit structs: parses the empty list `()`.
- **`SymbolParsable`**: parses unnamed fields (single-field recommended) using `FromStr` from a symbol string.

Errors are annotated with the affected field and type.

## Usage

```rust
use token_parser::{Parsable, SymbolParsable};

// Sequential parsing from parser
#[derive(Parsable)]
struct Point(f32, f32);

// Field lists in any order
#[derive(Parsable, Default)]
struct Config {
    size: f32,
    label: String,
}

// Symbol parsing (e.g., numbers/strings)
#[derive(SymbolParsable)]
struct Token(String);
```