Source Code for Module SCons.Variables.PackageVariable'

  1  """engine.SCons.Variables.PackageVariable 
  2   
  3  This file defines the option type for SCons implementing 'package 
  4  activation'. 
  5   
  6  To be used whenever a 'package' may be enabled/disabled and the 
  7  package path may be specified. 
  8   
  9  Usage example: 
 10   
 11    Examples: 
 12        x11=no   (disables X11 support) 
 13        x11=yes  (will search for the package installation dir) 
 14        x11=/usr/local/X11 (will check this path for existance) 
 15   
 16    To replace autoconf's --with-xxx=yyy  
 17   
 18    opts = Variables() 
 19    opts.Add(PackageVariable('x11', 
 20                           'use X11 installed here (yes = search some places', 
 21                           'yes')) 
 22    ... 
 23    if env['x11'] == True: 
 24        dir = ... search X11 in some standard places ... 
 25        env['x11'] = dir  
 26    if env['x11']: 
 27        ... build with x11 ... 
 28  """ 
 29   
 30  # 
 31  # Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 The SCons Foundation 
 32  # 
 33  # Permission is hereby granted, free of charge, to any person obtaining 
 34  # a copy of this software and associated documentation files (the 
 35  # "Software"), to deal in the Software without restriction, including 
 36  # without limitation the rights to use, copy, modify, merge, publish, 
 37  # distribute, sublicense, and/or sell copies of the Software, and to 
 38  # permit persons to whom the Software is furnished to do so, subject to 
 39  # the following conditions: 
 40  # 
 41  # The above copyright notice and this permission notice shall be included 
 42  # in all copies or substantial portions of the Software. 
 43  # 
 44  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
 45  # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE 
 46  # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
 47  # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 
 48  # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
 49  # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 
 50  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 
 51  # 
 52   
 53  __revision__ = "src/engine/SCons/Variables/PackageVariable.py 3795 2008/11/25 22:04:43 scons" 
 54   
 55  __all__ = ['PackageVariable',] 
 56   
 57  import string 
 58   
 59  import SCons.Errors 
 60   
 61  __enable_strings  = ('1', 'yes', 'true',  'on', 'enable', 'search') 
 62  __disable_strings = ('0', 'no',  'false', 'off', 'disable') 
 63   
 64 -def _converter(val): 
 65      """ 
 66      """ 
 67      lval = string.lower(val) 
 68      if lval in __enable_strings: return True 
 69      if lval in __disable_strings: return False 
 70      #raise ValueError("Invalid value for boolean option: %s" % val) 
 71      return val 
 72   
 73   
 74 -def _validator(key, val, env, searchfunc): 
 75      # NB: searchfunc is currenty undocumented and unsupported 
 76      """ 
 77      """ 
 78      # todo: write validator, check for path 
 79      import os 
 80      if env[key] is True: 
 81          if searchfunc: 
 82              env[key] = searchfunc(key, val) 
 83      elif env[key] and not os.path.exists(val): 
 84          raise SCons.Errors.UserError( 
 85              'Path does not exist for option %s: %s' % (key, val)) 
 86   
 87   
 88 -def PackageVariable(key, help, default, searchfunc=None): 
 89      # NB: searchfunc is currenty undocumented and unsupported 
 90      """ 
 91      The input parameters describe a 'package list' option, thus they 
 92      are returned with the correct converter and validator appended. The 
 93      result is usable for input to opts.Add() . 
 94   
 95      A 'package list' option may either be 'all', 'none' or a list of 
 96      package names (seperated by space). 
 97      """ 
 98      help = string.join( 
 99          (help, '( yes | no | /path/to/%s )' % key), 
100          '\n    ') 
101      return (key, help, default, 
102              lambda k, v, e, f=searchfunc: _validator(k,v,e,f), 
103              _converter) 
104