xtruct 0.1.1

Anonymous structs made simple
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

# xtruct

[![Crates.io](https://img.shields.io/crates/v/xtruct.svg)](https://crates.io/crates/xtruct)
[![Documentation](https://docs.rs/xtruct/badge.svg)](https://docs.rs/xtruct)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

An anonymous struct literal macro for Rust. `xtruct` allows you to construct lightweight, ad-hoc struct types on the fly without declaring explicit `struct` types beforehand.

## Features

- **Zero boilerplate:** Create anonymous structs inline with simple key-value syntax.
- **Field shorthand:** Infer fields directly from local variables in scope (e.g., `xtruct! { name, count }`).
- **Type inference:** Automatically infers field types based on the passed expressions.

## Usage Examples

### Construction

```rust
use xtruct::xtruct;

let user = xtruct! {
    id: 1,
    is_admin: true,
    avatar_url: Some("https://example.com/avatar.png"),
};

assert_eq!(user.id, 1);
assert_eq!(user.is_admin, true);
assert_eq!(user.avatar_url, Some("https://example.com/avatar.png"));
```

### Variable Field Shorthand

Like standard Rust struct initialization, you can use local variables directly without repeating the field name:

```rust
use xtruct::xtruct;

let retry_count = 4usize;

let options = xtruct! {
    timeout_ms: 2000,
    retry_count,
};

assert_eq!(options.timeout_ms, 2000);
assert_eq!(options.retry_count, 4);
```

### Scoped Anonymous Structs

Construct anonymous structs inline within local scopes or expressions:

```rust
use xtruct::xtruct;

let payload = {
    let status_code = 200;
    let ok = true;
    xtruct! { status_code, ok }
};

assert_eq!(payload.status_code, 200);
assert_eq!(payload.ok, true);
```

### Combining Expressions and Local Variables

Mix complex expressions and local variable shorthands in a single struct initialization:

```rust
use xtruct::xtruct;

let user_id = 101;
let is_active = true;

let session = xtruct! {
    user_id,
    auth_token: format!("token_{}", user_id),
    is_active,
    ttl_seconds: 3600,
};

assert_eq!(session.user_id, 101);
assert_eq!(session.auth_token, "token_101");
```

### Nested Anonymous Structs

Instantiate nested anonymous structures by nesting `xtruct!` invocations:

```rust
use xtruct::xtruct;

let config = xtruct! {
    environment: "production",
    database: xtruct! {
        host: "localhost",
        port: 5432,
    },
};

assert_eq!(config.database.host, "localhost");
assert_eq!(config.database.port, 5432);
```

## Installation

Add `xtruct` to your `Cargo.toml`:

```toml
[dependencies]
xtruct = "0.1.0"
```

Or run:

```bash
cargo add xtruct
```

## License

This project is licensed under the [MIT License](LICENSE).