File: //proc/thread-self/root/opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyc
�
y_VXc @� s d Z d d l m Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m
Z
d d l Z y d d l Z Wn e
k
r� d Z n Xe � Z e j j d � r� d3 Z d4 Z n d5 Z d6 Z yF e e d e d
e j � e d e d
e j � e d e � g � Z Wn e
k
r4e � Z n Xe j d k r�e j e j j e j d � � y# e j e j j e j d � � Wq�e k
r�q�Xn e j � d k re j j e j d � Z e j e � y# e j e j j e j d � � Wn e k
r
n X[ n e j d k r�y
e j Z Wn e k
rIe j Z n Xd � Z! e j e! d � � e j" d7 k r�e j e! d � � q�n e � Z# e j � d k Z$ e% j& e j' e � Z( d e) f d � � YZ* d � Z+ e$ d � Z, d � Z- i Z. d � Z/ d e d � Z0 d d d! � Z1 d e d d" � Z2 d# � Z3 d d$ � Z4 d d d% � Z5 d d d& � Z6 d d' � Z7 d( � Z8 e9 d) � Z: d* � Z; d d+ � Z< d, � Z= d d d- � Z> d. � Z? y d d l Z Wn e
k
r�d Z n Xd/ � Z@ d d0 � ZA d1 � ZB d2 � ZC d S(8 sV Python 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����( t with_statementN( t get_python_lib( t DistutilsPlatformErrort wint pyt pywt dllt pydt sot standard_libt prefixt ntt dllst PyPyt lib_pypyt posixc C� s' d t j d } t j j t | | � S( Ns python%d.%di ( t syst version_infot ost patht joinR
( R t base_python( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _posix_path^ s t libi i t lib64t Jythont NoSourceFilec B� s e Z d Z RS( sa exception raised when we are not able to get a python
source file for a precompiled file
( t __name__t
__module__t __doc__( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyR r s c C� s t j j t j j | � � S( N( R R t normcaset abspath( R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _normalize_pathw s c C� sa | s7 t j d k r | S| j d � r0 | d S| Sn | j d � \ } } } | r] | d S| S( Ni i s .pyci����s $py.classs .py( i i ( R R t endswitht partition( t filenamet is_jythont headt has_pyclasst _( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _path_from_filename{ s c C� sM xF | D]> } | | k r) | j | � q | | k r | j | � q q Wd S( s` remove files/directories in the black list
dirnames/filenames are usually from os.walk
N( t remove( t blacklistt dirnamest filenamest norecurs( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _handle_blacklist� s
c C� sI y t | SWn6 t k
rD | s, t | � St | � } t | <| SXd S( s abspath with cachingN( t _NORM_PATH_CACHEt KeyErrorR ( R t result( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _cache_normalize_path� s
c C� s t | j d � | | � 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 .( t load_module_from_modpatht split( t dotted_nameR t use_sys( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt load_module_from_name� s i c C� s� | r5 y t j d j | � SWq5 t k
r1 q5 Xn g } d } xq| D]i} | j | � d j | � } d } t | � t | � k r� t j j | � } n | r� t j j | � } n | d k r
t j | | � \ } } }
t j
| | | |
� } | r
| j � q
n | r&t | | | � n t
| d d � } | } | rWt | � rWqH n | r�t | � t | � k r�t d d j | t | � � � � n t j j | � g } qH W| S( sB Load a python module from its splitted name.
:type parts: list(str) or tuple(str)
:param parts:
python name of a module or package splitted 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
R3 t __file__t s no module in %sN( R t modulesR R0 t Nonet appendt lent gett impt find_modulet load_modulet closet setattrt getattrt
_is_namespacet ImportErrorR R t dirname( t partsR R7 t modpatht
prevmodulet partt curnamet modulet mp_filet mp_filenamet mp_desct _file( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyR4 � s<
&c C� s t | | � } t | | | � S( s Load 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
( t modpath_from_fileR4 ( t filepathR R7 t extrapathRJ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt load_module_from_file� s c C� sd g } xW | D]O } | j | � t j j | | � } t d j | � � r
t | � r
t Sq
Wt S( s2 check there are some __init__.py all along the wayR3 ( R= R R R RF t _has_initt Falset True( R t mod_pathRJ RL ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _check_init s
#c C� s� t | � } t j j | � } t j j | � d } | d k r� x� | D]� } t j j | � } | rG t j j | t | � � t j j | � k rG g | t | � j t j � D] } | r� | ^ q� } t
| | d � r� | | j d � | SqG qG Wn x� t j D]� } t | � } | rt j j | � j
| � rg | t | � j t j � D] } | rT| ^ qT} t
| | d � r�| SqqWt d | d j t j � f � � d S( su given a file path return the corresponding splitted module's name
(i.e name of a module or package splitted 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 splitted in multiple
directories using __path__ trick.
:raise ImportError:
if the corresponding module's name has not been found
:rtype: list(str)
:return: the corresponding splitted module's name
i i����R3 s" Unable to find module for %s in %ss ,
N( R( R R R t splitextR< R R> R5 t sepR[ R R2 t
startswithRG R ( R# RU t baset path_R t pkgt
submodpathRJ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRS s&
4# !5 c C� s t | | | � d S( Ni ( t file_info_from_modpath( RJ R t context_file( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt file_from_modpathC s c C� s� | d k r! t j j | � } n | } | d d k rz y t d g | d | | � SWq� t k
rv t | | | � SXn% | d d g k r� t j j t j f St | | | � S( s given a mod path (i.e. splitted 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:
splitted module's name (i.e name of a module or package splitted
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'
i t xmlt _xmlplusi R R N( R< R R RH t _file_from_modpathRG R9 R@ t PY_SOURCE( RJ R Rd t context( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRc F s
c C� sp | j d � r d S| j d � } | d
k rj | d t k rj t | � d k r_ t | � � n | d Sn d
} d } | d d k r� | d
k s� t d � � g } d } n x0 | | d k r� | d 7} t j j | � } q� Wx� t
| t | � � D]r } y% t | | | d !d | d | �Wq� t k
rg| t d t | � d � k sV� n d j
| | � SXq� W| S( s given 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)
s os.pathR3 i i R: s. explicit relative import, but no context_file?i R Rd N( R^ R5 R< t BUILTIN_MODULESR> RG t AssertionErrorR R RH t rangeRe t maxR ( R6 Rd RI R t startit i( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt get_module_partt s6
c C� s� g } x� t j | � D]z \ } } } t | | | � d | k rN d | (q n x? | D]7 } t | � rU t j j | | � } | j | � qU qU Wq W| S( s� given 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.
:rtype: list
:return:
the list of all available python module's files in the package and
its subpackages
s __init__.py( ( R t walkR. t _is_python_fileR R R= ( t
src_directoryR* t filest directoryR+ R, R# t src( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt get_module_files� s
c C� s� t j j t | � � } t j j | � \ } } x4 t D], } d | | f } t j j | � r7 | Sq7 W| r� | r� t j j | � r� | St | � � d S( 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( R R R R( R\ t PY_SOURCE_EXTSt existsR ( R# t include_no_extR_ t orig_extt extt source_path( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt get_source_file� s
c C� s t j j | � d d t k S( sN
rtype: bool
return: True if the filename is a python source file
i ( R R R\ Ry ( R# ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt is_python_source� s c C� s� | j d � d } y t | g � } Wn t k
r: t SX| d k rR t | � St | � } | j t t � � rw t S| d k r� t
} n x' | D] } | j t | � � r� t Sq� Wt S( 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
R3 i N( R5 Re RG RX R< RF R R^ R2 t EXT_LIB_DIRt STD_LIB_DIRSRY ( t modnamet std_pathR# R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt is_standard_module� s
c C� s� t j j | � s' t j j | � } n | t j k r: t SyF t j | j d � d | g � \ } } } | r{ | j � n t
SWn t k
r� t SXd S( sv return 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`
R3 i N( R R t isdirRH R RX R@ RA R5 RC RY RG ( R� t from_filet streamR' ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt is_relative s +
c C� s t | � d k s t � | d k rl y t | | g � \ } } Wq� t k
rh t | | � \ } } q� Xn t | | � \ } } | t j k r� y t | � t j f SWq t k
r� | t j f SXnC | t j
k r� d t j
f S| t j k r t | � } t j } n | | f S( s� given a mod path (i.e. splitted module / package name), return the
corresponding file
this function is used internally, see `file_from_modpath`'s
documentation for more information
i N(
R> Rl R< t _module_fileRG R@ t PY_COMPILEDR Ri R t C_BUILTINt
PKG_DIRECTORYRW ( RJ R Rj t mtypeRP ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRh 8 s$
c C� s� x� t | j � � D]� \ } } | d k r | j | d � r� | j t j j j | � � s� t d d j | d � | | f � � n t t j j
| � t j j t j j j | � | f Sq q Wt d d j | � � � d S( Ni s No module named %s in %s/%sR3 i s No module named %s( t listt itemsR< RA R R R] R RG t PY_ZIPMODULER ( RJ t picRT t importer( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt _search_zipT s #,c C� s t d k o | t j k S( N( t
pkg_resourcesR< t _namespace_packages( R� ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRF f s c C� s� y� t j } | d k r! t j p$ | } xU | D]M } | | k r. y t j | � | | <Wq{ t j k
rw d | | <q{ Xq. q. Wt } Wn t k
r� t } n Xt
| d � r� | d t j k r� t j | j d � } t
| j � } | s� t j d f Sn g } xv| r|| d } y t j | | � \ } }
} Wn+ t k
rc| r]t | | � d S� n� X| rw| j � n | r+|
r+g | D] } t | � ^ q�}
y\ |
j t j j t |
� � � } t | | � \ } } } | | j | � k r�| | f SWn! t k
rn t k
r!n Xt } n | j | j d � � | d } | r| t j k r�t d d j | � d j | � f � � n y: t t j j |
d � d � � } | j d � } Wd QXWn t k
r�|
g } qyXd | k o�d
| k } d | k od | k } | s | rmg t j D]< } t j j! t j j | | � � r(t j j | | � ^ q(} qy|
g } qqW| |
f S(
s� get a module type / file path
:type modpath: list or tuple
:param modpath:
splitted module's name (i.e name of a module or package splitted
on '.'), with leading empty strings for explicit relative import
: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)
:rtype: tuple(int, str)
:return: the module type flag and the file path for a module
i i s No module %s in %sR3 s __init__.pyt rbi Nt pkgutilt extend_pathR� s declare_namespace(__name__)(" R t path_importer_cacheR< R t zipimportt zipimportert ZipImportErrorRY t AttributeErrorRX RF R; t popR� t __path__R@ R� RA RG R� RC R2 t indexR RH R t
ValueErrorR= R� R t opent readt IOErrorR� ( RJ R R� t _patht __patht checkeggsRN t importedR� R� RP RQ t xt fullabspatht pathindext emtypet emp_filenamet zippathR� t dataR� t declare_namespacet p( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyR� k sv
#
!
!
?c C� s( x! d D] } | j | � r t Sq Wt S( sk return 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! RY RX ( R# R} ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRs � s
c C� sT t j j | d � } x8 t d D], } t j j | d | � r | d | Sq Wd S( s\ if the given directory has a valid __init__ file, return its path,
else return None
t __init__t pyct pyoR3 ( R� R� N( R R R Ry Rz R< ( Rv t mod_or_packR} ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyRW � s
( R R ( R R ( R ( R l (D R t
__future__R R@ R t platformR t distutils.sysconfigR t distutils.errorsR R� R� RG R< t objectR� R^ Ry t PY_COMPILED_EXTSt setRY R
t exec_prefixR� t namet addR R t real_prefixR� t python_implementationt _rootR t maxsizeR� t IS_JYTHONt dictt fromkeyst builtin_module_namesRk t ExceptionR R R( R. R/ R2 R8 R4 RV R[ RS Re Rc Rq Rx RX R R� R� R� Rh R� RF R� Rs RW ( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/astroid/modutils.pyt <module> s�
#
#
8 ). ; )
g