Source Code for Module SCons.compat.builtins

  1  # 
  2  # Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 The SCons Foundation 
  3  # 
  4  # Permission is hereby granted, free of charge, to any person obtaining 
  5  # a copy of this software and associated documentation files (the 
  6  # "Software"), to deal in the Software without restriction, including 
  7  # without limitation the rights to use, copy, modify, merge, publish, 
  8  # distribute, sublicense, and/or sell copies of the Software, and to 
  9  # permit persons to whom the Software is furnished to do so, subject to 
 10  # the following conditions: 
 11  # 
 12  # The above copyright notice and this permission notice shall be included 
 13  # in all copies or substantial portions of the Software. 
 14  # 
 15  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
 16  # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE 
 17  # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
 18  # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 
 19  # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
 20  # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 
 21  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 
 22  # 
 23   
 24  # Portions of the following are derived from the compat.py file in 
 25  # Twisted, under the following copyright: 
 26  # 
 27  # Copyright (c) 2001-2004 Twisted Matrix Laboratories 
 28   
 29  __doc__ = """ 
 30  Compatibility idioms for __builtin__ names 
 31   
 32  This module adds names to the __builtin__ module for things that we want 
 33  to use in SCons but which don't show up until later Python versions than 
 34  the earliest ones we support. 
 35   
 36  This module checks for the following __builtin__ names: 
 37   
 38          all() 
 39          any() 
 40          bool() 
 41          dict() 
 42          True 
 43          False 
 44          zip() 
 45   
 46  Implementations of functions are *NOT* guaranteed to be fully compliant 
 47  with these functions in later versions of Python.  We are only concerned 
 48  with adding functionality that we actually use in SCons, so be wary 
 49  if you lift this code for other uses.  (That said, making these more 
 50  nearly the same as later, official versions is still a desirable goal, 
 51  we just don't need to be obsessive about it.) 
 52   
 53  If you're looking at this with pydoc and various names don't show up in 
 54  the FUNCTIONS or DATA output, that means those names are already built in 
 55  to this version of Python and we don't need to add them from this module. 
 56  """ 
 57   
 58  __revision__ = "src/engine/SCons/compat/builtins.py 3842 2008/12/20 22:59:52 scons" 
 59   
 60  import __builtin__ 
 61   
 62  try: 
 63      all 
 64  except NameError: 
 65      # Pre-2.5 Python has no all() function. 
 66 -    def all(iterable): 
 67          """ 
 68          Returns True if all elements of the iterable are true. 
 69          """ 
 70          for element in iterable: 
 71              if not element: 
 72                  return False 
 73          return True 
 74      __builtin__.all = all 
 75      all = all 
 76   
 77  try: 
 78      any 
 79  except NameError: 
 80      # Pre-2.5 Python has no any() function. 
 81 -    def any(iterable): 
 82          """ 
 83          Returns True if any element of the iterable is true. 
 84          """ 
 85          for element in iterable: 
 86              if element: 
 87                  return True 
 88          return False 
 89      __builtin__.any = any 
 90      any = any 
 91   
 92  try: 
 93      bool 
 94  except NameError: 
 95      # Pre-2.2 Python has no bool() function. 
 96 -    def bool(value): 
 97          """Demote a value to 0 or 1, depending on its truth value. 
 98   
 99          This is not to be confused with types.BooleanType, which is 
100          way too hard to duplicate in early Python versions to be 
101          worth the trouble. 
102          """ 
103          return not not value 
104      __builtin__.bool = bool 
105      bool = bool 
106   
107  try: 
108      dict 
109  except NameError: 
110      # Pre-2.2 Python has no dict() keyword. 
111 -    def dict(seq=[], **kwargs): 
112          """ 
113          New dictionary initialization. 
114          """ 
115          d = {} 
116          for k, v in seq: 
117              d[k] = v 
118          d.update(kwargs) 
119          return d 
120      __builtin__.dict = dict 
121   
122  try: 
123      False 
124  except NameError: 
125      # Pre-2.2 Python has no False keyword. 
126      __builtin__.False = not 1 
127      # Assign to False in this module namespace so it shows up in pydoc output. 
128      False = False 
129   
130  try: 
131      True 
132  except NameError: 
133      # Pre-2.2 Python has no True keyword. 
134      __builtin__.True = not 0 
135      # Assign to True in this module namespace so it shows up in pydoc output. 
136      True = True 
137   
138  try: 
139      file 
140  except NameError: 
141      # Pre-2.2 Python has no file() function. 
142      __builtin__.file = open 
143   
144  # 
145  try: 
146      zip 
147  except NameError: 
148      # Pre-2.2 Python has no zip() function. 
149 -    def zip(*lists): 
150          """ 
151          Emulates the behavior we need from the built-in zip() function 
152          added in Python 2.2. 
153   
154          Returns a list of tuples, where each tuple contains the i-th 
155          element rom each of the argument sequences.  The returned 
156          list is truncated in length to the length of the shortest 
157          argument sequence. 
158          """ 
159          result = [] 
160          for i in xrange(min(map(len, lists))): 
161              result.append(tuple(map(lambda l, i=i: l[i], lists))) 
162          return result 
163      __builtin__.zip = zip 
164   
165   
166   
167  #if sys.version_info[:3] in ((2, 2, 0), (2, 2, 1)): 
168  #    def lstrip(s, c=string.whitespace): 
169  #        while s and s[0] in c: 
170  #            s = s[1:] 
171  #        return s 
172  #    def rstrip(s, c=string.whitespace): 
173  #        while s and s[-1] in c: 
174  #            s = s[:-1] 
175  #        return s 
176  #    def strip(s, c=string.whitespace, l=lstrip, r=rstrip): 
177  #        return l(r(s, c), c) 
178  # 
179  #    object.__setattr__(str, 'lstrip', lstrip) 
180  #    object.__setattr__(str, 'rstrip', rstrip) 
181  #    object.__setattr__(str, 'strip', strip) 
182