[ci skip] Add note that this change may break SetOption() + ninja usage with fix
[scons.git] / test / Configure / help.py
blobb7184eea93d2a0d68ad13dedf6282ad74cc261a6
1 #!/usr/bin/env python
3 # MIT License
5 # Copyright The SCons Foundation
7 # Permission is hereby granted, free of charge, to any person obtaining
8 # a copy of this software and associated documentation files (the
9 # "Software"), to deal in the Software without restriction, including
10 # without limitation the rights to use, copy, modify, merge, publish,
11 # distribute, sublicense, and/or sell copies of the Software, and to
12 # permit persons to whom the Software is furnished to do so, subject to
13 # the following conditions:
15 # The above copyright notice and this permission notice shall be included
16 # in all copies or substantial portions of the Software.
18 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
19 # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
20 # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21 # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
22 # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
23 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
24 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE
26 """
27 Verify that we don't perform Configure context actions when the
28 -H, -h or --help options have been specified.
29 """
31 import TestSCons
33 test = TestSCons.TestSCons(match = TestSCons.match_re_dotall)
35 test.write('SConstruct', """\
36 DefaultEnvironment(tools=[])
37 env = Environment()
38 import os
39 env.AppendENVPath('PATH', os.environ['PATH'])
40 conf = Configure(env, help=int(ARGUMENTS['help']))
41 r1 = conf.CheckCHeader( 'math.h' )
42 r2 = conf.CheckCHeader( 'no_std_c_header.h' ) # leads to compile error
43 env = conf.Finish()
44 Export( 'env' )
45 SConscript( 'SConscript' )
46 """)
48 test.write('SConscript', """\
49 Import( 'env' )
50 env.Program( 'TestProgram', 'TestProgram.c' )
51 """)
53 test.write('TestProgram.c', """\
54 #include <stdio.h>
56 int main(void) {
57 printf( "Hello\\n" );
59 """)
61 lines = [
62 "Checking for C header file math.h... ",
63 "Checking for C header file no_std_c_header.h... "
66 # The help setting should have no effect on -H, so the -H output
67 # should never contain the lines.
68 test.run(arguments = '-H help=0')
69 test.must_not_contain_any_line(test.stdout(), lines)
71 test.run(arguments = '-H help=1')
72 test.must_not_contain_any_line(test.stdout(), lines)
74 # For -h and --help, the lines appear or not depending on how Configure()
75 # is initialized.
76 test.run(arguments = '-h help=0')
77 test.must_not_contain_any_line(test.stdout(), lines)
79 test.run(arguments = '-h help=1')
80 test.must_contain_all_lines(test.stdout(), lines)
82 test.run(arguments = '--help help=0')
83 test.must_not_contain_any_line(test.stdout(), lines)
85 test.run(arguments = '--help help=1')
86 test.must_contain_all_lines(test.stdout(), lines)
88 test.pass_test()
90 # Local Variables:
91 # tab-width:4
92 # indent-tabs-mode:nil
93 # End:
94 # vim: set expandtab tabstop=4 shiftwidth=4: