ó ~9­\c @ sŠdZddlmZmZddlZddlmZdZdZ d„Z e ƒree Z e Znddddddidd„Z dS( s4Tools to assist importing optional external modules.i˙˙˙˙(tprint_functiontdivisionN(t StrictVersioncC sHddl}|jddƒ}|dkr4t|ƒStd|ƒ‚dS(Ni˙˙˙˙t SYMPY_DEBUGtFalsetTrues&unrecognized value for SYMPY_DEBUG: %s(RR(tostgetenvtevalt RuntimeError(Rt debug_str((s9lib/python2.7/site-packages/sympy/external/importtools.pyt __sympy_debugs    t __version__c C s~tdk rtn |pt}tdk r0tn |p9t}ddl} |rŸtj|krŸ|r˜| jd|dj t t |ƒƒft ddƒndSn|dkrždtj krždSyit||} |jd tƒƒ} x>| D]6} | d krě| jd krět|d| ƒqěqěWWnttk r^|rZ| jd |t ddƒndS|k r} |r™| jd |t| ƒfddƒndSX|rzt| |ƒ}|dk rÎ||Œ}nt|ƒt|ƒkrz|rsddlm}t||ƒr|}n<t|ttfƒrDdj t t |ƒƒ}n t |ƒ}| jd||ft ddƒndSn| S(są Import and return a module if it is installed. If the module is not installed, it returns None. A minimum version for the module can be given as the keyword argument min_module_version. This should be comparable against the module version. By default, module.__version__ is used to get the module version. To override this, set the module_version_attr keyword argument. If the attribute of the module to get the version should be called (e.g., module.version()), then set module_version_attr_call_args to the args such that module.module_version_attr(*module_version_attr_call_args) returns the module's version. If the module version is less than min_module_version using the Python < comparison, None will be returned, even if the module is installed. You can use this to keep from importing an incompatible older version of a module. You can also specify a minimum Python version by using the min_python_version keyword argument. This should be comparable against sys.version_info. If the keyword argument warn_not_installed is set to True, the function will emit a UserWarning when the module is not installed. If the keyword argument warn_old_version is set to True, the function will emit a UserWarning when the library is installed, but cannot be imported because of the min_module_version or min_python_version options. Note that because of the way warnings are handled, a warning will be emitted for each module only once. You can change the default warning behavior by overriding the values of WARN_NOT_INSTALLED and WARN_OLD_VERSION in sympy.external.importtools. By default, WARN_NOT_INSTALLED is False and WARN_OLD_VERSION is True. This function uses __import__() to import the module. To pass additional options to __import__(), use the __import__kwargs keyword argument. For example, to import a submodule A.B, you must pass a nonempty fromlist option to __import__. See the docstring of __import__(). This catches ImportError to determine if the module is not installed. To catch additional errors, pass them as a tuple to the catch keyword argument. Examples ======== >>> from sympy.external import import_module >>> numpy = import_module('numpy') >>> numpy = import_module('numpy', min_python_version=(2, 7), ... warn_old_version=False) >>> numpy = import_module('numpy', min_module_version='1.5', ... warn_old_version=False) # numpy.__version__ is a string >>> # gmpy does not have __version__, but it does have gmpy.version() >>> gmpy = import_module('gmpy', min_module_version='1.14', ... module_version_attr='version', module_version_attr_call_args=(), ... warn_old_version=False) >>> # To import a submodule, you must pass a nonempty fromlist to >>> # __import__(). The values do not matter. >>> p3 = import_module('mpl_toolkits.mplot3d', ... __import__kwargs={'fromlist':['something']}) >>> # matplotlib.pyplot can raise RuntimeError when the display cannot be opened >>> matplotlib = import_module('matplotlib', ... __import__kwargs={'fromlist':['pyplot']}, catch=(RuntimeError,)) i˙˙˙˙Ns:Python version is too old to use %s (%s or newer required)t.t stacklevelitnumpyt__pypy__tfromlistt collectionst matplotlibs%s module is not installeds %s module could not be used (%s)(t string_typess3%s version is too old to use (%s or newer required)(tWARN_OLD_VERSIONtNoneRtWARN_NOT_INSTALLEDRtwarningstsyst version_infotwarntjointmaptstrt UserWarningtbuiltin_module_namest __import__tgetttuplet__name__t ImportErrortreprtgetattrRtcore.compatibilityRt isinstancetlist(tmoduletmin_module_versiontmin_python_versiontwarn_not_installedtwarn_old_versiontmodule_version_attrtmodule_version_attr_call_argst__import__kwargstcatchRtmodt from_listtsubmodtet modversionRtverstr((s9lib/python2.7/site-packages/sympy/external/importtools.pyt import_module s`O             (( t__doc__t __future__RRRtdistutils.versionRRRRR RR:(((s9lib/python2.7/site-packages/sympy/external/importtools.pyts