Generation scripts¶

Several artifacts in the repository are generated from the mapping data in mapping-data.json. This page documents how to regenerate them.

Mapping data¶

The mapping-data.json file at the repository root contains all qualifier definitions, attribute name mappings, value mappings, and command metadata. It is maintained directly and is the sole source of truth for attribute mappings. See Namespace origin for the history of how this namespace was bootstrapped.

The mapping data is embedded into the binary at compile time via include_str!() in src/mapping_data.rs, so no runtime file I/O is needed.

Command methods¶

The MQSC command wrapper methods in src/commands.rs are generated from the command definitions in mapping-data.json. Each method is a thin wrapper that calls mqsc_command() with the correct verb and qualifier.

Mapping documentation¶

The per-qualifier mapping reference pages are maintained in the shared mq-rest-admin-common repository and included via --8<-- snippet directives. See qualifier mapping reference for the complete reference.

Regeneration workflow¶

When the mapping data changes:

Update mapping-data.json with the new mappings
Regenerate command methods in src/commands.rs
Run the full test suite to verify:

cargo test
cargo clippy -- -D warnings