B `=@sddlmZddlZddlZddlZddlmZddlmZddeDZ d dd Z defd d Z d d Z ddZ de fddZddZGdddZeZGdddZGdddeZGdddeZeeGdddZeeGdddZdS)!)SOURCE_SUFFIXESN) implementer)IAssetDescriptorcCsg|] }d|qS)z __init__%s).0xrrT/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/pyramid/path.py sr cCs2tj|s.t|d}t|}tj||}|S)N)ospathisabs caller_module package_pathjoin)r levelmoduleprefixrrr caller_path s   rcCs(||j}|dpd}|j|}|S)N__name____main__) _getframe f_globalsgetmodules)rsysmodule_globals module_namerrrrrs  rcCs`|dks|jdkrdS|j}t|dd}|dkr4|Stj|}|dtkrP|S|dddS)zIf this function is passed a module, return the dotted Python package name of the package in which the module lives. If this function is passed a package, return the dotted Python package name of the package itself.Nr__file__.r r)rgetattrr r split init_namesrsplit) pkg_or_modulepkg_nameZ pkg_filenameZsplittedrrr package_names   r(cCst|}t|tj|S)z= Return the package of a module or return the package itself )r( __import__rr)r&r'rrr package_of/sr*cCsH||d}t|dd}d|ks(d|kr,|S|jddd}tj|S)Nr rz __init__.pyz __init__$pyr!r)r"rr%rr)rrrfr(rrrcaller_package6s   r-cCsFt|dd}|dkrBt|jd}y ||_Wntk r@YnX|S)N __abspath__r+)r" pkg_resourcesresource_filenamerr. Exception)packagerrrrrBs  rc@seZdZddZdS)_CALLER_PACKAGEcCsdS)Nzpyramid.path.CALLER_PACKAGEr)selfrrr__repr__Tsz_CALLER_PACKAGE.__repr__N)r __module__ __qualname__r5rrrrr3Ssr3c@s(eZdZefddZddZddZdS)ResolvercCsf|dtfkr||_nNt|trXy t|Wn"tk rLtd|fYnXtj|}t ||_dS)Nz%The dotted name %r cannot be imported) CALLER_PACKAGEr2 isinstancestrr) ImportError ValueErrorrrr*)r4r2rrr__init__\s    zResolver.__init__cCs |jtkrtj}n|jj}|S)N)r2r9r-r)r4r(rrrget_package_namejs  zResolver.get_package_namecCs|jtkrt}n|j}|S)N)r2r9r-)r4r2rrr get_packageqs zResolver.get_packageN)rr6r7r9r>r?r@rrrrr8[s r8c@seZdZdZddZdS) AssetResolveraA class used to resolve an :term:`asset specification` to an :term:`asset descriptor`. .. versionadded:: 1.3 The constructor accepts a single argument named ``package`` which may be any of: - A fully qualified (not relative) dotted name to a module or package - a Python module or package object - The value ``None`` - The constant value :attr:`pyramid.path.CALLER_PACKAGE`. The default value is :attr:`pyramid.path.CALLER_PACKAGE`. The ``package`` is used when a relative asset specification is supplied to the :meth:`~pyramid.path.AssetResolver.resolve` method. An asset specification without a colon in it is treated as relative. If ``package`` is ``None``, the resolver will only be able to resolve fully qualified (not relative) asset specifications. Any attempt to resolve a relative asset specification will result in an :exc:`ValueError` exception. If ``package`` is :attr:`pyramid.path.CALLER_PACKAGE`, the resolver will treat relative asset specifications as relative to the caller of the :meth:`~pyramid.path.AssetResolver.resolve` method. If ``package`` is a *module* or *module name* (as opposed to a package or package name), its containing package is computed and this package is used to derive the package name (all names are resolved relative to packages, never to modules). For example, if the ``package`` argument to this type was passed the string ``xml.dom.expatbuilder``, and ``template.pt`` is supplied to the :meth:`~pyramid.path.AssetResolver.resolve` method, the resulting absolute asset spec would be ``xml.minidom:template.pt``, because ``xml.dom.expatbuilder`` is a module object, not a package object. If ``package`` is a *package* or *package name* (as opposed to a module or module name), this package will be used to compute relative asset specifications. For example, if the ``package`` argument to this type was passed the string ``xml.dom``, and ``template.pt`` is supplied to the :meth:`~pyramid.path.AssetResolver.resolve` method, the resulting absolute asset spec would be ``xml.minidom:template.pt``. cCsttj|rt|S|}d|kr2|dd\}}n8|jtkrFtj}nt |jdd}|dkrjt d|ft ||S)a Resolve the asset spec named as ``spec`` to an object that has the attributes and methods described in :class:`pyramid.interfaces.IAssetDescriptor`. If ``spec`` is an absolute filename (e.g. ``/path/to/myproject/templates/foo.pt``) or an absolute asset spec (e.g. ``myproject:templates.foo.pt``), an asset descriptor is returned without taking into account the ``package`` passed to this class' constructor. If ``spec`` is a *relative* asset specification (an asset specification without a ``:`` in it, e.g. ``templates/foo.pt``), the ``package`` argument of the constructor is used as the package portion of the asset spec. For example: .. code-block:: python a = AssetResolver('myproject') resolver = a.resolve('templates/foo.pt') print(resolver.abspath()) # -> /path/to/myproject/templates/foo.pt If the AssetResolver is constructed without a ``package`` argument of ``None``, and a relative asset specification is passed to ``resolve``, an :exc:`ValueError` exception is raised. :r rNz.relative spec %r irresolveable without package) r r rFSAssetDescriptorr#r2r9r-rr"r=PkgResourcesAssetDescriptor)r4specr r(rrrresolves    zAssetResolver.resolveN)rr6r7__doc__rFrrrrrAys1rAc@s8eZdZdZddZddZddZdd Zd d Zd S) DottedNameResolveraaA class used to resolve a :term:`dotted Python name` to a package or module object. .. versionadded:: 1.3 The constructor accepts a single argument named ``package`` which may be any of: - A fully qualified (not relative) dotted name to a module or package - a Python module or package object - The value ``None`` - The constant value :attr:`pyramid.path.CALLER_PACKAGE`. The default value is :attr:`pyramid.path.CALLER_PACKAGE`. The ``package`` is used when a relative dotted name is supplied to the :meth:`~pyramid.path.DottedNameResolver.resolve` method. A dotted name which has a ``.`` (dot) or ``:`` (colon) as its first character is treated as relative. If ``package`` is ``None``, the resolver will only be able to resolve fully qualified (not relative) names. Any attempt to resolve a relative name will result in an :exc:`ValueError` exception. If ``package`` is :attr:`pyramid.path.CALLER_PACKAGE`, the resolver will treat relative dotted names as relative to the caller of the :meth:`~pyramid.path.DottedNameResolver.resolve` method. If ``package`` is a *module* or *module name* (as opposed to a package or package name), its containing package is computed and this package used to derive the package name (all names are resolved relative to packages, never to modules). For example, if the ``package`` argument to this type was passed the string ``xml.dom.expatbuilder``, and ``.mindom`` is supplied to the :meth:`~pyramid.path.DottedNameResolver.resolve` method, the resulting import would be for ``xml.minidom``, because ``xml.dom.expatbuilder`` is a module object, not a package object. If ``package`` is a *package* or *package name* (as opposed to a module or module name), this package will be used to relative compute dotted names. For example, if the ``package`` argument to this type was passed the string ``xml.dom``, and ``.minidom`` is supplied to the :meth:`~pyramid.path.DottedNameResolver.resolve` method, the resulting import would be for ``xml.minidom``. cCs8t|tstd|f|j}|tkr,t}|||S)a This method resolves a dotted name reference to a global Python object (an object which can be imported) to the object itself. Two dotted name styles are supported: - ``pkg_resources``-style dotted names where non-module attributes of a package are separated from the rest of the path using a ``:`` e.g. ``package.module:attr``. - ``zope.dottedname``-style dotted names where non-module attributes of a package are separated from the rest of the path using a ``.`` e.g. ``package.module.attr``. These styles can be used interchangeably. If the supplied name contains a ``:`` (colon), the ``pkg_resources`` resolution mechanism will be chosen, otherwise the ``zope.dottedname`` resolution mechanism will be chosen. If the ``dotted`` argument passed to this method is not a string, a :exc:`ValueError` will be raised. When a dotted name cannot be resolved, a :exc:`ValueError` error is raised. Example: .. code-block:: python r = DottedNameResolver() v = r.resolve('xml') # v is the xml module z%r is not a string)r:r;r=r2r9r-_resolve)r4dottedr2rrrrF s " zDottedNameResolver.resolvecCs.t|tr*|j}|tkrt}|||S|S)a This method behaves just like :meth:`~pyramid.path.DottedNameResolver.resolve`, except if the ``dotted`` value passed is not a string, it is simply returned. For example: .. code-block:: python import xml r = DottedNameResolver() v = r.maybe_resolve(xml) # v is the xml module; no exception raised )r:r;r2r9r-rI)r4rJr2rrr maybe_resolve5s   z DottedNameResolver.maybe_resolvecCs$d|kr|||S|||SdS)NrB)_pkg_resources_style_zope_dottedname_style)r4rJr2rrrrIJs zDottedNameResolver._resolvecCsf|dr6|std|f|dkr,|j}n |j|}tjd|}t|drX|S|dSdS)z package.module:attr style )r!rBz.relative name %r irresolveable without packagezx=%srFFN) startswithr=rr/ EntryPointparsehasattrrFload)r4valuer2eprrrrLPs    z'DottedNameResolver._pkg_resources_stylec Cst|dd}|sd}|dkr>|dkr2td|f|d}nd|d}|ds|dkrftd|f|d}|dx|ds||dq|W||}|d}t|}xN|D]F}|d|7}yt||}Wqtk rt|t||}YqXqW|S)z package.module.attr style rNr!z.relative name %r irresolveable without packager)r"r=r#popr)AttributeError)r4rSr2rnameusedfoundnrrrrMds<           z)DottedNameResolver._zope_dottedname_styleN) rr6r7rGrFrKrIrLrMrrrrrHs 1)rHc@sHeZdZeZddZddZddZddZd d Zd d Z d dZ dS)rDcCs||_||_dS)N)r'r )r4r'r rrrr>sz$PkgResourcesAssetDescriptor.__init__cCsd|j|jfS)Nz%s:%s)r'r )r4rrrabsspecsz#PkgResourcesAssetDescriptor.absspeccCstj|j|j|jS)N)r r abspathr/r0r')r4rrrr\sz#PkgResourcesAssetDescriptor.abspathcCs|j|j|jS)N)r/resource_streamr'r )r4rrrstreamsz"PkgResourcesAssetDescriptor.streamcCs|j|j|jS)N)r/resource_isdirr'r )r4rrrisdirsz!PkgResourcesAssetDescriptor.isdircCs|j|j|jS)N)r/resource_listdirr'r )r4rrrlistdirsz#PkgResourcesAssetDescriptor.listdircCs|j|j|jS)N)r/resource_existsr'r )r4rrrexistssz"PkgResourcesAssetDescriptor.existsN) rr6r7r/r>r[r\r^r`rbrdrrrrrDsrDc@sDeZdZddZddZddZddZd d Zd d Zd dZ dS)rCcCstj||_dS)N)r r r\)r4r rrrr>szFSAssetDescriptor.__init__cCstdS)N)NotImplementedError)r4rrrr[szFSAssetDescriptor.absspeccCs|jS)N)r )r4rrrr\szFSAssetDescriptor.abspathcCs t|jdS)Nrb)openr )r4rrrr^szFSAssetDescriptor.streamcCstj|jS)N)r r r`)r4rrrr`szFSAssetDescriptor.isdircCs t|jS)N)r rbr )r4rrrrbszFSAssetDescriptor.listdircCstj|jS)N)r r rd)r4rrrrdszFSAssetDescriptor.existsN) rr6r7r>r[r\r^r`rbrdrrrrrCsrC)r )importlib.machineryrr r/rZzope.interfacerZpyramid.interfacesrr$rrr(r*r-rr3r9r8rArHrDrCrrrrs(     `3