B a%W @sDdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z mZejdrzdZdZnd Zd Zy(e d ejd e d ejd e d d hZWne k reZYnXejdkrLeejejdyeejejdWnHek rJyeejejdWnek rDYnXYnXedkree d ejd ejejdZeeyeejejdWnek rYnX[ejdkr y ejZWnek rejZYnXddZ ee dej!dkr ee de e d hZ"edkZ#e$%ej&d Z'Gddde(Z)ddZ*ddZ+e#fdd Z,d!d"Z-iZ.d#d$Z/d%d&Z0d'd(Z1e2d)d*d+Z3d,d-Z4d.d/Z5dOd0d1Z6dPd2d3Z7dQd4d5Z8dRd6d7Z9dSd8d9Z:dTd;d<Z;dUd=d>ZdCdDZ?dWdEdFZ@dGdHZAdIdJZBdKdLZCdMdNZDdS)XaVPython 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 N)DistutilsPlatformError)get_python_lib)specutilwin)pypyw)dllZpyd)r)soT) standard_libprefix)r ntZdllsPyPyZlib_pypyposixcCs"dtjdd}tjt||S)Nz python%d.%d)sys version_infoospathjoinr )rZ base_pythonr4/tmp/pip-unpacked-wheel-mm06h1t3/astroid/modutils.py _posix_pathsrliblZlib64Jythonc@seZdZdZdS) NoSourceFilezaexception raised when we are not able to get a python source file for a precompiled file N)__name__ __module__ __qualname____doc__rrrrrsrcCstjtj|S)N)rrnormcaseabspath)rrrr_normalize_pathsr"cCstjtj|S)N)rrrealpath expanduser)rrrr_canonicalize_pathsr%cCs(|s|S|d\}}}|r$|dS|S)Nz $py.classz.py) partition)filenameZ is_jythonheadZ has_pyclass_rrr_path_from_filenames r*cCs8x2|D]*}||kr||q||kr||qWdS)z`remove files/directories in the black list dirnames/filenames are usually from os.walk N)remove) blacklistdirnames filenamesZnorecursrrr_handle_blacklists   r/cCs>yt|Stk r8|s$t|St|}t|<|SXdS)zabspath with cachingN)_NORM_PATH_CACHEKeyErrorr")rresultrrr_cache_normalize_pathsr3cCs*y tj|Stk rYnXt|S)zLoad a Python module from its name. :type dotted_name: str :param dotted_name: python name of a module or package :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module )rmodulesr1 importlib import_module) dotted_namerrrload_module_from_names  r8cCstd|S)aLoad 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 '.' :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module .)r8r)partsrrrload_module_from_modpaths r;)filepathcCst|}t|S)zLoad a Python module from it's path. :type filepath: str :param filepath: path to the python module or package :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module )modpath_from_filer;)r<modpathrrrload_module_from_files r?cCsNg}xD|D]<}||tj||}t|s td|}|s dSq WdS)z2check there are some __init__.py all along the wayr9FT)appendrrr _has_initr is_namespace)rZmod_pathr>partZ old_namespacerrrcheck_modpath_has_inits  rDcCsd}tj|}tj|}tj||r2|}tj|}tj||rT|}|rtj|d}|t|d}dd|tj DSdS)a=Extracts the relative mod path of the file to import from Check if a file is within the passed in path and if so, returns the relative mod path from the one passed in. If the filename is no in path_to_check, returns None Note this function will look for both abs and realpath of the file, this allows to find the relative base path even if the file is a symlink of a file in the passed in path Examples: _get_relative_base_path("/a/b/c/d.py", "/a/b") -> ["c","d"] _get_relative_base_path("/a/b/c/d.py", "/dev") -> None NrcSsg|] }|r|qSrr).0pkgrrr #sz+_get_relative_base_path..) rrr r! startswithr#splitextlensplitsep)r'Z path_to_checkZimportable_pathZ abs_filenameZ real_filename base_pathZrelative_base_pathrrr_get_relative_base_paths   rNcCstjt|}xXt|pgtttjtjD]8}t |}|s@q.t ||}|sPq.|||ddr.|Sq.Wt d |d tjdS)Nz"Unable to find module for {} in {}z, )rrr$r* itertoolschainmapr%rr3rN ImportErrorformatr)r'rZ is_package_cbpathnamer>rrrmodpath_from_file_with_callback(s rVcCs t||tS)a)Get the corresponding split module's name from a filename This function will return the 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 Optional[List[str]] path: Optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :raise ImportError: if the corresponding module's name has not been found :rtype: list(str) :return: the corresponding split module's name )rVrD)r'rrrrr=;sr=cCst|||jS)N)file_info_from_modpathlocation)r>r context_filerrrfile_from_modpathPsrZcCs|dk rtj|}n|}|ddkr`ytdg|dd||Stk r\t|||SXn$|ddgkrtjdtjjtjj d St|||S) agiven 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' NrxmlZ_xmlplusrrzos.path)namerX module_type) rrdirname_spec_from_modpathrSr ModuleSpec__file__ ModuleType PY_SOURCE)r>rrYcontextrrrrWTs   rWc Cs|drdS|d}|dk rH|dtkrHt|dkr@t||dSd}d}|ddkrt|dk sltdg}d}x$||dkr|d7}tj|}qvWxrt |t|D]`}yt |||d||d Wqtk r|t dt|dkrd |d|SXqW|S) agiven 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) zos.pathr9Nrrz.explicit relative import, but no context_file?r\)rrY) rHrKBUILTIN_MODULESrJrSAssertionErrorrrr_rangerZmaxr)r7rYr:rZstartiirrrget_module_parts6      rlFc Csg}xvt|D]h\}}}||kr$qt||||sJd|krJd|dd<qx,|D]$}t|rPtj||}||qPWqW|S)aNgiven 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 z __init__.pyrN)rwalkr/_is_python_filerrr@) Z src_directoryr,Zlist_allfiles directoryr-r.r'srcrrrget_module_filess    rrcCsptjt|}tj|\}}x*tD]"}|d|}tj|r&|Sq&W|rd|sdtj|rd|St|dS)agiven a python module's file name return the matching source file name (the filename will be returned identically if it's 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 r9N)rrr!r*rIPY_SOURCE_EXTSexistsr)r'Zinclude_no_extbaseZorig_extext source_pathrrrget_source_files  rxcCstj|dddtkS)zN rtype: bool return: True if the filename is a python source file r\N)rrrIrs)r'rrris_python_sourcesrycCs|dd}yt|g}Wntk r0dSX|dkrFt| St|}xtD]}|t|rTdSqTW|dkrzt }x|D]}|t|rdSqWdS)atry 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 r9rFNT) rKrZrSrrBr" EXT_LIB_DIRSrHr3 STD_LIB_DIRS)modnameZstd_pathr'rrrris_standard_module s"   r}cCsJtj|stj|}|tjkr&dSttjj |j dddd|gS)avreturn 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` Fr9r\)maxsplitr) rrisdirr_rboolr5 machinery PathFinder find_specrK)r| from_filerrr is_relative2s   rcCs|std}|dk rVyt||g}|j}Wqbtk rRt||}|j}YqbXn t||}|jtjjkryt|j}|j |tjj dSt k r|j |dSXnD|jtjj kr|j ddS|jtjj krt|j}|j |tjj dS|S)zgiven 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 N)rXtype)rX)rhrrrXrSrrc PY_COMPILEDrx_replacerdrZ C_BUILTIN PKG_DIRECTORYrA)r>rrerXZ found_specrrrr`Os.      r`cCs |dS)zkreturn true if the given filename should be considered as a python file .pyc and .pyo are ignored )z.pyz.soz.pydz.pyw)endswith)r'rrrrnrsrncCsDtj|d}x0tdD]$}tj|d|r|d|SqWdS)z\if the given directory has a valid __init__ file, return its path, else return None __init__)ZpycZpyor9N)rrrrsrt)rpZ mod_or_packrvrrrrAzs rAcCs|jtjjkS)N)rrrcZ PY_NAMESPACE)specobjrrrrBsrBcCs|jtjjkS)N)rrrcr)rrrr is_directorysr)NN)N)NN)NN)N)F)F)N)NN)Err5Zimportlib.machineryimportlib.utilrPrplatformrdistutils.errorsrdistutils.sysconfigrZastroid.interpreter._importrrrHrsZPY_COMPILED_EXTSr exec_prefixr{setr]addrr real_prefixAttributeErrorbase_exec_prefixpython_implementation base_prefix_rootrmaxsizerzZ IS_JYTHONdictfromkeysbuiltin_module_namesrg Exceptionrr"r%r*r/r0r3r8r;strr?rDrNrVr=rZrWrlrrrxryr}rr`rnrArBrrrrr%s                  "    2 = %  ) #