HEX

File: //opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyc
�
�d{Tc@s�dZdZddlZddlZddlmZmZmZmZm	Z	m
Z
mZddlm
Z
mZmZmZmZddlmZmZmZddlmZddlmZyddlZWnek
r�dZnXe�Zdd	lm Z m!Z!ej"j#d
�r&d*Z$d+Z%nd,Z$d-Z%yedd�Z&Wnek
r^dZ&nXe�Z'e(e)ej*dge+ej*���Z,de-fd��YZ.defd��YZ/ddd�Z0ddd�Z1dddd�Z2d�Z3dd�Z4ddd�Z5dd�Z6e d�Z7e d�Z8e9d �Z:d!�Z;d"�Z<e&fd#�Z=d$�Z>ddd%�Z?d&�Z@yddlAZAWnek
r�dZAnXdd'�ZBd(�ZCd)�ZDdS(.sKPython modules manipulation utility functions.

:type PY_SOURCE_EXTS: tuple(str)
:var PY_SOURCE_EXTS: list of possible python source file extension

:type STD_LIB_DIR: str
:var STD_LIB_DIR: directory where standard modules are located

:type BUILTIN_MODULES: dict
:var BUILTIN_MODULES: dictionary with builtin module names has key
srestructuredtext eni����N(tsplitexttjointabspathtisdirtdirnametexiststbasename(tfind_moduletload_modulet	C_BUILTINtPY_COMPILEDt
PKG_DIRECTORY(tget_config_vartget_python_libtget_python_version(tDistutilsPlatformError(trange(t
STD_BLACKLISTt_handle_blacklisttwintpytpywtdlltpydtsotstandard_libis//tNoSourceFilecBseZdZRS(saexception raised when we are not able to get a python
    source file for a precompiled file
    (t__name__t
__module__t__doc__(((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyRMst
LazyObjectcBs,eZd�Zd�Zd�Zd�ZRS(cCs||_||_d|_dS(N(tmoduletobjtNonet	_imported(tselfRR ((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt__init__Ss		cCs7|jdkr0tt|j�|j�|_n|jS(N(R"R!tgetattrtload_module_from_nameRR (R#((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt_getobjXscCsDytt|�j|�SWn#tk
r?}t|j�|�SXdS(N(tsuperRt__getattribute__tAttributeErrorR%R'(R#tattrtex((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyR)^scOs|j�||�S(N(R'(R#targstkwargs((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt__call__ds(RRR$R'R)R/(((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyRRs			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(tdotted_nametpathtuse_sys((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyR&hscCs�|r5ytjdj|�SWq5tk
r1q5Xng}d}x9|D]1}|j|�dj|�}d}t|�t|�kr�tjj|�}n|r�tjj|�}n|dkr�t||�\}}	}
t	|||	|
�}n|r
t
|||�nt|dd�}|rdt|�t|�krdtddj|t|����nt
|�g}|}qHW|S(sBLoad 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
    R0t__file__tsno module in %sN(tsystmodulesRtKeyErrorR!tappendtlentgetRRtsetattrR%tImportErrorR(tpartsR4R5tmodpatht
prevmoduletparttcurnameRtmp_filetmp_filenametmp_desct_file((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyR1�s4


&
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_fileR1(tfilepathR4R5t	extrapathRA((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytload_module_from_file�scCs4x-|D]%}t||�}t|�stSqWtS(s2check there are some __init__.py all along the way(Rt	_has_inittFalsetTrue(R4tmod_pathRC((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt_check_init�s

cCshtt|��d}|dk	r�x�|D]�}t|�}|r)|t|� |kr)g|t|�jtj�D]}|rt|^qt}t||d �r�||jd�|Sq)q)Wnx�tj	D]v}t|�}|r�|j
|�r�g|t|�jtj�D]}|r|^q}t||d �r>|Sq�q�Wtd|djtj	�f��dS(sugiven 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
    ii����R0s"Unable to find module for %s in %ss, 
N(
RRR!R<R2tostsepRQR8R4t
startswithR?R(tfilenameRKtbasetpath_R4tpkgt
submodpathRA((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyRI�s"
#5cCs�|dk	rt|�}n|}|ddkrtytdg|d||�SWq�tk
rpt|||�SXn|ddgkr�tjjSt|||�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
    :return:
      the path to the module's file or None if it's an integrated
      builtin module such as 'sys'
    itxmlt_xmlplusiRRR4N(R!Rt_file_from_modpathR?RRR4R6(RAR4tcontext_filetcontext((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytfile_from_modpath�s

cCsj|jd�rdS|jd�}|d
k	rj|dtkrjt|�dkr_t|��n|dSnd
}d}|ddkr�|d
k	s�td��g}d}nx*||dkr�|d7}t|�}q�Wx�t|t|��D]r}y%t	|||d!d|d	|�Wq�tk
ra|t
dt|�d�ksP�ndj|| �SXq�W|S(sgiven a dotted name return the module part of the name :

    >>> get_module_part('logilab.common.modutils.get_module_part')
    'logilab.common.modutils'

    :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.pathR0iiR7s.explicit relative import, but no context_file?iR4R]N(RTR2R!tBUILTIN_MODULESR<R?tAssertionErrorRRR_tmaxR(R3R]R@R4tstartiti((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytget_module_part.s6		

cCsg}x�tj|�D]�\}}}t|||�d|krNd|(qn||kr�|t|�jtjd�}|j||�nxk|D]c}t|�r�|dkr�t||�}	||	t|�d!}
|j|
jtjd��q�q�WqW|S(sSgiven a package directory return a list of all available python
    modules in the package and its subpackages

    :type package: str
    :param package: the python name for the package

    :type src_directory: str
    :param src_directory:
      path of the directory corresponding to the package

    :type blacklist: list or tuple
    :param blacklist:
      optional list of files or directory to ignore, default to
      the value of `logilab.common.STD_BLACKLIST`

    :rtype: list
    :return:
      the list of all available python modules in the package and its
      subpackages
    s__init__.pyR0i����((	RRtwalkRR<treplaceRSR;t_is_python_fileR(tpackaget
src_directoryt	blacklistR9t	directorytdirnamest	filenamestdir_packageRUtsrcR((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytget_modulesis
'cCs�g}x�tj|�D]t\}}}t|||�d|krNd|(qnx9|D]1}t|�rUt||�}|j|�qUqUWqW|S(sgiven 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:
      optional list of files or directory to ignore, default to the value of
      `logilab.common.STD_BLACKLIST`

    :rtype: list
    :return:
      the list of all available python module's files in the package and
      its subpackages
    s__init__.py((RRRfRRhRR;(RjRktfilesRlRmRnRURp((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytget_module_files�s
cCsvtt|��\}}x.tD]&}d||f}t|�r|SqW|rf|rft|�rf|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(RRtPY_SOURCE_EXTSRR(RUtinclude_no_extRVtorig_exttexttsource_path((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytget_source_file�s
cCs�g}xyttjj��D]b\}}t|dd�}|rx;|D]0}|j|�rG|j|�tj|=PqGqGWqqW|S(s5remove submodules of `directories` from `sys.modules`R6N(tlistR8R9titemsR%R!RTR;(tdirectoriestcleanedtmodnameRtmodfileRl((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytcleanup_sys_modules�s"

cCst|�ddtkS(sN
    rtype: bool
    return: True if the filename is a python source file
    i(RRt(RU((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytis_python_source�scCs�|jd�d}yt|g�}Wntk
r<}dSX|dkrMdSt|�}|jt�rldSx'|D]}|jt|��rsdSqsWtS(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
    R0iiN(R2R_R?R!RRTtEXT_LIB_DIRRN(R~tstd_pathRUR,R4((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytis_standard_module�s
cCslt|�st|�}n|tjkr.tSy%t|jd�d|g�tSWntk
rgtSXdS(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`
    R0iN(	RRR8R4RNRR2ROR?(R~t	from_file((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pytis_relatives
cCs�t|�dkst�|dk	rlyt||g�\}}Wq�tk
rht||�\}}q�Xnt||�\}}|tkr�yt|�SWq�tk
r�|SXn+|tkr�dS|t	kr�t
|�}n|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
    iN(R<RaR!t_module_fileR?R
RyRR	RRM(RAR4R^tmtypeRF((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyR\"s"

cCs�x�|j�D]�\}}|dk	r
|j|d�r�|jdj|��sytddj|d�||f��ntt|�ddj|�|fSq
q
Wtddj|���dS(Nit/sNo module named %s in %s/%sR0isNo module named %s(R{R!RRR?tZIPFILER(RAtpicRJtimporter((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt_search_zip=s#+cCs1y�tj}|dkr!tjp$|}xU|D]M}||kr.ytj|�||<Wq{tjk
rwd||<q{Xq.q.Wt}Wntk
r�t	}nXt
dk	r|dt
jkr|dtjkrt
|�dkrtj|jd�}|j}ng}x|r&|d}yt||�\}	}
}Wn+tk
rh|rbt||�d S�n�X|r|
rg|D]}t|�^q|}
yV|
jtt|
���}t||�\}}}||j|�kr�||fSWn!tk
r�ntk
r
nXt	}n|j|jd��|d}|r|tkrttddj|�dj|�f��ny1tt|
d���}|jd�}WdQXWntk
r�|
g}q#Xd	|krd
|krgtjD]*}tt||��r�t||�^q�}q#|
g}qqW||
fS(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
    iiisNo module %s in %sR0s__init__.pyiNtpkgutiltextend_path(R8tpath_importer_cacheR!R4t	zipimporttzipimportertZipImportErrorROR*RNt
pkg_resourcest_namespace_packagesR9R<tpopt__path__RR?R�RtindexRt
ValueErrorR;RRtopentreadtIOErrorR(RAR4R�t_patht__patht	checkeggsRtimportedR~t_RFRGtxtfullabspatht	pathindextemtypetemp_filenametzippathR�tstreamtdatatp((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyR�Lsn	


	




	


-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(tendswithRORN(RURw((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyRh�s
cCsHt|d�}x2tdD]&}t|d|�r|d|SqWdS(s\if the given directory has a valid __init__ file, return its path,
    else return None
    R$tpyctpyoR0(R�R�N(RRtRR!(Rltmod_or_packRw((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyRM�s
(RR(RR(R(R(ERt
__docformat__R8RRtos.pathRRRRRRRtimpRRR	R
Rtdistutils.sysconfigRR
Rtdistutils.errorsRt	six.movesRR�R?R!tobjectR�tlogilab.commonRRtplatformRTRttPY_COMPILED_EXTStSTD_LIB_DIRR�tdicttziptbuiltin_module_namesR<R`t	ExceptionRRR&R1RLRQRIR_ReRqRsRNRyR�R�R�R�R\R�R�R�RhRM(((sH/opt/alt/python27/lib/python2.7/site-packages/logilab/common/modutils.pyt<module>sf4(
		
	3		(/;( 			&		

_