Source

SCons / test / explain / basic.py

Full commit
#!/usr/bin/env python
#
# __COPYRIGHT__
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be included
# in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
# KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#

__revision__ = "__FILE__ __REVISION__ __DATE__ __DEVELOPER__"

"""
Verify a lot of the basic operation of the --debug=explain option.
"""

import os.path
import string
import sys
import TestSCons

_python_ = TestSCons._python_

test = TestSCons.TestSCons()

test.subdir(['src'], ['src', 'subdir'])

subdir_file7 = os.path.join('subdir', 'file7')
subdir_file7_in = os.path.join('subdir', 'file7.in')

cat_py = test.workpath('cat.py')
inc_aaa = test.workpath('inc', 'aaa')
inc_ddd = test.workpath('inc', 'ddd')
inc_eee = test.workpath('inc', 'eee')
inc_bbb_k = test.workpath('inc', 'bbb.k')



test.write(cat_py, r"""
import sys

def process(outfp, infp):
    for line in infp.readlines():
        if line[:8] == 'include ':
            file = line[8:-1]
            try:
                fp = open(file, 'rb')
            except IOError:
                import os
                print "os.getcwd() =", os.getcwd()
                raise
            process(outfp, fp)
        else:
            outfp.write(line)

outfp = open(sys.argv[1], 'wb')
for f in sys.argv[2:]:
    if f != '-':
        process(outfp, open(f, 'rb'))

sys.exit(0)
""")

SConstruct_contents = """\
import re

include_re = re.compile(r'^include\s+(\S+)$', re.M)

def kfile_scan(node, env, target, arg):
    contents = node.get_contents()
    includes = include_re.findall(contents)
    return includes

kscan = Scanner(name = 'kfile',
                function = kfile_scan,
                argument = None,
                skeys = ['.k'])

cat = Builder(action = r'%(_python_)s %(cat_py)s $TARGET $SOURCES')

env = Environment()
env.Append(BUILDERS = {'Cat':cat},
           SCANNERS = kscan)

Export("env")
SConscript('SConscript')
env.Install('../inc', 'aaa')
env.InstallAs('../inc/bbb.k', 'bbb.k')
env.Install('../inc', 'ddd')
env.InstallAs('../inc/eee', 'eee.in')
""" % locals()

test.write(['src', 'SConstruct'], SConstruct_contents)

test.write(['src', 'SConscript'], """\
Import("env")
env.Cat('file1', 'file1.in')
env.Cat('file2', 'file2.k')
env.Cat('file3', ['xxx', 'yyy', 'zzz'])
env.Command('file4', 'file4.in',
             r'%(_python_)s %(cat_py)s $TARGET $FILE4FLAG $SOURCES',
             FILE4FLAG='-')
env.Cat('file5', 'file5.k')
file6 = env.Cat('file6', 'file6.in')
AlwaysBuild(file6)
env.Cat('subdir/file7', 'subdir/file7.in')
""" % locals())

test.write(['src', 'aaa'], "aaa 1\n")
test.write(['src', 'bbb.k'], """\
bbb.k 1
include ccc
include ../inc/ddd
include ../inc/eee
""")
test.write(['src', 'ccc'], "ccc 1\n")
test.write(['src', 'ddd'], "ddd 1\n")
test.write(['src', 'eee.in'], "eee.in 1\n")

test.write(['src', 'file1.in'], "file1.in 1\n")

test.write(['src', 'file2.k'], """\
file2.k 1 line 1
include xxx
include yyy
file2.k 1 line 4
""")

test.write(['src', 'file4.in'], "file4.in 1\n")

test.write(['src', 'xxx'], "xxx 1\n")
test.write(['src', 'yyy'], "yyy 1\n")
test.write(['src', 'zzz'], "zzz 1\n")

test.write(['src', 'file5.k'], """\
file5.k 1 line 1
include ../inc/aaa
include ../inc/bbb.k
file5.k 1 line 4
""")

test.write(['src', 'file6.in'], "file6.in 1\n")

test.write(['src', 'subdir', 'file7.in'], "subdir/file7.in 1\n")



args = '--debug=explain .'



