copybook-cli 0.4.3

CLI for parsing, decoding, encoding, and verifying COBOL copybook data.
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

<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
# copybook-cli

CLI for working with COBOL copybooks and mainframe record data.

`copybook` supports parsing, inspection, decode/encode, verification, and support-matrix checks.

## What it does

- Parse copybooks into machine-readable layout JSON.
- Decode fixed-length and RDW binaries to JSONL with codepage and type controls.
- Encode JSONL back to COBOL binary layout.
- Verify input data and enforce policy/quality checks.
- Inspect feature support and validate compatibility flags.

## Commands

| Command | Purpose |
|---|---|
| `parse` | Parse copybook to JSON schema |
| `inspect` | Show formatted copybook layout |
| `decode` | Convert copybook-encoded binary to JSONL |
| `encode` | Convert JSONL to copybook binary |
| `verify` | Validate data against schema only |
| `support` | Show or check supported features |
| `determinism` | Verify decode/encode/round-trip determinism |

## Quick start

```bash
copybook parse fixtures/copybooks/simple.cpy --output schema.json
copybook decode fixtures/copybooks/simple.cpy fixtures/data/simple.bin \
  --output demo.jsonl --format fixed --codepage cp037
copybook encode fixtures/copybooks/simple.cpy demo.jsonl \
  --output demo.bin --format fixed --codepage cp037
copybook verify fixtures/copybooks/simple.cpy demo.bin \
  --format fixed --codepage cp037
```

### Feature checks

```bash
copybook support
copybook support --json
copybook support --check level-88
```

### Field projection

```bash
# Decode only selected fields
copybook decode schema.cpy data.bin --output selected.jsonl \
  --format fixed --codepage cp037 --select "CUSTOMER-ID,BALANCE"
```

### Dialect lever

```bash
# IBM Enterprise COBOL (zero-tolerant ODO)
copybook decode schema.cpy data.bin --output data.jsonl \
  --format fixed --codepage cp037 --dialect 0

# Micro Focus COBOL (one-tolerant ODO)
copybook parse schema.cpy --dialect 1
```

### Determinism validation

```bash
# Verify round-trip determinism
copybook determinism round-trip --format fixed --codepage cp037 schema.cpy data.bin

# JSON output for CI integration
copybook determinism decode --output json --format fixed --codepage cp037 schema.cpy data.bin
```

## Installation

```bash
cargo install --path . -p copybook-cli
# Or build locally:
cargo build -p copybook-cli --release
```

## License

Licensed under **AGPL-3.0-or-later**. See [LICENSE](../LICENSE).