File: //lib/python3/dist-packages/zope/component/__pycache__/zcml.cpython-310.pyc
o
,�W�O � @ sJ 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 n e y} dd� Z e Z Z Z Z!eZY nw 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��)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� | �}||i |�� d S �N)�getattrr )�
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��
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 r2 r �provides�object�for_r r1 r
�namer �trusted�locater r r r r3 S sV ���� ���
�r3 c s � fdd�}� d |_ |S )Nc s � D ]}|| �} q| S r# r )�ob�f�� factoriesr r r2 � s
z!_rolledUpFactory.<locals>.factoryr �r2 )rJ r2 r rI r �_rolledUpFactory� s
rL N� Fc C s� |d u rt |�dkrt|d �}|d u rtd��t|�}|d u r@t |�dkr8tt|d ��}t |�dkr8|d }|d u r@td��|dkrPt |�dkrPt|d �}|} t | �dkr]| d }n t | �dk rgtd��t | �dkrwt |�dkrwtd��t| �}|d ur�t |||�}|s�|d us�|r�t
||||�}| j d|||ft d ||||| j
fd
� | j d td|fd
� |r�|D ]}
|
d ur�| j d td|
fd
� q�d S d S ) N� r zJNo for attribute was provided and can't determine what the factory adapts.� Missing 'provides' attributerM zNo factory specified�-Can't use multiple factories and multiple for�adapter�registerAdapter��
discriminator�callabler )�lenr � TypeError�tuple�listr r r rL r r �actionr( �infor ) �_contextr2 rA rC r1 rD rE rF �prJ �ifacer r r rQ � sj
�
������rQ 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* �Handlerz&A callable object that handles events.r6 r7 z5Interfaces or classes that this subscriber depends onr8 r9 r4 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/ r2 r( r rA r rB rC r r1 r rE rF r r r r r_ � sT ����� ��
�r_ c C s2 |d u r|d u r t d��|d urt d��|}n|d ur t d��|d u r't d��|d u r7t|�}|d u r7t d��|d urAt|||�}t|�}|sM|d usM|rTt||||�}|d urg| jd td||t| jfd� n| jd td|||t| jfd� |d ur�| jd t d |fd� |D ]}|d ur�| jd t d |fd� q�d 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.�registerHandlerrS �registerSubscriptionAdapterrM )
rW r r rX r rZ �_handlerr r[ r ) r\ rC r2 r( rA r1 rE rF r^ r r r �
subscriber& sf �
�� ������rd c @ s< e Zd ZdZeed�ed�dd�Zeed�ed�dd�ZdS ) �IUtilityDirectivezRegister a utility.zProvided interfacez"Interface provided by the utility.Fr* r; zTName of the registration. This is used by application code when locating a utility.N) r r! r" r@ r r/ rA r
rD r r r r re d s �
�re c C s� |r|rt d��|d u r*|rtt|��}ntt|��}t|�dkr&|d }nt d��|dkr9|r5t|�}nt|�}|d urDt|||d�}| jd||ftd|||| j ft
|d �d
� | jd t d|fd � d S ) Nz$Can't specify factory and component.rN r rO rM )rA r1 �utility�registerUtilityrK )rT rU r r rS ) rW rY r r rV r r rZ r( r[ �dictr )r\ rA r0 r2 r1 rD r r r rf t s4
�
�rf c @ s@ e Zd ZdZeed�dd�Zeed�dd�Zeed�dd�Z dS ) �IInterfaceDirectivez
Define an interface
r
T�r+ r- zInterface typeFr; N)
r r! r" r@ r r/ � interface�typer
rD r r r r ri � s ��
�ri c C s | j d t|||fd� d S )NrS )rZ r )r\ rk rl rD r r r rk � s
�rk 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
Tr9 r4 r z&The permission needed to use the view.Fr* �Classz2A 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 rB rC r r1 �class_r �allowed_interfacer �allowed_attributesr r r r rm � s@ ��
���
�rm 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 typerj N) r r! r" r@ r
r/ r rD r r
rA rl r r r r rs � s$ ��
�rs c @ s$ e Zd ZdZeed�de� d�ZdS )�IViewDirectivez Register a view for a componentr. F�r+ r- r5 N)r r! r" r@ r r/ r r2 r r r r rt s
�rt c s> |s|r
|s
t d��|d ur&t| |||�} G dd� dt�}
|
|d | �|d< |s,t d��t|�}|� t� �dkr=� d }n%t� �dk rGt d��t� �dkrWt|�dkrWt d ��� fd
d �}� d |_||f }| jd |||ftd
||||| jfd� | jd t d|fd� |d ur�|D ]} | d ur�| jd t d| fd� q�d S d 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# )r2 �checker)�selfr2 rv r r r �__init__ s
z view.<locals>.ProxyView.__init__c W s t | j|� | j�S r# )r r2 rv )rw �objectsr r r �__call__# s z view.<locals>.ProxyView.__call__N)r r! r" r@ rx rz r r r r � ProxyView s r{ ���zNo for interfaces specifiedrN r zNo view factory specifiedrP c s( � d d� D ]}|| �} q� d | |�S )Nr| r )rG �requestrH rI r r r2 7 s
zview.<locals>.factory�viewrR rS rM )
r r rB rX rV r2 rZ r( r[ r ) r\ r2 rl rD rC r1 rq rr rA rv r{ r^ r rI r r~
sd ���
�
������r~ c @ s8 e Zd ZdZeed�de� d�Zeed�de� d�Z dS )�IResourceDirectivezRegister a resourcero Fru z=View attributes that are also allowed if user has permission.N)
r r! r" r@ r r/ r rq r rr r r r r r V s �
�r c
C s� |s|r
|s
t d��|d ur!t| |||�}||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 )r} r2 rv r r r �
proxyResourcex s z resource.<locals>.proxyResource�resourcerR rS rM )r r r2 rZ r( r[ r )
r\ r2 rl rD r1 rq rr rA rv r� r r r r� g s< ���
���
�r� )NNNrM FF)NNNNNFF)NNNNrM )NrM )9r@ � zope.configuration.exceptionsr �zope.configuration.fieldsr r r r r �zope.i18nmessageidr �zope.interfacer
r r � zope.schemar
�zope.component._apir �zope.component._declarationr r �zope.component.interfacer �zope.component._compatr �zope.security.zcmlr � ImportErrorr r r r �security�zope.component.securityr r/ �
ValueErrorr r( r) r3 rL rQ r_ rc rd re rf ri rk rm rs rt r~ r r� r r r r �<module> s|
� E
�AA
�>
�$
3
� L��