Add some documentation to the SCons-version-switching hack
[senf.git] / scons / scons-1.2.0 / script / scons
1 #! /usr/bin/env python
2 #
3 # SCons - a Software Constructor
4 #
5 # Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 The SCons Foundation
6 #
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:
14 #
15 # The above copyright notice and this permission notice shall be included
16 # in all copies or substantial portions of the Software.
17 #
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.
25 #
26
27 __revision__ = "src/script/scons.py 3842 2008/12/20 22:59:52 scons"
28
29 __version__ = "1.2.0"
30
31 __build__ = "r3842"
32
33 __buildsys__ = "scons-dev"
34
35 __date__ = "2008/12/20 22:59:52"
36
37 __developer__ = "scons"
38
39 import os
40 import os.path
41 import sys
42
43 ##############################################################################
44 # BEGIN STANDARD SCons SCRIPT HEADER
45 #
46 # This is the cut-and-paste logic so that a self-contained script can
47 # interoperate correctly with different SCons versions and installation
48 # locations for the engine.  If you modify anything in this section, you
49 # should also change other scripts that use this same header.
50 ##############################################################################
51
52 # Strip the script directory from sys.path() so on case-insensitive
53 # (WIN32) systems Python doesn't think that the "scons" script is the
54 # "SCons" package.  Replace it with our own library directories
55 # (version-specific first, in case they installed by hand there,
56 # followed by generic) so we pick up the right version of the build
57 # engine modules if they're in either directory.
58
59 script_dir = sys.path[0]
60
61 if script_dir in sys.path:
62     sys.path.remove(script_dir)
63
64 libs = []
65
66 if os.environ.has_key("SCONS_LIB_DIR"):
67     libs.append(os.environ["SCONS_LIB_DIR"])
68
69 local_version = 'scons-local-' + __version__
70 local = 'scons-local'
71 if script_dir:
72     local_version = os.path.join(script_dir, local_version)
73     local = os.path.join(script_dir, local)
74 libs.append(os.path.abspath(local_version))
75 libs.append(os.path.abspath(local))
76
77 scons_version = 'scons-%s' % __version__
78
79 prefs = []
80
81 if sys.platform == 'win32':
82     # sys.prefix is (likely) C:\Python*;
83     # check only C:\Python*.
84     prefs.append(sys.prefix)
85     prefs.append(os.path.join(sys.prefix, 'Lib', 'site-packages'))
86 else:
87     # On other (POSIX) platforms, things are more complicated due to
88     # the variety of path names and library locations.  Try to be smart
89     # about it.
90     if script_dir == 'bin':
91         # script_dir is `pwd`/bin;
92         # check `pwd`/lib/scons*.
93         prefs.append(os.getcwd())
94     else:
95         if script_dir == '.' or script_dir == '':
96             script_dir = os.getcwd()
97         head, tail = os.path.split(script_dir)
98         if tail == "bin":
99             # script_dir is /foo/bin;
100             # check /foo/lib/scons*.
101             prefs.append(head)
102         elif tail == "script":
103             # script_dir is /foo/script, probably extracted tarball
104             # check /foo/engine
105             libs.append(os.path.join(head, 'engine'))
106
107     head, tail = os.path.split(sys.prefix)
108     if tail == "usr":
109         # sys.prefix is /foo/usr;
110         # check /foo/usr/lib/scons* first,
111         # then /foo/usr/local/lib/scons*.
112         prefs.append(sys.prefix)
113         prefs.append(os.path.join(sys.prefix, "local"))
114     elif tail == "local":
115         h, t = os.path.split(head)
116         if t == "usr":
117             # sys.prefix is /foo/usr/local;
118             # check /foo/usr/local/lib/scons* first,
119             # then /foo/usr/lib/scons*.
120             prefs.append(sys.prefix)
121             prefs.append(head)
122         else:
123             # sys.prefix is /foo/local;
124             # check only /foo/local/lib/scons*.
125             prefs.append(sys.prefix)
126     else:
127         # sys.prefix is /foo (ends in neither /usr or /local);
128         # check only /foo/lib/scons*.
129         prefs.append(sys.prefix)
130
131     temp = map(lambda x: os.path.join(x, 'lib'), prefs)
132     temp.extend(map(lambda x: os.path.join(x,
133                                            'lib',
134                                            'python' + sys.version[:3],
135                                            'site-packages'),
136                            prefs))
137
138     # Add the parent directory of the current python's library to the
139     # preferences.  On SuSE-91/AMD64, for example, this is /usr/lib64,
140     # not /usr/lib.
141     try:
142         libpath = os.__file__
143     except AttributeError:
144         pass
145     else:
146         # Split /usr/libfoo/python*/os.py to /usr/libfoo/python*.
147         libpath, tail = os.path.split(libpath)
148         # Split /usr/libfoo/python* to /usr/libfoo
149         libpath, tail = os.path.split(libpath)
150         # Check /usr/libfoo/scons*.
151         prefs.append(libpath)
152
153 # Look first for 'scons-__version__' in all of our preference libs,
154 # then for 'scons'.
155 libs.extend(map(lambda x: os.path.join(x, scons_version), prefs))
156 libs.extend(map(lambda x: os.path.join(x, 'scons'), prefs))
157
158 sys.path = libs + sys.path
159
160 ##############################################################################
161 # END STANDARD SCons SCRIPT HEADER
162 ##############################################################################
163
164 if __name__ == "__main__":
165     import SCons.Script
166     # this does all the work, and calls sys.exit
167     # with the proper exit status when done.
168     SCons.Script.main()