3 # Copyright (c) 2007 Johannes Schindelin
6 test_description
='our own option parser'
11 usage
: test-tool parse-options
<options
>
13 A helper
function for the parse-options API.
16 -D, --no-doubt begins with
'no-'
17 -B, --no-fear be brave
18 -b, --boolean increment by one
19 -4, --or4 bitwise-or boolean with ..
.0100
20 --neg-or4 same as
--no-or4
22 -i, --integer <n
> get a integer
23 -j <n
> get a integer
, too
24 -m, --magnitude <n
> get a magnitude
25 --set23 set integer to
23
26 -L, --length <str
> get length of
<str
>
27 -F, --file <file> set file to
<file>
32 --string2 <str
> get another string
33 --st <st
> get another string
(pervert ordering
)
34 -o <str
> get another string
35 --list <str
> add str to list
39 -NUM set integer to NUM
41 --ambiguous positive ambiguity
42 --no-ambiguous negative ambiguity
45 --abbrev[=<n
>] use
<n
> digits to display SHA-1s
46 -v, --verbose be verbose
49 --expect <string
> expected output
in the variable dump
52 -A, --alias-source <string
>
54 -Z, --alias-target <string
>
59 test_expect_success
'test help' '
60 test_must_fail test-tool parse-options -h >output 2>output.err &&
61 test_must_be_empty output.err &&
62 test_i18ncmp expect output
72 test-tool parse-options
--expect="$what $expect" "$@"
75 check_unknown_i18n
() {
78 echo error
: unknown option \
`${1#--}\' >expect ;;
80 echo error: unknown switch \`${1#-}\' >expect
;;
82 cat expect.err
>>expect
&&
83 test_must_fail test-tool parse-options $
* >output
2>output.err
&&
84 test_must_be_empty output
&&
85 test_i18ncmp expect output.err
88 test_expect_success
'OPT_BOOL() #1' 'check boolean: 1 --yes'
89 test_expect_success
'OPT_BOOL() #2' 'check boolean: 1 --no-doubt'
90 test_expect_success
'OPT_BOOL() #3' 'check boolean: 1 -D'
91 test_expect_success
'OPT_BOOL() #4' 'check boolean: 1 --no-fear'
92 test_expect_success
'OPT_BOOL() #5' 'check boolean: 1 -B'
94 test_expect_success
'OPT_BOOL() is idempotent #1' 'check boolean: 1 --yes --yes'
95 test_expect_success
'OPT_BOOL() is idempotent #2' 'check boolean: 1 -DB'
97 test_expect_success
'OPT_BOOL() negation #1' 'check boolean: 0 -D --no-yes'
98 test_expect_success
'OPT_BOOL() negation #2' 'check boolean: 0 -D --no-no-doubt'
100 test_expect_success
'OPT_BOOL() no negation #1' 'check_unknown_i18n --fear'
101 test_expect_success
'OPT_BOOL() no negation #2' 'check_unknown_i18n --no-no-fear'
103 test_expect_success
'OPT_BOOL() positivation' 'check boolean: 0 -D --doubt'
105 test_expect_success
'OPT_INT() negative' 'check integer: -2345 -i -2345'
107 test_expect_success
'OPT_MAGNITUDE() simple' '
108 check magnitude: 2345678 -m 2345678
111 test_expect_success
'OPT_MAGNITUDE() kilo' '
112 check magnitude: 239616 -m 234k
115 test_expect_success
'OPT_MAGNITUDE() mega' '
116 check magnitude: 104857600 -m 100m
119 test_expect_success
'OPT_MAGNITUDE() giga' '
120 check magnitude: 1073741824 -m 1g
123 test_expect_success
'OPT_MAGNITUDE() 3giga' '
124 check magnitude: 3221225472 -m 3g
140 test_expect_success
'short options' '
141 test-tool parse-options -s123 -b -i 1729 -m 16k -b -vv -n -F my.file \
142 >output 2>output.err &&
143 test_cmp expect output &&
144 test_must_be_empty output.err
160 test_expect_success
'long options' '
161 test-tool parse-options --boolean --integer 1729 --magnitude 16k \
162 --boolean --string2=321 --verbose --verbose --no-dry-run \
163 --abbrev=10 --file fi.le --obsolete \
164 >output 2>output.err &&
165 test_must_be_empty output.err &&
166 test_cmp expect output
169 test_expect_success
'missing required value' '
170 test_expect_code 129 test-tool parse-options -s &&
171 test_expect_code 129 test-tool parse-options --string &&
172 test_expect_code 129 test-tool parse-options --file
191 test_expect_success
'intermingled arguments' '
192 test-tool parse-options a1 --string 123 b1 --boolean -j 13 -- --boolean \
193 >output 2>output.err &&
194 test_must_be_empty output.err &&
195 test_cmp expect output
211 test_expect_success
'unambiguously abbreviated option' '
212 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
213 test-tool parse-options --int 2 --boolean --no-bo >output 2>output.err &&
214 test_must_be_empty output.err &&
215 test_cmp expect output
218 test_expect_success
'unambiguously abbreviated option with "="' '
219 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
220 test-tool parse-options --expect="integer: 2" --int=2
223 test_expect_success
'ambiguously abbreviated option' '
224 test_expect_code 129 env GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
225 test-tool parse-options --strin 123
228 test_expect_success
'non ambiguous option (after two options it abbreviates)' '
229 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
230 test-tool parse-options --expect="string: 123" --st 123
233 test_expect_success
'Alias options do not contribute to abbreviation' '
234 test-tool parse-options --alias-source 123 >output &&
235 grep "^string: 123" output &&
236 test-tool parse-options --alias-target 123 >output &&
237 grep "^string: 123" output &&
238 test_must_fail test-tool parse-options --alias &&
239 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
240 test-tool parse-options --alias 123 >output &&
241 grep "^string: 123" output
245 error
: did you mean
`--boolean` (with two dashes ?
)
248 test_expect_success
'detect possible typos' '
249 test_must_fail test-tool parse-options -boolean >output 2>output.err &&
250 test_must_be_empty output &&
251 test_i18ncmp typo.err output.err
255 error
: did you mean
`--ambiguous` (with two dashes ?
)
258 test_expect_success
'detect possible typos' '
259 test_must_fail test-tool parse-options -ambiguous >output 2>output.err &&
260 test_must_be_empty output &&
261 test_i18ncmp typo.err output.err
264 test_expect_success
'keep some options as arguments' '
265 test-tool parse-options --expect="arg 00: --quux" --quux
282 test_expect_success
'OPT_CALLBACK() and OPT_BIT() work' '
283 test-tool parse-options --length=four -b -4 >output 2>output.err &&
284 test_must_be_empty output.err &&
285 test_cmp expect output
288 test_expect_success
'OPT_CALLBACK() and callback errors work' '
289 test_must_fail test-tool parse-options --no-length >output 2>output.err &&
290 test_must_be_empty output &&
291 test_must_be_empty output.err
307 test_expect_success
'OPT_BIT() and OPT_SET_INT() work' '
308 test-tool parse-options --set23 -bbbbb --no-or4 >output 2>output.err &&
309 test_must_be_empty output.err &&
310 test_cmp expect output
313 test_expect_success
'OPT_NEGBIT() and OPT_SET_INT() work' '
314 test-tool parse-options --set23 -bbbbb --neg-or4 >output 2>output.err &&
315 test_must_be_empty output.err &&
316 test_cmp expect output
319 test_expect_success
'OPT_BIT() works' '
320 test-tool parse-options --expect="boolean: 6" -bb --or4
323 test_expect_success
'OPT_NEGBIT() works' '
324 test-tool parse-options --expect="boolean: 6" -bb --no-neg-or4
327 test_expect_success
'OPT_COUNTUP() with PARSE_OPT_NODASH works' '
328 test-tool parse-options --expect="boolean: 6" + + + + + +
331 test_expect_success
'OPT_NUMBER_CALLBACK() works' '
332 test-tool parse-options --expect="integer: 12345" -12345
348 test_expect_success
'negation of OPT_NONEG flags is not ambiguous' '
349 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
350 test-tool parse-options --no-ambig >output 2>output.err &&
351 test_must_be_empty output.err &&
352 test_cmp expect output
360 test_expect_success
'--list keeps list of strings' '
361 test-tool parse-options --list foo --list=bar --list=baz >output &&
362 test_cmp expect output
365 test_expect_success
'--no-list resets list' '
366 test-tool parse-options --list=other --list=irrelevant --list=options \
367 --no-list --list=foo --list=bar --list=baz >output &&
368 test_cmp expect output
371 test_expect_success
'multiple quiet levels' '
372 test-tool parse-options --expect="quiet: 3" -q -q -q
375 test_expect_success
'multiple verbose levels' '
376 test-tool parse-options --expect="verbose: 3" -v -v -v
379 test_expect_success
'--no-quiet sets --quiet to 0' '
380 test-tool parse-options --expect="quiet: 0" --no-quiet
383 test_expect_success
'--no-quiet resets multiple -q to 0' '
384 test-tool parse-options --expect="quiet: 0" -q -q -q --no-quiet
387 test_expect_success
'--no-verbose sets verbose to 0' '
388 test-tool parse-options --expect="verbose: 0" --no-verbose
391 test_expect_success
'--no-verbose resets multiple verbose to 0' '
392 test-tool parse-options --expect="verbose: 0" -v -v -v --no-verbose
395 test_expect_success
'GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS works' '
396 GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=false \
397 test-tool parse-options --ye &&
398 test_must_fail env GIT_TEST_DISALLOW_ABBREVIATED_OPTIONS=true \
399 test-tool parse-options --ye