File: //usr/lib/python3/dist-packages/zope/component/__pycache__/zcml.cpython-38.pyc
U
,�W�O � @ s@ d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
dd l m Z dd
l m
Z
dd l mZ dd lmZ dd
lmZ ddlmZmZ ddlmZ ddlmZ zddlmZ W n0 e k
r� dd� Z e Z Z Z Z!eZY n2X ddl"m Z ddl"m Z ddl"m Z ddl"m#Z# e
d�Z$G dd� de%e�Z&dd � Z'G d d � d e �Z(G d d � d e �Z)d!d"� Z*d@d&d'�Z+G d(d)� d)e �Z,e'Z-dAd*d+�Z.G d,d-� d-e(�Z/dBd.d/�Z0G d0d1� d1e �Z1dCd2d3�Z2G d4d5� d5e �Z3G d6d7� d7e �Z4G d8d9� d9e3e4�Z5d#d#d#e fd:d;�Z6G d<d=� d=e(e4�Z7d#d#d#e fd>d?�Z8d#S )Dz.Component Architecture configuration handlers
� ��ConfigurationError)�Bool)�GlobalInterface)� GlobalObject)�PythonIdentifier)�Tokens)�MessageFactory)� Interface)�
implementedBy)�
providedBy)�TextLine)�getSiteManager)� adaptedBy�getName)�provideInterface)�_BLANK)�
Permissionc O s t d��d S )NzTsecurity proxied components are not supported because zope.security is not availabler )�args�kw� r �5/usr/lib/python3/dist-packages/zope/component/zcml.py� _no_security$ s r )�_checker��proxify)�protectedFactory)�securityAdapterFactory�zopec @ s e Zd ZdS )�ComponentConfigurationErrorN)�__name__�
__module__� __qualname__r r r r r 1 s r c O s t t� | �}|||� d S �N)�getattrr )Z
methodNamer �kwargs�methodr r r �handler4 s r' c @ sN e Zd Zeed�ed�dd�Zeed�ed�dd�Zeed�ed�dd�Zd S )
�IBasicComponentInformationzComponent to usez�Python name of the implementation object. This must identify an object in a module using the full dotted name. If specified, the ``factory`` field must be left blank.F��title� description�requiredr z*Permission required to use this component.�Factoryz�Python name of a factory which can create the implementation object. This must identify an object in a module using the full dotted name. If specified, the ``component`` field must be left blank.N) r r! r" r �_� componentr �
permission�factoryr r r r r( 8 s � ��r( c @ s� e Zd ZdZeed�ed�de� d�Zeed�ed�dd �Z eed
�ed �dee
� d �d�Z e ed
�ed�dd �Z
eed�ed�dd �Zeed�ed�ddd�Zeed�ed�ddd�ZdS )�IAdapterDirectivez
Register an adapter
zAdapter factory/factorieszHA list of factories (usually just one) that create the adapter instance.T�r* r+ r, �
value_type� Interface the component provides�IThis attribute specifies the interface the adapter instance must provide.Fr) z Specifications to be adapted�.This should be a list of interfaces or classes�Z
missing_valuer zEThis adapter is only available, if the principal has this permission.�NamezYAdapters can have names.
This attribute allows you to specify the name for this adapter.�TrustedaI Make the adapter a trusted adapter
Trusted adapters have unfettered access to the objects they
adapt. If asked to adapt security-proxied objects, then,
rather than getting an unproxied adapter of security-proxied
objects, you get a security-proxied adapter of unproxied
objects.
�r* r+ r, �default�Locatez�Make the adapter a locatable adapter
Located adapter should be used if a non-public permission
is used.
N)r r! r" �__doc__r r. r r1 r �provides�object�for_r r0 r
�namer �trusted�locater r r r r2 S sT ���� ����r2 c s � fdd�}� d |_ |S )Nc s � D ] }|| �} q| S r# r )�ob�f�� factoriesr r r1 � s
z!_rolledUpFactory.<locals>.factoryr �r1 )rH r1 r rG r �_rolledUpFactory� s
rJ N� Fc C s� |d kr0t |�dkr t|d �}|d kr0td��t|�}|d kr�t |�dkrptt|d ��}t |�dkrp|d }|d kr�td��|dkr�t |�dkr�t|d �}|} t | �dkr�| d }n@t | �dk r�td��n*t | �dkr�t |�dkr�td��nt| �}|d k �rt |||�}|�s&|d k �s&|�r4t
||||�}| j d|||ft d ||||| j
fd
� | j d td|fd
� |�r�|D ]$}
|
d k �rx| j d td|
fd
� �qxd S ) N� r zJNo for attribute was provided and can't determine what the factory adapts.� Missing 'provides' attributerK zNo factory specified�-Can't use multiple factories and multiple for�adapter�registerAdapter��
discriminator�callabler )�lenr � TypeError�tuple�listr r r rJ r r �actionr' �infor ) �_contextr1 r? rA r0 rB rC rD �prH �ifacer r r rO � sl
�
���
�rO c @ s� e Zd ZdZeed�ed�dd�Zeed�ed�dd�Zeed�ed �dd�Z e
ed
�ed �dee � d �d
�Z e
ed�ed�dd�Zeed�ed�ddd�Zeed�ed�ddd�ZdS )�ISubscriberDirectivez
Register a subscriber
zSubscriber factoryz1A factory used to create the subscriber instance.Fr) ZHandlerz&A callable object that handles events.r5 r6 z5Interfaces or classes that this subscriber depends onr7 r8 r3 r zHThis subscriber is only available, if the principal has this permission.r: aX Make the subscriber a trusted subscriber
Trusted subscribers have unfettered access to the objects they
adapt. If asked to adapt security-proxied objects, then,
rather than getting an unproxied subscriber of security-proxied
objects, you get a security-proxied subscriber of unproxied
objects.
r; r= z�Make the subscriber a locatable subscriber
Located subscribers should be used if a non-public permission
is used.
N)r r! r" r> r r. r1 r' r r? r r@ rA r r0 r rC rD r r r r r] � sR ����� ���r] c C s8 |d kr.|d krt d��|d k r(t d��|}n |d k r>t d��|d krNt d��|d krnt|�}|d krnt d��|d k r�t|||�}t|�}|s�|d k s�|r�t||||�}|d k r�| jd td||t| jfd� n | jd td|||t| jfd� |d k �r
| jd t d |fd� |D ]$}|d k �r| jd t d |fd� �qd S )
Nz No factory or handler providedz Cannot use handler with providesz Cannot use handler with factoryz@You must specify a provided interface when registering a factoryzWNo for attribute was provided and can't determine what the factory (or handler) adapts.ZregisterHandlerrQ ZregisterSubscriptionAdapterrK )
rU r r rV r rX �_handlerr rY r ) rZ rA r1 r' r? r0 rC rD r\ r r r �
subscriber& sp � �� ��
�
�r_ c @ s< e Zd ZdZeed�ed�dd�Zeed�ed�dd�ZdS ) �IUtilityDirectivezRegister a utility.zProvided interfacez"Interface provided by the utility.Fr) r9 zTName of the registration. This is used by application code when locating a utility.N) r r! r" r> r r. r? r
rB r r r r r` d s ��r` c C s� |r|rt d��|d krT|r*tt|��}n tt|��}t|�dkrL|d }nt d��|dkrr|rjt|�}nt|�}|d k r�t|||d�}| jd||ftd|||| j ft
|d �d
� | jd t d|fd � d S ) Nz$Can't specify factory and component.rL r rM rK )r? r0 �utilityZregisterUtilityrI )rR rS r r rQ ) rU rW r r rT r r rX r' rY �dictr )rZ r? r/ r1 r0 rB r r r ra t s4
��ra c @ s@ e Zd ZdZeed�dd�Zeed�dd�Zeed�dd�Z dS ) �IInterfaceDirectivez
Define an interface
r
T�r* r, zInterface typeFr9 N)
r r! r" r> r r. � interface�typer
rB r r r r rc � s ���rc c C s | j d t|||fd� d S )NrQ )rX r )rZ re rf rB r r r re � s
�re c @ s� e Zd ZdZeed�ed�dee� d�d�Ze ed�ed�d d
�Z
eed �ed �d d
�Z eed
�ed�d e � d�Z
eed�ed�d e� d�ZdS )�IBasicViewInformationz,This is the basic information for all views.z*Specifications of the objects to be viewedz7This should be a list of interfaces or classes
Tr8 r3 r z&The permission needed to use the view.Fr) ZClassz2A class that provides attributes used by the view.�6Interface that is also allowed if user has permission.a=
By default, 'permission' only applies to viewing the view and
any possible sub views. By specifying this attribute, you can
make the permission also apply to everything described in the
supplied interface.
Multiple interfaces can be provided, separated by
whitespace.zAView attributes that are also allowed if the user has permission.z�
By default, 'permission' only applies to viewing the view and
any possible sub views. By specifying 'allowed_attributes',
you can make the permission also apply to the extra attributes
on the view object.N)r r! r" r> r r. r r@ rA r r0 Zclass_r �allowed_interfacer �allowed_attributesr r r r rg � s> ��
����rg c @ sP e Zd ZdZeed�ed�ded�Zeed�ed�de d�Z
eed �dd
�Z d S ) �IBasicResourceInformationz)
Basic information for resources
zThe name of the resource.z3The name shows up in URLs/paths. For example 'foo'.Tr; z&The interface this component provides.zi
A view can provide an interface. This would be used for
views that support other views.Fz Request typerd N) r r! r" r> r
r. r rB r r
r? rf r r r r rk � s" �� �rk c @ s$ e Zd ZdZeed�de� d�ZdS )�IViewDirectivez Register a view for a componentr- F�r* r, r4 N)r r! r" r> r r. r r1 r r r r rl s �rl c sD |s|r|st d��|d k rLt| |||�} G dd� dt�}
|
|d | �|d< |sXt d��t|�}|� t� �dkrz� d }nNt� �dk r�t d��n8t� �dkr�t|�dkr�t d ��n� fd
d �}� d |_||f }| jd |||ftd
||||| jfd� | jd t d|fd� |d k �r@|D ]$} | d k �r| jd t d| fd� �qd S )NzF'permission' required with 'allowed_interface' or 'allowed_attributes'c @ s e Zd ZdZdd� Zdd� ZdS )zview.<locals>.ProxyViewz#Class to create simple proxy views.c S s || _ || _d S r# )r1 �checker)�selfr1 rn r r r �__init__ s z view.<locals>.ProxyView.__init__c W s t | j|� | j�S r# )r r1 rn )ro Zobjectsr r r �__call__# s z view.<locals>.ProxyView.__call__N)r r! r" r> rp rq r r r r � ProxyView s rr ���zNo for interfaces specifiedrL r zNo view factory specifiedrN c s( � d d� D ] }|| �} q � d | |�S )Nrs r )rE �requestrF rG r r r1 7 s
zview.<locals>.factory�viewrP rQ rK )
r r r@ rV rT r1 rX r' rY r ) rZ r1 rf rB rA r0 ri rj r? rn rr r\ r rG r ru
sh �� �
�
���
�ru c @ s8 e Zd ZdZeed�de� d�Zeed�de� d�Z dS )�IResourceDirectivezRegister a resourcerh Frm z=View attributes that are also allowed if user has permission.N)
r r! r" r> r r. r ri r rj r r r r rv V s ��rv c
C s� |s|r|st d��|d k rBt| |||�}||fdd�} || _| }| jd|||ftd||f||| jfd� | jd td|fd� | jd td|fd� d S )NzDMust use name attribute with allowed_interface or allowed_attributesc S s t || �|�S r# r )rt r1 rn r r r �
proxyResourcex s z resource.<locals>.proxyResource�resourcerP rQ rK )r r r1 rX r' rY r )
rZ r1 rf rB r0 ri rj r? rn rw r r r rx g sF �� �
����rx )NNNrK FF)NNNNNFF)NNNNrK )NrK )9r> Z zope.configuration.exceptionsr Zzope.configuration.fieldsr r r r r Zzope.i18nmessageidr Zzope.interfacer
r r Z zope.schemar
Zzope.component._apir Zzope.component._declarationr r Zzope.component.interfacer Zzope.component._compatr Zzope.security.zcmlr � ImportErrorr r r r ZsecurityZzope.component.securityr r. �
ValueErrorr r' r( r2 rJ rO r] r^ r_ r` ra rc re rg rk rl ru rv rx r r r r �<module> s�
E �
AA �
> �
$
3
�
L � �