workspace_tools 0.16.1

Reliable workspace-relative path resolution for Rust projects. Automatically finds your workspace root and provides consistent file path handling regardless of execution context. Features memory-safe secret management, configuration loading with validation, and resource discovery.
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

# Feature: Configuration Validation

### Scope

- **Purpose**: Validate configuration files against a JSON Schema derived from the target type before returning the deserialized value, catching structural errors before they cause runtime failures.
- **Responsibility**: Load a config file, derive a JSON Schema from the target type, validate the raw content against that schema, and return detailed per-field errors on failure.
- **In Scope**: Schema-validated configuration loading (requires `validation` feature, which also activates `serde`).
- **Out of Scope**: Runtime value validation (business logic), schema authoring tools, non-JSON-Schema validation formats, validation of non-config data.

### Design

Validation is integrated into the load step, not a separate pass. The operation loads the file, deserializes to an intermediate representation, then validates against the generated schema before converting into the target structure. All schema violations are collected and returned as a single error with per-field detail, not just the first error.

Schema generation derives from the target type definition at runtime via an annotation, requiring no separate schema file on disk.

The `validation` feature depends on `serde` — enabling validation automatically enables configuration loading, ensuring callers do not need to manage feature dependency manually.

### Sources

| File | Relationship |
|------|-------------|
| [src/lib.rs](../../src/lib.rs) | Schema-validated config loading impl |
| [Cargo.toml](../../Cargo.toml) | `validation` feature flag (implies `serde`) and optional dependency declarations |

### Tests

| File | Relationship |
|------|-------------|
| [tests/config_validation_tests.rs](../../tests/config_validation_tests.rs) | Schema-based configuration validation |
| [tests/validation_boundary_tests.rs](../../tests/validation_boundary_tests.rs) | Input validation and boundary condition handling |

### Tasks

| File | Relationship |
|------|-------------|
| [task/completed/003_config_validation.md](../../task/completed/003_config_validation.md) | Initial schema validation implementation |

### APIs

| File | Relationship |
|------|-------------|
| [api/001_workspace.md](../api/001_workspace.md) | `load_config_with_validation()` method signature |

### Features

| File | Relationship |
|------|-------------|
| [feature/002_configuration_loading.md](../feature/002_configuration_loading.md) | Underlying config loading (serde feature) |