Skip to content

Commit b57f6ab

Browse files
committed
docs(cli): improve --tc-params-file help text with precedence table
- Describe normalisation behaviour (case-insensitive, -/_/. separators) - Note that unmatched TC IDs are silently skipped - Add a numbered NOTE block showing the full config precedence chain: 1. project config 2. --tc-params-file 3. --config 4. -- inline args
1 parent 9d04387 commit b57f6ab

1 file changed

Lines changed: 10 additions & 3 deletions

File tree

th_cli/commands/run_tests.py

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -90,9 +90,16 @@
9090
"-m",
9191
type=click.Path(file_okay=True, dir_okay=False),
9292
help=colorize_help(
93-
"Path to a TC parameters mapping JSON file. "
94-
"Maps TC IDs to test_parameters (e.g. int-arg, string-arg, timeout). "
95-
"Applied after the project config but before --config overrides and inline -- args."
93+
"Path to a JSON file that maps TC IDs to their test_parameters "
94+
"(e.g. int-arg, string-arg, timeout). Entries are matched "
95+
"case-insensitively with separators - _ . normalised. "
96+
"TC IDs not found in the file are silently skipped. "
97+
"\n\nNOTE — Configuration precedence (lowest → highest priority):\n"
98+
" 1. Project config (persistent, from TH project)\n"
99+
" 2. --tc-params-file ← this option\n"
100+
" 3. --config file (execution-only override)\n"
101+
" 4. -- inline args (e.g. -- --int-arg PIXIT.X:1)\n"
102+
"\nHigher-priority sources always win on conflicting keys."
96103
),
97104
)
98105
@click.option(

0 commit comments

Comments
 (0)