expect = test.wrap_stdout("""\
scons: building `file1' because it doesn't exist
%(_python_)s %(cat_py)s file1 file1.in
scons: building `file2' because it doesn't exist
%(_python_)s %(cat_py)s file2 file2.k
scons: building `file3' because it doesn't exist
%(_python_)s %(cat_py)s file3 xxx yyy zzz
scons: building `file4' because it doesn't exist
%(_python_)s %(cat_py)s file4 - file4.in
scons: building `%(inc_aaa)s' because it doesn't exist
Install file: "aaa" as "%(inc_aaa)s"
scons: building `%(inc_ddd)s' because it doesn't exist
Install file: "ddd" as "%(inc_ddd)s"
scons: building `%(inc_eee)s' because it doesn't exist
Install file: "eee.in" as "%(inc_eee)s"
scons: building `%(inc_bbb_k)s' because it doesn't exist
Install file: "bbb.k" as "%(inc_bbb_k)s"
scons: building `file5' because it doesn't exist
%(_python_)s %(cat_py)s file5 file5.k
scons: building `file6' because it doesn't exist
%(_python_)s %(cat_py)s file6 file6.in
scons: building `%(subdir_file7)s' because it doesn't exist
%(_python_)s %(cat_py)s %(subdir_file7)s %(subdir_file7_in)s
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file1'], "file1.in 1\n")
test.must_match(['src', 'file2'], """\
file2.k 1 line 1
xxx 1
yyy 1
file2.k 1 line 4
""")
test.must_match(['src', 'file3'], "xxx 1\nyyy 1\nzzz 1\n")
test.must_match(['src', 'file4'], "file4.in 1\n")
test.must_match(['src', 'file5'], """\
file5.k 1 line 1
aaa 1
bbb.k 1
ccc 1
ddd 1
eee.in 1
file5.k 1 line 4
""")
test.must_match(['src', 'file6'], "file6.in 1\n")



test.write(['src', 'file1.in'], "file1.in 2\n")
test.write(['src', 'yyy'], "yyy 2\n")
test.write(['src', 'zzz'], "zzz 2\n")
test.write(['src', 'bbb.k'], "bbb.k 2\ninclude ccc\n")

expect = test.wrap_stdout("""\
scons: rebuilding `file1' because `file1.in' changed
%(_python_)s %(cat_py)s file1 file1.in
scons: rebuilding `file2' because `yyy' changed
%(_python_)s %(cat_py)s file2 file2.k
scons: rebuilding `file3' because:
           `yyy' changed
           `zzz' changed
%(_python_)s %(cat_py)s file3 xxx yyy zzz
scons: rebuilding `%(inc_bbb_k)s' because:
           `%(inc_ddd)s' is no longer a dependency
           `%(inc_eee)s' is no longer a dependency
           `bbb.k' changed
Install file: "bbb.k" as "%(inc_bbb_k)s"
scons: rebuilding `file5' because `%(inc_bbb_k)s' changed
%(_python_)s %(cat_py)s file5 file5.k
scons: rebuilding `file6' because AlwaysBuild() is specified
%(_python_)s %(cat_py)s file6 file6.in
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file1'], "file1.in 2\n")
test.must_match(['src', 'file2'], """\
file2.k 1 line 1
xxx 1
yyy 2
file2.k 1 line 4
""")
test.must_match(['src', 'file3'], "xxx 1\nyyy 2\nzzz 2\n")
test.must_match(['src', 'file5'], """\
file5.k 1 line 1
aaa 1
bbb.k 2
ccc 1
file5.k 1 line 4
""")



test.write(['src', 'SConscript'], """\
Import("env")
env.Cat('file3', ['xxx', 'yyy'])
""")

expect = test.wrap_stdout("""\
scons: rebuilding `file3' because `zzz' is no longer a dependency
%(_python_)s %(cat_py)s file3 xxx yyy
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file3'], "xxx 1\nyyy 2\n")



test.write(['src', 'SConscript'], """\
Import("env")
env.Cat('file3', ['xxx', 'yyy', 'zzz'])
""")

expect = test.wrap_stdout("""\
scons: rebuilding `file3' because `zzz' is a new dependency
%(_python_)s %(cat_py)s file3 xxx yyy zzz
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file3'], "xxx 1\nyyy 2\nzzz 2\n")



test.write(['src', 'SConscript'], """\
Import("env")
env.Cat('file3', ['zzz', 'yyy', 'xxx'])
""")

expect = test.wrap_stdout("""\
scons: rebuilding `file3' because the dependency order changed:
               old: ['xxx', 'yyy', 'zzz']
               new: ['zzz', 'yyy', 'xxx']
%(_python_)s %(cat_py)s file3 zzz yyy xxx
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file3'], "zzz 2\nyyy 2\nxxx 1\n")



test.write(['src', 'SConscript'], """\
Import("env")
f3 = File('file3')
env.Cat(f3, ['zzz', 'yyy', 'xxx'])
env.AddPostAction(f3, r'%(_python_)s %(cat_py)s ${TARGET}.yyy $SOURCES yyy')
env.AddPreAction(f3, r'%(_python_)s %(cat_py)s ${TARGET}.alt $SOURCES')
""" % locals())

expect = test.wrap_stdout("""\
scons: rebuilding `file3' because the build action changed:
               old: %(_python_)s %(cat_py)s $TARGET $SOURCES
               new: %(_python_)s %(cat_py)s ${TARGET}.alt $SOURCES
                    %(_python_)s %(cat_py)s $TARGET $SOURCES
                    %(_python_)s %(cat_py)s ${TARGET}.yyy $SOURCES yyy
%(_python_)s %(cat_py)s file3.alt zzz yyy xxx
%(_python_)s %(cat_py)s file3 zzz yyy xxx
%(_python_)s %(cat_py)s file3.yyy zzz yyy xxx yyy
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file3'], "zzz 2\nyyy 2\nxxx 1\n")
test.must_match(['src', 'file3.alt'], "zzz 2\nyyy 2\nxxx 1\n")
test.must_match(['src', 'file3.yyy'], "zzz 2\nyyy 2\nxxx 1\nyyy 2\n")



test.write(['src', 'SConscript'], """\
Import("env")
f3 = File('file3')
env.Cat(f3, ['zzz', 'yyy', 'xxx'])
env.AddPostAction(f3, r'%(_python_)s %(cat_py)s ${TARGET}.yyy $SOURCES xxx')
env.AddPreAction(f3, r'%(_python_)s %(cat_py)s ${TARGET}.alt $SOURCES')
""" % locals())

expect = test.wrap_stdout("""\
scons: rebuilding `file3' because the build action changed:
               old: %(_python_)s %(cat_py)s ${TARGET}.alt $SOURCES
                    %(_python_)s %(cat_py)s $TARGET $SOURCES
                    %(_python_)s %(cat_py)s ${TARGET}.yyy $SOURCES yyy
               new: %(_python_)s %(cat_py)s ${TARGET}.alt $SOURCES
                    %(_python_)s %(cat_py)s $TARGET $SOURCES
                    %(_python_)s %(cat_py)s ${TARGET}.yyy $SOURCES xxx
%(_python_)s %(cat_py)s file3.alt zzz yyy xxx
%(_python_)s %(cat_py)s file3 zzz yyy xxx
%(_python_)s %(cat_py)s file3.yyy zzz yyy xxx xxx
""" % locals())

test.run(chdir='src', arguments=args, stdout=expect)

test.must_match(['src', 'file3'], "zzz 2\nyyy 2\nxxx 1\n")
test.must_match(['src', 'file3.alt'], "zzz 2\nyyy 2\nxxx 1\n")
test.must_match(['src', 'file3.yyy'], "zzz 2\nyyy 2\nxxx 1\nxxx 1\n")



test.write(['src', 'SConscript'], """\
Import("env")
env.Command('file4', 'file4.in',
            r'%(_python_)s %(cat_py)s $TARGET $FILE4FLAG $SOURCES',
            FILE4FLAG='')
""" % locals())

expect = test.wrap_stdout("""\
scons: rebuilding `file4' because the contents of the build action changed
               action: %(_python_)s %(cat_py)s $TARGET $FILE4FLAG $SOURCES
%(_python_)s %(cat_py)s file4 file4.in
""" % locals())

test.run(chdir='src',arguments=args, stdout=expect)

test.must_match(['src', 'file4'], "file4.in 1\n")

test.up_to_date(chdir='src',arguments='.')



# Test the transition when you turn ON SConsignFile().
# This will (or might) rebuild things, but we don't care what,
# we just want to make sure we don't blow up.
test.write(['src', 'SConstruct'],
           "SConsignFile()\n" + SConstruct_contents)

test.run(chdir='src', arguments=args)

test.up_to_date(chdir='src',arguments='.')



test.pass_test()