blob: b1843f7429418662eceadf47f2477582ca4ac0bb (
plain)
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
|
# CI Evaluation `ci/eval/`
> **Location**: `ci/eval/`
> **Platform**: Nix
> **Purpose**: Project configuration validation
> **Latest Version**: 0.0.5-1
---
## Overview
The CI evaluation module provides Nix-based validation of the project structure and configuration. It catches errors in build files before they reach CI.
---
## What It Validates
| Component | Checks |
|-----------|--------|
| **CMake** | Syntax, target definitions |
| **vcpkg** | Dependency declarations |
| **Nix** | Flake structure, expressions |
| **Build** | Cross-platform configuration |
---
## Quick Usage
### Validate Everything
```bash
nix-build ci -A eval.full
```
### Validate Specific Component
```bash
nix-build ci -A eval.cmake
nix-build ci -A eval.vcpkg
nix-build ci -A eval.nix
```
### Quick Test Mode
```bash
nix-build ci -A eval.validate --arg quickTest true
```
---
## Supported Systems
| System | Platform |
|--------|----------|
| `x86_64-linux` | Linux 64-bit |
| `x86_64-darwin` | macOS Intel |
| `aarch64-darwin` | macOS Apple Silicon |
| `x86_64-windows` | Windows (cross) |
### Limit to Specific System
```bash
nix-build ci -A eval.full --arg systems '["x86_64-linux"]'
```
---
## Configuration Validation
### CMake Files
- `CMakeLists.txt` — Main configuration
- `cmake/*.cmake` — CMake modules
- `CMakePresets.json` — Build presets
### Dependencies
- `vcpkg.json` — vcpkg dependencies
- `vcpkg-configuration.json` — vcpkg settings
### Nix Build
- `flake.nix` — Flake definition
- `default.nix` — Default expression
- `shell.nix` — Development shell
---
## CI Integration
Evaluation runs in `.github/workflows/eval.yml`:
```yaml
- name: Evaluate
run: |
nix-build --expr 'let
pkgs = import <nixpkgs> {};
eval = (import ./ci/eval { inherit (pkgs) lib runCommand cmake nix jq; }) {};
in eval.full'
```
---
## Local Replication
```bash
NIX_PATH=nixpkgs=channel:nixos-unstable \
nix-build --expr 'let
pkgs = import <nixpkgs> {};
eval = (import ./ci/eval { inherit (pkgs) lib runCommand cmake nix jq; }) {};
in eval.full'
cat result/summary.md
```
---
## Related Documentation
- [Workflows](./workflows.md) — CI overview
- [CI Support](./ci_support.md) — Support files
- [Nix Packaging](./nix.md) — Nix build system
|
