gritshield_macros 0.1.0

Procedural attribute routing macros for the GritShield secure web framework.
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

# Gritshield Route Macros


A set of convenient procedural macros for defining HTTP routes in **Gritshield**.

## Overview


This crate provides attribute macros (`#[get]`, `#[post]`, `#[put]`, etc.) that automatically register routes using the `gritshield::routing::trie` system.

## Installation


Add this to your `Cargo.toml`:

```toml
[dependencies]
gritshield = { path = "../gritshield" }
```

## Supported Macros


| Macro     | HTTP Method | Supports Role |
|-----------|-------------|---------------|
| `#[get]`  | GET         | Yes           |
| `#[post]` | POST        | Yes           |
| `#[put]`  | PUT         | Yes           |
| `#[patch]`| PATCH       | Yes           |
| `#[delete]` | DELETE    | Yes           |

## Syntax Options


```rust
// Simple path
#[get("/api/hello")]


// With role protection
#[get("/api/secure", role = "Operator")]

#[post("/api/data", role = "Admin")]

```

## How It Works


- Each macro generates a wrapper function that converts your handler into a `BoxFuture`.
- Automatically registers the route using `inventory::submit!`.
- Supports optional role-based authorization.

## Requirements


- Your handler must accept `gritshield::routing::trie::RequestContext`
- Your handler should return a type that implements `IntoResponse`

---