o b\ @sdZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z ej dr9d Zd Znd Zd Zzed ejded ejded dhZWn e y]eZYnwejdkreejejdz eejejdWn eyz eejejdWn eyYnwYnwedkrejejdZeez eejejdWn eyYnw[ejdkrzejZWn eyejZYnwddZeedejdkreedeZedkZ e!"ej#d Z$Gddde%Z&ddZ'dd Z(e fd!d"Z)d#d$Z*iZ+d%d&Z,dPd'd(Z-dQd)d*Z.dRd+d,Z/d-d.Z0d/d0Z1dSd1d2Z2dTd3d4Z3dSd5d6Z4dSd7d8Z5dTd9d:Z6dUdd?Z8d@dAZ9dTdBdCZ:dDdEZ;dSdFdGZdLdMZ?dNdOZ@dS)VaVPython 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)get_python_lib)DistutilsPlatformError)spec)utilwin)pypyw)dllZpyd)r)soT) standard_libprefix)r ntZdllsPyPyZlib_pypyposixcCs"dtjdd}tjt||S)Nz python%d.%d)sys version_infoospathjoinr )rZ base_pythonrO/var/www/secure340b-portal/env/lib/python3.10/site-packages/astroid/modutils.py _posix_pathhsrliblZlib64Jythonc@seZdZdZdS) NoSourceFilezaexception raised when we are not able to get a python source file for a precompiled file N)__name__ __module__ __qualname____doc__rrrrr|srcCtjtj|SN)rrnormcaseabspathrrrr_normalize_pathr&cCr!r")rrrealpath expanduserr%rrr_canonicalize_pathr'r*cCsL|stjdkr |S|dr|ddS|S|d\}}}|r$|dS|S)N)rz.pycz $py.class.py)rrendswith partition)filenameZ is_jythonheadZ has_pyclass_rrr_path_from_filenames   r3cCs4|D]}||vr||q||vr||qdS)z`remove files/directories in the black list dirnames/filenames are usually from os.walk N)remove) blacklistdirnames filenamesZnorecursrrr_handle_blacklists  r8cCsBzt|WSty |st|YSt|}t|<|YSw)zabspath with caching)_NORM_PATH_CACHEKeyErrorr&)rresultrrr_cache_normalize_paths   r<cCst|d||S)a"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 .)load_module_from_modpathsplit) dotted_nameruse_sysrrrload_module_from_namesrBc Cs,|rz tjd|WStyYnwg}d}|D]x}||d|}d}t|t|kr8tj|}n|r@tj|}|dur[t||\}} } t ||| | }|r[| |rct |||t |dd} |}| sst |rsq| st|t|krtdd|t|dtj| g}q|S)a<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 r=N__file__zno module in %s)rmodulesrr:appendlengetimp find_module load_moduleclosesetattrgetattrr is_namespace ImportErrorrrdirname) partsrrAmodpathZ prevmodulepartZcurnamemoduleZmp_fileZ mp_filenameZmp_desc_filerrrr>s>      r>cCst||}t|||S)aLoad 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 )modpath_from_filer>)filepathrrA extrapathrSrrrload_module_from_files  rZcCsLg}|D]}||tj||}t|s#td|}|s#dSqdS)z2check there are some __init__.py all along the wayr=FT)rFrrr _has_initrrO)rZmod_pathrSrTZ old_namespacerrrcheck_modpath_has_inits r\cCsd}tj|}tj|}tj||r|}tj|}tj||r*|}|rGtj|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 Isz+_get_relative_base_path..) rrr#r$ startswithr(splitextrGr?sep)r0Z path_to_checkZimportable_pathZ abs_filenameZ real_filename base_pathZrelative_base_pathrrr_get_relative_base_path,s   rdcCstjt|}|dur=ttt||D]'}tj|}|s qt ||}|s(q|||ddr<|| d|Sqtttt jt jD]}t |}|sQqHt ||}|sYqH|||ddrf|SqHt d|dt jf)Nr,r=z"Unable to find module for %s in %sz, )rrr)r3 itertoolschainmapr*r$rdr?rr<rPr)r0rYZ is_package_cbZpath_rZ submodpathrSrrrmodpath_from_file_with_callbackNs2   rhcCs t||tS)aigiven 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 )rhr\)r0rYrrrrWks rWcCst|||jSr")file_info_from_modpathlocation)rSr context_filerrrfile_from_modpathrlcCs|dur tj|}n|}|ddkr1ztdg|dd||WSty0t|||YSw|ddgkrBtjdtjjtj 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_xmlplusrrros.path)namerj module_type) rrrQ_spec_from_modpathrPr ModuleSpecrCrI PY_SOURCE)rSrrkcontextrrrris     ric Cs|drdS|d}|dur$|dtvr$t|dkr t||dSd}d}|ddkr:|dus6Jdg}d}||dkrP|d7}tj|}||dks@t|t|D]1}zt |||d||d WqWty|t dt|dkr{d |d|YSw|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) ror=NrrrDz.explicit relative import, but no context_file?r)rrk) r`r?BUILTIN_MODULESrGrPrrrQrangerlmaxr)r@rkrRrZstartiirrrget_module_parts@         rzFc Csxg}t|D]2\}}}||vrqt||||s$d|vr$d|dd<q|D]}t|r8tj||}||q&q|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)rwalkr8_is_python_filerrrF) Z src_directoryr5Zlist_allfiles directoryr6r7r0srcrrrget_module_filess    rcCsjtjt|}tj|\}}tD]}d||f}tj|r$|Sq|r1|s1tj|r1|St|)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 z%s.%s)rrr$r3raPY_SOURCE_EXTSexistsr)r0Zinclude_no_extbaseZorig_extext source_pathrrrget_source_files  rcCstj|dddtvS)zN rtype: bool return: True if the filename is a python source file rN)rrrar)r0rrris_python_source1srcCs|dd}zt|g}Wn tyYdSw|dur#t| St|}|ttr0dS|dur6t }|D] }|t|rDdSq8dS)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 r=rFNT) r?rlrPrrOr&r`r< EXT_LIB_DIR STD_LIB_DIRS)modnameZstd_pathr0rrrris_standard_module9s$  rcCsltj|s tj|}|tjvrdSzt|dd|g\}}}|r)|WdSt y5YdSw)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` Fr=rT) rrisdirrQrrIrJr?rLrP)r from_filestreamr2rrr is_relativeas    rcCs|sJd}|dur)z t||g}|j}Wnty(t||}|j}Ynwt||}|jtjjkrUzt|j}|j|tjj dWSt yT|j|dYSw|jtjj krb|jddS|jtjj krwt |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)rjtype)rj)r find_specrjrPr ModuleType PY_COMPILEDr_replacertrZ C_BUILTIN PKG_DIRECTORYr[)rSrrurjZ found_specrrrrrs4         rrcCsdD] }||r dSqdS)zkreturn true if the given filename should be considered as a python file .pyc and .pyo are ignored )r-z.soz.pydz.pywTF)r.)r0rrrrr|s  r|cCsDtj|d}tdD]}tj|d|r|d|Sq dS)z\if the given directory has a valid __init__ file, return its path, else return None __init__)ZpycZpyor=N)rrrrr)r~Z mod_or_packrrrrr[s  r[cC|jtjjkSr")rrrZ PY_NAMESPACEZspecobjrrrrOrmrOcCrr")rrrrrrrr is_directoryrmr)NT)Nr)NTN)NNr")F)Ar rIrplatformrredistutils.sysconfigrdistutils.errorsrZinterpreter._importrrr`rZPY_COMPILED_EXTSr exec_prefixrsetrpaddrr real_prefixAttributeErrorbase_exec_prefixpython_implementation_rootrmaxsizerZ IS_JYTHONdictfromkeysbuiltin_module_namesrv Exceptionrr&r*r3r8r9r<rBr>rZr\rdrhrWrlrirzrrrrrrrr|r[rOrrrrrs                            8 "    0 = % ( !#