ó î%![c@s dZddlZddlZddlZddlZddlmZddlmZddl Z ddl m Z ddl m Z ejj dƒr£d5Zd6Zn d7Zd8ZyFeededejƒededejƒedeƒgƒZWnek reƒZnXejdkr±ejejjejdƒƒy#ejejjejdƒƒWq±ek r­y#ejejjejdƒƒWq®ek r©q®Xq±Xnejƒdkr%ejjejdƒZejeƒy#ejejjejdƒƒWnek rnX[nejdkr¢y ejZWnek r]ejZnXd„Zejedƒƒejd9kr¢ejedƒƒq¢neƒZ ejƒdkZ!e"j#ej$eƒZ%de&fd„ƒYZ'd„Z(d„Z)e!d„Z*d „Z+iZ,d!„Z-ded"„Z/ddd#„Z0dedd$„Z1d%„Z2ddd&„Z3dd'„Z4ddd(„Z5ddd)„Z6dd*„Z7e8d+„Z9e8d,„Z:d-„Z;dd.„Z<d/„Z=ddd0„Z>d1„Z?d2„Z@d3„ZAd4„ZBdS(:sVPython modules manipulation utility functions. :type PY_SOURCE_EXTS: tuple(str) :var PY_SOURCE_EXTS: list of possible python source file extension :type STD_LIB_DIRS: set of str :var STD_LIB_DIRS: directories where standard modules are located :type BUILTIN_MODULES: dict :var BUILTIN_MODULES: dictionary with builtin module names has key iÿÿÿÿN(tget_python_lib(tDistutilsPlatformErrori(tspec(tutiltwintpytpywtdlltpydtsot standard_libtprefixtnttdllstPyPytlib_pypytposixcCs'dtjd }tjjt||ƒS(Ns python%d.%di(tsyst version_infotostpathtjoinR (Rt base_python((s/lib/python2.7/site-packages/astroid/modutils.pyt _posix_path^stlibii tlib64tJythont NoSourceFilecBseZdZRS(saexception raised when we are not able to get a python source file for a precompiled file (t__name__t __module__t__doc__(((s/lib/python2.7/site-packages/astroid/modutils.pyRrscCstjjtjj|ƒƒS(N(RRtnormcasetabspath(R((s/lib/python2.7/site-packages/astroid/modutils.pyt_normalize_pathwscCstjjtjj|ƒƒS(N(RRtrealpatht expanduser(R((s/lib/python2.7/site-packages/astroid/modutils.pyt_canonicalize_path{scCsa|s7tjdkr|S|jdƒr0|d S|Sn|jdƒ\}}}|r]|dS|S(Niis.pyciÿÿÿÿs $py.classs.py(ii(RRtendswitht partition(tfilenamet is_jythontheadt has_pyclasst_((s/lib/python2.7/site-packages/astroid/modutils.pyt_path_from_filenamescCsMxF|D]>}||kr)|j|ƒq||kr|j|ƒqqWdS(s`remove files/directories in the black list dirnames/filenames are usually from os.walk N(tremove(t blacklisttdirnamest filenamestnorecurs((s/lib/python2.7/site-packages/astroid/modutils.pyt_handle_blacklists    cCsIy t|SWn6tk rD|s,t|ƒSt|ƒ}t|<|SXdS(sabspath with cachingN(t_NORM_PATH_CACHEtKeyErrorR!(Rtresult((s/lib/python2.7/site-packages/astroid/modutils.pyt_cache_normalize_path›s   cCst|jdƒ||ƒS(s"Load a Python module from its name. :type dotted_name: str :param dotted_name: python name of a module or package :type path: list or None :param path: optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :type use_sys: bool :param use_sys: boolean indicating whether the sys.modules dictionary should be used or not :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module t.(tload_module_from_modpathtsplit(t dotted_nameRtuse_sys((s/lib/python2.7/site-packages/astroid/modutils.pytload_module_from_name¨sc Cs¼|r5ytjdj|ƒSWq5tk r1q5Xng}d}xt|D]l}|j|ƒdj|ƒ}d}t|ƒt|ƒkrtjj|ƒ}n|r¸tjj|ƒ}n|dkr tj ||ƒ\}} } tj ||| | ƒ}|r |j ƒq n|r&t |||ƒnt |ddƒ} |}| rZtj|ƒrZqHn| rŸt|ƒt|ƒkrŸtddj|t|ƒƒƒ‚ntjj| ƒg}qHW|S(s<Load a python module from its split name. :type parts: list(str) or tuple(str) :param parts: python name of a module or package split on '.' :type path: list or None :param path: optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :type use_sys: bool :param use_sys: boolean indicating whether the sys.modules dictionary should be used or not :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module R7t__file__tsno module in %sN(RtmodulesRR4tNonetappendtlentgettimpt find_modulet load_moduletclosetsetattrtgetattrRt is_namespacet ImportErrorRRtdirname( tpartsRR;tmodpatht prevmoduletparttcurnametmoduletmp_filet mp_filenametmp_desct_file((s/lib/python2.7/site-packages/astroid/modutils.pyR8Ás<    &cCst||ƒ}t|||ƒS(sLoad a Python module from it's path. :type filepath: str :param filepath: path to the python module or package :type path: list or None :param path: optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :type use_sys: bool :param use_sys: boolean indicating whether the sys.modules dictionary should be used or not :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module (tmodpath_from_fileR8(tfilepathRR;t extrapathRN((s/lib/python2.7/site-packages/astroid/modutils.pytload_module_from_fileùscCsng}xa|D]Y}|j|ƒtjj||ƒ}t|ƒs tjdj|ƒƒ}|sftSq q WtS(s2check there are some __init__.py all along the wayR7( RARRRt _has_initRRJtFalsetTrue(Rtmod_pathRNRPt old_namespace((s/lib/python2.7/site-packages/astroid/modutils.pytcheck_modpath_has_inits    c CsÚt|ƒ}tjjtjj|ƒƒ}tjj|ƒd}|dk rxÆtjj t |ƒD]¬}tjj |ƒ}|rbtjj |t |ƒ ƒtjj |ƒkrbg|t |ƒjtjƒD]}|rË|^qË}|||d ƒr||jdƒ|SqbqbWnxœtjj t tjƒD]‚}t|ƒ}|r.tjj |ƒj|ƒr.g|t |ƒjtjƒD]}|r~|^q~}|||d ƒr°|Sq.q.Wtd|djtjƒfƒ‚dS(NiiÿÿÿÿR7s"Unable to find module for %s in %ss, (R,RRR"R#tsplitextR@tsixtmovestmapR$R RRBR9tsepRR6t startswithRKR( R'RYt is_package_cbtbasetpath_Rtpkgt submodpathRN((s/lib/python2.7/site-packages/astroid/modutils.pytmodpath_from_file_with_callback s&  4# !5 cCst||tƒS(sigiven a file path return the corresponding split module's name (i.e name of a module or package split on '.') :type filename: str :param filename: file's path for which we want the module's name :type extrapath: dict :param extrapath: optional extra search path, with path as key and package name for the path as value. This is usually useful to handle package split in multiple directories using __path__ trick. :raise ImportError: if the corresponding module's name has not been found :rtype: list(str) :return: the corresponding split module's name (RlR`(R'RY((s/lib/python2.7/site-packages/astroid/modutils.pyRW:scCst|||ƒjS(N(tfile_info_from_modpathtlocation(RNRt context_file((s/lib/python2.7/site-packages/astroid/modutils.pytfile_from_modpathQscCsÁ|d k r!tjj|ƒ}n|}|ddkrzytdg|d||ƒSWq±tk rvt|||ƒSXn7|ddgkr±tjddd tjjd t j ƒSt|||ƒS( sÿgiven a mod path (i.e. split module / package name), return the corresponding file, giving priority to source file over precompiled file if it exists :type modpath: list or tuple :param modpath: split module's name (i.e name of a module or package split on '.') (this means explicit relative imports that start with dots have empty strings in this list!) :type path: list or None :param path: optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :type context_file: str or None :param context_file: context file to consider, necessary if the identifier has been introduced using a relative import unresolvable in the actual context (i.e. modutils) :raise ImportError: if there is no such module in the directory :rtype: (str or None, import type) :return: the path to the module's file or None if it's an integrated builtin module such as 'sys' itxmlt_xmlplusiRRtnamesos.pathRnt module_typeN( R@RRRLt_spec_from_modpathRKRt ModuleSpecR=RDt PY_SOURCE(RNRRotcontext((s/lib/python2.7/site-packages/astroid/modutils.pyRmTs  %cCsp|jdƒrdS|jdƒ}|d k rj|dtkrjt|ƒdkr_t|ƒ‚n|dSnd }d}|ddkr­|d k sžtdƒ‚g}d}nx0||dkrß|d7}tjj |ƒ}q°Wx‰t |t|ƒƒD]r}y%t |||d!d|d |ƒWqötk rg|t dt|ƒdƒkrV‚ndj || ƒSXqöW|S( sgiven a dotted name return the module part of the name : >>> get_module_part('astroid.as_string.dump') 'astroid.as_string' :type dotted_name: str :param dotted_name: full name of the identifier we are interested in :type context_file: str or None :param context_file: context file to consider, necessary if the identifier has been introduced using a relative import unresolvable in the actual context (i.e. modutils) :raise ImportError: if there is no such module in the directory :rtype: str or None :return: the module part of the name or None if we have not been able at all to import the given name XXX: deprecated, since it doesn't handle package precedence over module (see #10066) sos.pathR7iiR>s.explicit relative import, but no context_file?iRRoN(RfR9R@tBUILTIN_MODULESRBRKtAssertionErrorRRRLtrangeRptmaxR(R:RoRMRtstartiti((s/lib/python2.7/site-packages/astroid/modutils.pytget_module_part‚s6       c Cs±g}x¤tj|ƒD]“\}}}||kr7qnt|||ƒ| rgd|krgd|(qnx?|D]7}t|ƒrntjj||ƒ}|j|ƒqnqnWqW|S(sNgiven a package directory return a list of all available python module's files in the package and its subpackages :type src_directory: str :param src_directory: path of the directory corresponding to the package :type blacklist: list or tuple :param blacklist: iterable list of files or directories to ignore. :type list_all: bool :param list_all: get files from all paths, including ones without __init__.py :rtype: list :return: the list of all available python module's files in the package and its subpackages s __init__.py((RtwalkR2t_is_python_fileRRRA( t src_directoryR.tlist_alltfilest directoryR/R0R'tsrc((s/lib/python2.7/site-packages/astroid/modutils.pytget_module_files½s   cCsštjjt|ƒƒ}tjj|ƒ\}}x4tD],}d||f}tjj|ƒr7|Sq7W|rŠ| rŠtjj|ƒrŠ|St|ƒ‚dS(sœgiven a python module's file name return the matching source file name (the filename will be returned identically if it's a already an absolute path to a python source file...) :type filename: str :param filename: python module's file name :raise NoSourceFile: if no source file exists on the file system :rtype: str :return: the absolute path of the source file if it exists s%s.%sN(RRR R,RatPY_SOURCE_EXTStexistsR(R'tinclude_no_extRhtorig_exttextt source_path((s/lib/python2.7/site-packages/astroid/modutils.pytget_source_fileâs cCstjj|ƒddtkS(sN rtype: bool return: True if the filename is a python source file i(RRRaRˆ(R'((s/lib/python2.7/site-packages/astroid/modutils.pytis_python_sourceûscCs½|jdƒd}yt|gƒ}Wntk r:tSX|dkrUtj|ƒ St|ƒ}|jt t ƒƒrztS|dkrt }nx'|D]}|jt |ƒƒr–t Sq–WtS(sÐtry to guess if a module is a standard python module (by default, see `std_path` parameter's description) :type modname: str :param modname: name of the module we are interested in :type std_path: list(str) or tuple(str) :param std_path: list of path considered has standard :rtype: bool :return: true if the module: - is located on the path listed in one of the directory in `std_path` - is a built-in module R7iN( R9RpRKR\R@RRJR!RfR6t EXT_LIB_DIRt STD_LIB_DIRSR](tmodnametstd_pathR'R((s/lib/python2.7/site-packages/astroid/modutils.pytis_standard_modules       cCs™tjj|ƒs'tjj|ƒ}n|tjkr:tSyFtj|jdƒd|gƒ\}}}|r{|j ƒnt SWnt k r”tSXdS(svreturn true if the given module name is relative to the given file name :type modname: str :param modname: name of the module we are interested in :type from_file: str :param from_file: path of the module from which modname has been imported :rtype: bool :return: true if the module has been imported relatively to `from_file` R7iN( RRtisdirRLRR\RDRER9RGR]RK(R’t from_filetstreamR+((s/lib/python2.7/site-packages/astroid/modutils.pyt is_relative,s+  cCsU|s t‚d}|dk rry"tj||gƒ}|j}Wq„tk rntj||ƒ}|j}q„Xntj||ƒ}|jtjjkrìy/t |jƒ}|j d|dtjj ƒSWqQt k rè|j d|ƒSXne|jtjj kr|j ddƒS|jtjjkrQt|jƒ}|j d|dtjj ƒS|S(sÃgiven a mod path (i.e. split module / package name), return the corresponding spec this function is used internally, see `file_from_modpath`'s documentation for more information RnttypeN(RzR@Rt find_specRnRKR™t ModuleTypet PY_COMPILEDRŽt_replaceRwRt C_BUILTINt PKG_DIRECTORYR[(RNRRxRnt found_spec((s/lib/python2.7/site-packages/astroid/modutils.pyRuLs,      cCs(x!dD]}|j|ƒrtSqWtS(skreturn true if the given filename should be considered as a python file .pyc and .pyo are ignored s.pys.sos.pyds.pyw(s.pys.sos.pyds.pyw(R%R]R\(R'RŒ((s/lib/python2.7/site-packages/astroid/modutils.pyRms cCsTtjj|dƒ}x8tdD],}tjj|d|ƒr |d|Sq WdS(s\if the given directory has a valid __init__ file, return its path, else return None t__init__tpyctpyoR7(R¢R£N(RRRRˆR‰R@(R…t mod_or_packRŒ((s/lib/python2.7/site-packages/astroid/modutils.pyR[xs cCs|jtjjkS(N(R™RR›t PY_NAMESPACE(tspecobj((s/lib/python2.7/site-packages/astroid/modutils.pyRJƒscCs|jtjjkS(N(R™RR›RŸ(R¦((s/lib/python2.7/site-packages/astroid/modutils.pyt is_directory†s(RR(RR(R(R I(CRRDRtplatformRtdistutils.sysconfigRtdistutils.errorsRRbtinterpreter._importRRRfRˆtPY_COMPILED_EXTStsetR]R t exec_prefixR‘RstaddRRt real_prefixtAttributeErrortbase_exec_prefixtpython_implementationt_rootRtmaxsizeRt IS_JYTHONtdicttfromkeystbuiltin_module_namesRyt ExceptionRR!R$R,R2R3R6R@R<R8RZR`RlRWRpRmRR\R‡RŽRR”R˜RuRR[RJR§(((s/lib/python2.7/site-packages/astroid/modutils.pyts˜        # #   #           8  . ; %   ) !