Description
Audit caller-declared mutually exclusive option groups against explicit present names, not shell or argv syntax.
An argv vector already consists of literal argument strings. Shell quoting and tokenization happen before this representation; joining argv elements with spaces does not reconstruct a safe command string. Option aliases, duplicates, arity and dependencies are application policies that these tools take explicitly.
Audit caller-declared mutually exclusive option groups against explicit present names, not shell or argv syntax.
When to use this tool
Use this tool to audit caller-declared mutually exclusive option groups against explicit present names, not shell or argv syntax.
How to use the tool and how it works
- Enter present, groupsJson using the input definitions below. Serialize the JSON text fields in the decoded shape shown below.
- Run the operation. Resolve malformed-input errors before interpreting the result.
- Read result.violations. Interpret signs, units, ordering and null values using the rules below.
Parse arrays of mutually exclusive names, requiring distinct strings within each group. Return group indexes and the group-order present names whenever more than one member occurs.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| present | Exact names recorded as present, without implicit defaults. | Dense list of at most 128 strings, each at most 8,192 UTF-16 code units. |
| groupsJson | JSON array of arrays of mutually exclusive exact option names; names must be distinct within each group. | Text, at most 8,192 UTF-16 code units; the stated grammar and narrower limits also apply. |
These decoded examples show the structure of the JSON text fields. Supply each as its corresponding serialized JSON string.
{
"groupsJson": [
[
"a",
"b"
],
[
"c",
"d"
]
]
}| Output field | Interpretation |
|---|---|
| result | Object containing the fields below. |
| result.violations | Source-indexed arity/group violations or missing dependency records, as specified above. |
{
"input": {
"present": [
"a",
"b"
],
"groupsJson": "[[\"a\",\"b\"],[\"c\",\"d\"]]"
},
"output": {
"result": {
"violations": [
{
"index": 0,
"names": [
"a",
"b"
]
}
]
}
}
}Limitations and assumptions
- Duplicate observations in present do not by themselves create multiple distinct group members; defaults and transitive conflicts are not inferred.
- Inputs are literal tokens or explicit records. The restricted long-name grammar is [A-Za-z0-9][A-Za-z0-9-]* where required. No universal option syntax, shell semantics or process execution is inferred.
- Every declared top-level input is required and unknown fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and within the absolute safe-integer magnitude; exact larger integers use decimal text. Source positions are zero-based UTF-16 offsets and span ends are exclusive unless a different convention is explicitly stated.
Alternative or Complementary methods
Use the application’s option schema to choose arity, aliases and conflict policy. Pass a literal argv vector to the intended process interface; shell command construction requires separate quoting rules.
References
Similar or alternative tools
- Long Option Assignment Joiner
Format one literal long-option argv token under a restricted ASCII option-name grammar; returns one argument, not shell quoting.
- Long Option Assignment Splitter
Split one strict ASCII --long-name[=value] argv token at the first equals; no shell parsing or implicit next-token consumption.