Commit e9df032c authored by Vladimir Malenovsky's avatar Vladimir Malenovsky
Browse files

improve --filter help: separate token types, modifiers, and add wildcard examples

parent 950b130f
Loading
Loading
Loading
Loading
+20 −14
Original line number Diff line number Diff line
@@ -1874,24 +1874,30 @@ if __name__ == "__main__":
        default=None,
        metavar="TOKEN",
        help=(
            "Select which tests to run. Default baseline: ENC+DEC tests.\n"
            "Select which tests to run. Default baseline: ENC+DEC tests (REND/ISAR optional).\n"
            "\n"
            "TOKEN TYPES:\n"
            "  LEVEL1, LEVEL2, LEVEL3      — Test level (default: LEVEL3). LEVEL1: ≤80 kbps; LEVEL2: ≤192 kbps; LEVEL3: unlimited.\n"
            "  ENC, DEC, REND, ISAR*       — Test groups (∗=optional). Prefix +/- to add/remove.\n"
            "  MONO, STEREO, EXT, HOA*, SBA, MC    — Output format (ENC/DEC only). Aliases: HOA→HOA2+HOA3, SBA→FOA+HOA2+HOA3, MC→{5_1,7_1,…}.\n"
            "  (other)                     — Substring (case-insensitive, matched against command). Multiple terms use AND logic. Prefix +/- to add/remove.\n"
            "  *, +*, -*                   — Wildcard tags/formats (e.g., ISAR*, BINAURAL*). Prefix +/- to add/remove.\n"
            "  LEVEL1, LEVEL2, LEVEL3              — Conformance level. LEVEL1: ≤80 kbps; LEVEL2: ≤192 kbps; LEVEL3: unlimited (default).\n"
            "  ENC, DEC, REND, ISAR, ISAR_ENC      — Test groups (ENC+DEC are baseline; REND/ISAR optional).\n"
            "  MONO, STEREO, EXT, HOA, SBA, MC     — Output formats (ENC/DEC only). Aliases: HOA→{HOA2,HOA3}, SBA→{FOA,HOA2,HOA3}, MC→{5_1,7_1,5_1_4,5_1_2,7_1_4}.\n"
            "  (any other)                         — Substring match (case-insensitive). Multiple terms combine with AND.\n"
            "\n"
            "TOKEN MODIFIERS:\n"
            "  +TOKEN                              — Add matching tests to selection (even if they would be excluded).\n"
            "  -TOKEN                              — Remove matching tests from selection.\n"
            "  TOKEN*                              — Wildcard: match all tokens starting with TOKEN (e.g., ISAR* → {ISAR, ISAR_ENC}; BINAURAL* → {BINAURAL, BINAURAL_IR, BINAURAL_ROOM_IR, ...}).\n"
            "  +TOKEN*, -TOKEN*                    — Wildcard with add/remove modifiers (e.g., +ISAR*, -BINAURAL*).\n"
            "\n"
            "EXAMPLES:\n"
            "  --filter LEVEL1                     Run LEVEL1 ENC+DEC (≤80 kbps).\n"
            "  --filter LEVEL2                     Run LEVEL2 ENC+DEC (≤192 kbps).\n"
            "  --filter LEVEL1 DEC MONO           Run LEVEL1 DEC MONO tests only.\n"
            "  --filter +REND +ISAR               Add REND and ISAR to default ENC+DEC.\n"
            "  --filter LEVEL1 DEC MONO            Restrict to DEC MONO tests at LEVEL1.\n"
            "  --filter +REND +ISAR                Add REND and ISAR to baseline ENC+DEC.\n"
            "  --filter DEC HOA                    Run DEC tests with HOA2/HOA3 outputs.\n"
            "  --filter DEC +BINAURAL             Run all LEVEL3 DEC tests plus BINAURAL variant matches.\n"
            "  --filter DEC JBM +BINAURAL         Run JBM DEC tests + BINAURAL-variant tests.\n"
            "  --filter DEC -voip                 Run all LEVEL3 DEC tests except those matching 'voip'.\n"
            "  --filter DEC -voip                  Run DEC tests except those matching 'voip'.\n"
            "  --filter ISAR*                      Add ISAR and ISAR_ENC (wildcard expansion).\n"
            "  --filter DEC +BINAURAL*             Run LEVEL3 DEC + all BINAURAL variant outputs.\n"
            "  --filter +ISAR* -voip               Add ISAR/ISAR_ENC groups then remove 'voip' tests.\n"
        ),
    )
    parser.add_argument(