en16931 0.1.0

The EN 16931 semantic data model and its business rules, as Rust types. Validates the model rather than a serialised document, so findings point at BT-151 on line 3 instead of at an XPath. No XML, no PDF, no I/O.
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
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

# en16931 — development task runner
# Install just: https://just.systems/man/en/

# ── Default ───────────────────────────────────────────────────────────────────
# Show all available recipes.
default:
    @just --list --unsorted

# ── Setup ─────────────────────────────────────────────────────────────────────

# Fetch the CEN / KoSIT / Peppol artefacts into ./spec/.
#
# Not committed: the CEN artefacts are EUPL-1.2, a reciprocal licence, and
# keeping them out of the repository is what keeps this crate MIT OR Apache-2.0.
spec:
    cargo xtask fetch

# ── Code quality ──────────────────────────────────────────────────────────────

# Check formatting without making changes.
fmt-check:
    cargo fmt --all --check

# Format all source files.
fmt:
    cargo fmt --all

# Run Clippy on all targets and features (warnings are errors).
lint:
    cargo clippy --all-targets --all-features -- -D warnings

# Quick type-check — the fastest feedback loop.
check:
    cargo check --all-targets --all-features

# ── Testing ───────────────────────────────────────────────────────────────────

# Unit + doc tests with default features.
test *ARGS:
    cargo test {{ ARGS }}

# Every feature enabled. The suites that need ./spec/ skip loudly without it.
test-all:
    cargo test --all-targets --all-features

# No default features.
test-no-features:
    cargo test --all-targets --no-default-features

# Run the examples.
examples:
    cargo run --example validate_an_invoice
    cargo run --example profiles_and_proofs
    cargo run --example report_formats --features serde,svrl

# Benchmarks (criterion).
bench:
    cargo bench --all-features

# The crate must keep building for wasm32 — no I/O, no XML, no PDF.
wasm:
    rustup target add wasm32-unknown-unknown
    cargo build --target wasm32-unknown-unknown --no-default-features --features svrl,serde

# ── Generated code ────────────────────────────────────────────────────────────

# Regenerate everything derived from the artefacts.
codegen:
    cargo xtask codegen

# Fail if any generated file no longer matches the artefacts. Runs in CI, so a
# table cannot drift away from the specification it claims to come from.
codegen-check:
    cargo xtask check

# ── Documentation ─────────────────────────────────────────────────────────────

# Build the docs, warnings as errors.
doc:
    RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --all-features

# Build them exactly as docs.rs will — needs nightly, because the feature
# badges (`#[doc(cfg(...))]`) are still unstable.
doc-docsrs:
    RUSTDOCFLAGS="--cfg docsrs -D warnings" cargo +nightly doc --no-deps --all-features

# Build and open.
doc-open:
    cargo doc --no-deps --all-features --open

# ── Dependencies ──────────────────────────────────────────────────────────────

# Security advisories.
audit:
    cargo audit

# Licence and dependency policy.
deny:
    cargo deny --all-features check

# ── Everything CI runs, locally ───────────────────────────────────────────────
ci: fmt-check lint doc test-all test-no-features codegen-check
    @echo "✓ all green"