tauri-plugin-auditaur-macros 0.2.1

Procedural macros for tauri-plugin-auditaur.
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

# tauri-plugin-auditaur-macros

Procedural macros for `tauri-plugin-auditaur`.

This crate is an implementation detail of `tauri-plugin-auditaur`. Most users should depend on `tauri-plugin-auditaur` and use the re-exported macros:

```rust
#[tauri_plugin_auditaur::auditaur_command]
```

## `auditaur_command`

`auditaur_command` wraps `#[tauri::command]`, injects Auditaur's IPC carrier arguments, and adds the `tracing::instrument` fields needed to continue frontend Tauri invoke traces into backend command spans. It reads the Tauri invoke `traceparent` header first and falls back to the reserved `auditaurTraceContext` argument.

```rust
#[tauri_plugin_auditaur::auditaur_command(err)]
fn failing_command(reason: String) -> Result<(), String> {
    Err(reason)
}
```

## `instrument_ipc`

`instrument_ipc` is the lower-level compatibility macro for commands that keep an explicit `#[tauri::command]` and receive the legacy reserved invoke argument.

```rust
use tauri_plugin_auditaur::IpcTraceContext;

#[tauri::command]
#[tauri_plugin_auditaur::instrument_ipc(err)]
fn failing_command(
    reason: String,
    auditaur_trace_context: Option<IpcTraceContext>,
) -> Result<(), String> {
    Err(reason)
}
```

The command remains a normal explicit `#[tauri::command]`. The function must keep an optional parameter named `auditaur_trace_context`.