t/t0040-parse-options.sh

   1 #!/bin/sh
   2 #
   3 # Copyright (c) 2007 Johannes Schindelin
   4 #
   5
   6 test_description='our own option parser'
   7
   8 . ./test-lib.sh
   9
  10 cat > expect << EOF
  11 usage: test-parse-options <options>
  12
  13     -b, --boolean         get a boolean
  14     -4, --or4             bitwise-or boolean with ...0100
  15     --neg-or4             same as --no-or4
  16
  17     -i, --integer <n>     get a integer
  18     -j <n>                get a integer, too
  19     --set23               set integer to 23
  20     -t <time>             get timestamp of <time>
  21     -L, --length <str>    get length of <str>
  22     -F, --file <file>     set file to <file>
  23
  24 String options
  25     -s, --string <string>
  26                           get a string
  27     --string2 <str>       get another string
  28     --st <st>             get another string (pervert ordering)
  29     -o <str>              get another string
  30     --default-string      set string to default
  31     --list <str>          add str to list
  32
  33 Magic arguments
  34     --quux                means --quux
  35     -NUM                  set integer to NUM
  36     +                     same as -b
  37     --ambiguous           positive ambiguity
  38     --no-ambiguous        negative ambiguity
  39
  40 Standard options
  41     --abbrev[=<n>]        use <n> digits to display SHA-1s
  42     -v, --verbose         be verbose
  43     -n, --dry-run         dry run
  44     -q, --quiet           be quiet
  45
  46 EOF
  47
  48 test_expect_success 'test help' '
  49         test_must_fail test-parse-options -h > output 2> output.err &&
  50         test ! -s output.err &&
  51         test_cmp expect output
  52 '
  53
  54 mv expect expect.err
  55
  56 cat > expect << EOF
  57 boolean: 2
  58 integer: 1729
  59 timestamp: 0
  60 string: 123
  61 abbrev: 7
  62 verbose: 2
  63 quiet: no
  64 dry run: yes
  65 file: prefix/my.file
  66 EOF
  67
  68 test_expect_success 'short options' '
  69         test-parse-options -s123 -b -i 1729 -b -vv -n -F my.file \
  70         > output 2> output.err &&
  71         test_cmp expect output &&
  72         test ! -s output.err
  73 '
  74
  75 cat > expect << EOF
  76 boolean: 2
  77 integer: 1729
  78 timestamp: 0
  79 string: 321
  80 abbrev: 10
  81 verbose: 2
  82 quiet: no
  83 dry run: no
  84 file: prefix/fi.le
  85 EOF
  86
  87 test_expect_success 'long options' '
  88         test-parse-options --boolean --integer 1729 --boolean --string2=321 \
  89                 --verbose --verbose --no-dry-run --abbrev=10 --file fi.le\
  90                 --obsolete > output 2> output.err &&
  91         test ! -s output.err &&
  92         test_cmp expect output
  93 '
  94
  95 test_expect_success 'missing required value' '
  96         test-parse-options -s;
  97         test $? = 129 &&
  98         test-parse-options --string;
  99         test $? = 129 &&
 100         test-parse-options --file;
 101         test $? = 129
 102 '
 103
 104 cat > expect << EOF
 105 boolean: 1
 106 integer: 13
 107 timestamp: 0
 108 string: 123
 109 abbrev: 7
 110 verbose: 0
 111 quiet: no
 112 dry run: no
 113 file: (not set)
 114 arg 00: a1
 115 arg 01: b1
 116 arg 02: --boolean
 117 EOF
 118
 119 test_expect_success 'intermingled arguments' '
 120         test-parse-options a1 --string 123 b1 --boolean -j 13 -- --boolean \
 121                 > output 2> output.err &&
 122         test ! -s output.err &&
 123         test_cmp expect output
 124 '
 125
 126 cat > expect << EOF
 127 boolean: 0
 128 integer: 2
 129 timestamp: 0
 130 string: (not set)
 131 abbrev: 7
 132 verbose: 0
 133 quiet: no
 134 dry run: no
 135 file: (not set)
 136 EOF
 137
 138 test_expect_success 'unambiguously abbreviated option' '
 139         test-parse-options --int 2 --boolean --no-bo > output 2> output.err &&
 140         test ! -s output.err &&
 141         test_cmp expect output
 142 '
 143
 144 test_expect_success 'unambiguously abbreviated option with "="' '
 145         test-parse-options --int=2 > output 2> output.err &&
 146         test ! -s output.err &&
 147         test_cmp expect output
 148 '
 149
 150 test_expect_success 'ambiguously abbreviated option' '
 151         test-parse-options --strin 123;
 152         test $? = 129
 153 '
 154
 155 cat > expect << EOF
 156 boolean: 0
 157 integer: 0
 158 timestamp: 0
 159 string: 123
 160 abbrev: 7
 161 verbose: 0
 162 quiet: no
 163 dry run: no
 164 file: (not set)
 165 EOF
 166
 167 test_expect_success 'non ambiguous option (after two options it abbreviates)' '
 168         test-parse-options --st 123 > output 2> output.err &&
 169         test ! -s output.err &&
 170         test_cmp expect output
 171 '
 172
 173 cat > typo.err << EOF
 174 error: did you mean \`--boolean\` (with two dashes ?)
 175 EOF
 176
 177 test_expect_success 'detect possible typos' '
 178         test_must_fail test-parse-options -boolean > output 2> output.err &&
 179         test ! -s output &&
 180         test_cmp typo.err output.err
 181 '
 182
 183 cat > expect <<EOF
 184 boolean: 0
 185 integer: 0
 186 timestamp: 0
 187 string: (not set)
 188 abbrev: 7
 189 verbose: 0
 190 quiet: no
 191 dry run: no
 192 file: (not set)
 193 arg 00: --quux
 194 EOF
 195
 196 test_expect_success 'keep some options as arguments' '
 197         test-parse-options --quux > output 2> output.err &&
 198         test ! -s output.err &&
 199         test_cmp expect output
 200 '
 201
 202 cat > expect <<EOF
 203 boolean: 0
 204 integer: 0
 205 timestamp: 1
 206 string: default
 207 abbrev: 7
 208 verbose: 0
 209 quiet: yes
 210 dry run: no
 211 file: (not set)
 212 arg 00: foo
 213 EOF
 214
 215 test_expect_success 'OPT_DATE() and OPT_SET_PTR() work' '
 216         test-parse-options -t "1970-01-01 00:00:01 +0000" --default-string \
 217                 foo -q > output 2> output.err &&
 218         test ! -s output.err &&
 219         test_cmp expect output
 220 '
 221
 222 cat > expect <<EOF
 223 Callback: "four", 0
 224 boolean: 5
 225 integer: 4
 226 timestamp: 0
 227 string: (not set)
 228 abbrev: 7
 229 verbose: 0
 230 quiet: no
 231 dry run: no
 232 file: (not set)
 233 EOF
 234
 235 test_expect_success 'OPT_CALLBACK() and OPT_BIT() work' '
 236         test-parse-options --length=four -b -4 > output 2> output.err &&
 237         test ! -s output.err &&
 238         test_cmp expect output
 239 '
 240
 241 cat > expect <<EOF
 242 Callback: "not set", 1
 243 EOF
 244
 245 test_expect_success 'OPT_CALLBACK() and callback errors work' '
 246         test_must_fail test-parse-options --no-length > output 2> output.err &&
 247         test_cmp expect output &&
 248         test_cmp expect.err output.err
 249 '
 250
 251 cat > expect <<EOF
 252 boolean: 1
 253 integer: 23
 254 timestamp: 0
 255 string: (not set)
 256 abbrev: 7
 257 verbose: 0
 258 quiet: no
 259 dry run: no
 260 file: (not set)
 261 EOF
 262
 263 test_expect_success 'OPT_BIT() and OPT_SET_INT() work' '
 264         test-parse-options --set23 -bbbbb --no-or4 > output 2> output.err &&
 265         test ! -s output.err &&
 266         test_cmp expect output
 267 '
 268
 269 test_expect_success 'OPT_NEGBIT() and OPT_SET_INT() work' '
 270         test-parse-options --set23 -bbbbb --neg-or4 > output 2> output.err &&
 271         test ! -s output.err &&
 272         test_cmp expect output
 273 '
 274
 275 cat > expect <<EOF
 276 boolean: 6
 277 integer: 0
 278 timestamp: 0
 279 string: (not set)
 280 abbrev: 7
 281 verbose: 0
 282 quiet: no
 283 dry run: no
 284 file: (not set)
 285 EOF
 286
 287 test_expect_success 'OPT_BIT() works' '
 288         test-parse-options -bb --or4 > output 2> output.err &&
 289         test ! -s output.err &&
 290         test_cmp expect output
 291 '
 292
 293 test_expect_success 'OPT_NEGBIT() works' '
 294         test-parse-options -bb --no-neg-or4 > output 2> output.err &&
 295         test ! -s output.err &&
 296         test_cmp expect output
 297 '
 298
 299 test_expect_success 'OPT_BOOLEAN() with PARSE_OPT_NODASH works' '
 300         test-parse-options + + + + + + > output 2> output.err &&
 301         test ! -s output.err &&
 302         test_cmp expect output
 303 '
 304
 305 cat > expect <<EOF
 306 boolean: 0
 307 integer: 12345
 308 timestamp: 0
 309 string: (not set)
 310 abbrev: 7
 311 verbose: 0
 312 quiet: no
 313 dry run: no
 314 file: (not set)
 315 EOF
 316
 317 test_expect_success 'OPT_NUMBER_CALLBACK() works' '
 318         test-parse-options -12345 > output 2> output.err &&
 319         test ! -s output.err &&
 320         test_cmp expect output
 321 '
 322
 323 cat >expect <<EOF
 324 boolean: 0
 325 integer: 0
 326 timestamp: 0
 327 string: (not set)
 328 abbrev: 7
 329 verbose: 0
 330 quiet: no
 331 dry run: no
 332 file: (not set)
 333 EOF
 334
 335 test_expect_success 'negation of OPT_NONEG flags is not ambiguous' '
 336         test-parse-options --no-ambig >output 2>output.err &&
 337         test ! -s output.err &&
 338         test_cmp expect output
 339 '
 340
 341 cat >>expect <<'EOF'
 342 list: foo
 343 list: bar
 344 list: baz
 345 EOF
 346 test_expect_success '--list keeps list of strings' '
 347         test-parse-options --list foo --list=bar --list=baz >output &&
 348         test_cmp expect output
 349 '
 350
 351 test_expect_success '--no-list resets list' '
 352         test-parse-options --list=other --list=irrelevant --list=options \
 353                 --no-list --list=foo --list=bar --list=baz >output &&
 354         test_cmp expect output
 355 '
 356
 357 test_done