rsconstruct 0.9.81

Rust based fast build system
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

# Iyamlschema Processor

## Purpose

Validates YAML files against JSON schemas referenced by a `$schema` URL field in each file. Checks both schema conformance and property ordering. Native (in-process, no external tools required).

## How It Works

For each YAML file:
1. Parses the YAML content
2. Reads the `$schema` field to get the schema URL
3. Fetches the schema (cached in `.rsconstruct/webcache.redb`)
4. Validates the data against the schema (including resolving remote `$ref` references)
5. Checks that object keys appear in the order specified by `propertyOrdering` fields in the schema

Fails if any file is missing `$schema`, fails schema validation, or has keys in the wrong order.

## Configuration

```toml
[processor.iyamlschema]
src_dirs = ["yaml"]
check_ordering = true    # Check propertyOrdering (default: true)
```

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| `check_ordering` | boolean | `true` | Whether to check property ordering against `propertyOrdering` in the schema |
| `dep_inputs` | string[] | `[]` | Extra files whose changes trigger rebuilds |

## Schema Requirements

Each YAML file must contain a `$schema` field with a URL pointing to a JSON schema:

```yaml
$schema: "https://example.com/schemas/mydata.json"
name: Alice
age: 30
```

The schema is fetched via HTTP and cached locally. Subsequent builds use the cached version. Use `rsconstruct webcache clear` to force re-fetching.

## Property Ordering

If the schema contains `propertyOrdering` arrays, the processor checks that data keys appear in the specified order:

```json
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" }
  },
  "propertyOrdering": ["name", "age"]
}
```

Set `check_ordering = false` to disable this check.

## Batch Support

Files are validated individually within a batch. Partial failure is handled correctly.

## Clean behavior

This processor is a Checker — `rsconstruct clean outputs` is a no-op for it (checkers produce no outputs). See [Clean behavior](../processors.md#clean-behavior) and [`rsconstruct clean`](../commands.md#rsconstruct-clean).