verdict-cli 0.1.3

CLI tool for validating CSV files against a JSON schema
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

# verdict-cli

CLI tool for validating CSV files against a JSON schema.

## Installation

Download a pre-built binary from the [GitHub releases page](https://github.com/kkruglik/verdict/releases), or build from source:

```bash
cargo install verdict-cli
```

## Usage

```bash
verdict-cli data.csv schema.json
```

Exit code `0` — all rules pass. Exit code `1` — at least one rule fails.

## Flags

| Flag | Default | Description |
|---|---|---|
| `--format` | `json` | Output format: `json` or `text` |
| `--max-failed-samples` | `100` | Max failed row samples per rule |

## Schema format

```json
{
  "columns": [
    { "name": "user_id", "dtype": "int", "constraints": [
      { "constraint": "not_null", "value": true },
      { "constraint": "unique",   "value": true }
    ]},
    { "name": "score", "dtype": "float", "constraints": [
      { "constraint": "between", "value": [0, 100] }
    ]},
    { "name": "country", "dtype": "str" }
  ]
}
```

Supported dtypes: `int`, `float`, `str`, `bool`.

Columns without `constraints` are still declared in the schema — they're loaded and type-checked but not validated against any rules.

## Output

**Text:**

```
Validation Report: FAILED (2/3 rules passed)
  FAIL: column 'age' — gt(18) — 5 values failed
    row 3: 15
    row 7: 12
```

**JSON:**

```json
{
  "passed": false,
  "total_rules": 3,
  "passed_count": 2,
  "failed_count": 1,
  "results": [...]
}
```

## CI usage

```bash
verdict-cli data.csv schema.json && echo "data quality OK"
```

## License

MIT