B b@sJdZddlZddlZddlmZmZddlZdgZGdddZ e Z dS)a:Variable type for path Variables. To be used whenever a user-specified path override setting should be allowed. Arguments to PathVariable are: * *key* - name of this option on the command line (e.g. "prefix") * *help* - help string for option * *default* - default value for this option * *validator* - [optional] validator for option value. Predefined are: * *PathAccept* - accepts any path setting; no validation * *PathIsDir* - path must be an existing directory * *PathIsDirCreate* - path must be a dir; will create * *PathIsFile* - path must be a file * *PathExists* - path must exist (any type) [default] The *validator* is a function that is called and which should return True or False to indicate if the path is valid. The arguments to the validator function are: (*key*, *val*, *env*). *key* is the name of the option, *val* is the path specified for the option, and *env* is the environment to which the Options have been added. Usage example:: opts = Variables() opts.Add( PathVariable( 'qtdir', help='where the root of Qt is installed', default=qtdir, validator=PathIsDir, ) ) opts.Add( PathVariable( 'qt_includes', help='where the Qt includes are installed', default='$qtdir/includes', validator=PathIsDirCreate, ) ) opts.Add( PathVariable( 'qt_libraries', help='where the Qt library is installed', default='$qtdir/lib', ) ) N)TupleCallable PathVariablec@seZdZeddddZeddddZeddddZeddd d Zeddd d Zde e e e e dfdd dZ dS)_PathVariableClassN)returncCsdS)z#Accepts any path, no checking done.N)keyvalenvrr;lib/python3.7/site-packages/SCons/Variables/PathVariable.py PathAcceptUsz_PathVariableClass.PathAcceptcCs:tj|s6tj|rd}nd}tj|||fdS)z*Validator to check if Path is a directory.z*Directory path for option %s is a file: %sz/Directory path for option %s does not exist: %sN)ospathisdirisfileSConsErrors UserError)rr r mrrr PathIsDirZs   z_PathVariableClass.PathIsDircCsnytj|ddWnVtk r>d}tj|||fYn,tk rhd}tj|||fYnXdS)zWValidator to check if Path is a directory, creating it if it does not exist.T)exist_okz1Path for option %s is a file, not a directory: %sz+Path for option %s could not be created: %sN)r makedirsFileExistsErrorrrrPermissionError)rr r rrrr PathIsDirCreatedsz"_PathVariableClass.PathIsDirCreatecCs:tj|s6tj|rd}nd}tj|||fdS)z$Validator to check if Path is a filez*File path for option %s is a directory: %sz*File path for option %s does not exist: %sN)r rrrrrr)rr r rrrr PathIsFileqs   z_PathVariableClass.PathIsFilecCs(tj|s$d}tj|||fdS)z!Validator to check if Path existsz%Path for option %s does not exist: %sN)r rexistsrrr)rr r rrrr PathExists{s z_PathVariableClass.PathExistscCsR|dkr|j}tj|s&tj|r8d||df}n d||f}||||dfS)aReturn a tuple describing a path list SCons Variable. The input parameters describe a 'path list' option. Returns a tuple with the correct converter and validator appended. The result is usable for input to :meth:`Add`. The *default* option specifies the default path to use if the user does not specify an override with this option. *validator* is a validator, see this file for examples Nz%s ( /path/to/%s )r)rrZUtilZis_ListZis_Tuple)selfrhelpdefaultZ validatorZhelpmsgrrr __call__s  z_PathVariableClass.__call__)N) __name__ __module__ __qualname__ staticmethodr rrrrrstrrr!rrrr rSs   r) __doc__r os.pathtypingrrZ SCons.Errorsr__all__rrrrrr HsE