| Server IP : 138.197.176.125 / Your IP : 216.73.217.54 Web Server : Apache/2.4.41 (Ubuntu) System : Linux SuiteCRM-8 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 User : root ( 0) PHP Version : 8.3.19 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /proc/self/root/lib/python3/dist-packages/zope/interface/__pycache__/ |
Upload File : |
U
ؒ�]�S � @ s� d Z ddlmZ ddlZddlmZ ddlmZ ddlZddlZddl m
Z
ddl m Z dZ
d Zd
Ze� Zd d � Zd
d� ZG dd� de�ZG dd� de�ZeZzddlmZ W n ek
r� Y nX e� ZG dd� de�ZeZzddlmZ W n ek
�r Y nX g Z zddlm Z W n ek
�r0 Y nX G dd� de�Z G dd� deee �Z e d d d �Z G d d � d e�Z G d!d"� d"e �Z!d-d#d$�Z"d.d%d&�Z#d'd(� Z$dd)l%m&Z& dd*l%m'Z' dd+l m(Z( dd,l m)Z) dS )/z Interface object implementation
� )�
generatorsN)�
MethodType)� FunctionType)�Invalid)�ro� � Z__interface_tagged_values__c C s2 t �d�j}|�ti �}|�dg �}|�| � tS )N� �
invariants)�sys� _getframe�f_locals�
setdefault� TAGGED_DATA�append�_decorator_non_return)�callr
Ztagsr
� r �:/usr/lib/python3/dist-packages/zope/interface/interface.py� invariant" s
r c C s$ t �d�j}|�ti �}||| < tS )z;Attaches a tagged value to an interface at definition time.r )r r r
r r r )�key�valuer
Z
tagged_valuesr r r � taggedValue* s r c @ sL e Zd ZdZddd�Zdd� Zdd� Zd d
� Zdd d
�Zdd� Z dd� Z
d S )�ElementzI
Default implementation of `zope.interface.interfaces.IElement`.
� c C s0 |s|� d�dkr|}d }|| _|| _i | _d S )N� r )�find�__name__�__doc__�_Element__tagged_values)�selfr r r r r �__init__< s zElement.__init__c C s | j S )z! Returns the name of the object. �r �r r r r �getNameE s zElement.getNamec C s | j S )z+ Returns the documentation for the object. )r r# r r r �getDocI s zElement.getDocc C s
| j | S ��* Returns the value associated with 'tag'. �r )r �tagr r r �getTaggedValueM s zElement.getTaggedValueNc C s | j �||�S r& )r �get)r r) �defaultr r r �queryTaggedValueQ s zElement.queryTaggedValuec C s
| j �� S �z Returns a list of all tags. )r �keysr# r r r �getTaggedValueTagsU s zElement.getTaggedValueTagsc C s || j |< dS )z Associates 'value' with 'key'. Nr( �r r) r r r r �setTaggedValueY s zElement.setTaggedValue)r )N) r �
__module__� __qualname__r r! r$ r% r* r- r0 r2 r r r r r 2 s
r c @ s( e Zd Zdd� Zdd� Zdd� ZeZdS )�SpecificationBasePyc C s t |�}| |jkS )z2Is the interface implemented by an object
)�
providedBy�_implied)r �ob�specr r r r6 _ s z SpecificationBasePy.providedByc C s t |�}| |jkS )z�Test whether the specification is implemented by a class or factory.
Raise TypeError if argument is neither a class nor a callable.
)�
implementedByr7 )r �clsr9 r r r r: e s z!SpecificationBasePy.implementedByc C s
|| j kS )zCIs the interface the same as or extend the given interface
�r7 )r � interfacer r r � isOrExtendsm s z SpecificationBasePy.isOrExtendsN)r r3 r4 r6 r: r> �__call__r r r r r5 ] s r5 )�SpecificationBasec @ s$ e Zd ZdZefdd�Zdd� ZdS )�InterfaceBasePyz:Base class that wants to be replaced with a C base :)
c C s\ t |dd�}|dk r*| �|�}|dk r*|S | �|�}|dk r@|S |tk rL|S td|| ��dS )z)Adapt an object to the interface
Z __conform__NzCould not adapt)�getattr�
_call_conform� __adapt__�_marker� TypeError)r �objZ alternate�conform�adapterr r r r? s
zInterfaceBasePy.__call__c C s6 | � |�r|S tD ] }|| |�}|dk r| S qdS )z(Adapt an object to the reciever
N)r6 �
adapter_hooks)r rG �hookrI r r r rD � s
zInterfaceBasePy.__adapt__N)r r3 r4 r rE r? rD r r r r rA { s rA )�
InterfaceBase)rJ c @ sz e Zd ZdZejZejZddd�Zdd� Zdd� Z d d
� Z
e d d � e
�Z d
d� Z
dd� Zddd�Zddd�Zd dd�ZdS ) �
Specificationaw Specifications
An interface specification is used to track interface declarations
and component registrations.
This class is a base class for both interfaces themselves and for
interface specifications (declarations).
Specifications are mutable. If you reassign their bases, their
relations with other specifications are adjusted accordingly.
r c C s i | _ t�� | _t|�| _d S �N)r7 �weakref�WeakKeyDictionary�
dependents�tuple� __bases__)r �basesr r r r! � s
zSpecification.__init__c C s | j �|d�d | j |< d S �Nr r )rQ r+ )r � dependentr r r � subscribe� s zSpecification.subscribec C s@ | j �|d�d }|s | j |= n |dkr4|| j |< nt|��d S rU )rQ r+ �KeyError)r rV �nr r r � unsubscribe� s
zSpecification.unsubscribec C sB | j D ]}|�| � q|| jd< |D ]}|�| � q$| �| � d S )NrS )rS rZ �__dict__rW �changed)r rT �br r r Z
__setBases� s
zSpecification.__setBasesc C s | j �dd�S )NrS r )r[ r+ r# r r r �<lambda>� � zSpecification.<lambda>c C s� z| ` W n tk
r Y nX | j}|�� t| �}zt|krH|�t� W n tk
r^ Y nX t|�| _ tdd� |D ��| _
|D ] }d||< q�t| j � � �D ]}|�
|� q�dS )z4We, or something we depend on, have changed
c S s g | ]}t |t�r|�qS r )�
isinstance�InterfaceClass)�.0�ancestorr r r �
<listcomp>� s
�z)Specification.changed.<locals>.<listcomp>r N)�_v_attrs�AttributeErrorr7 �clearr � Interfacer � NameErrorrR Z__sro__�__iro__rQ r/ r\ )r Zoriginally_changedZimpliedZ ancestorsrc rV r r r r\ � s$
zSpecification.changedc c s8 i }| j D ](}|�� D ]}||krd||< |V qq
dS )�DReturn an iterator for the interfaces in the specification.
r N)rS �
interfaces)r �seen�baser= r r r rl s
zSpecification.interfacesTc C s || j ko| p| |kS )z�Does the specification extend the given interface?
Test whether an interface in the specification extends the
given interface
r< )r r= �strictr r r �extends s
�zSpecification.extendsNc C s t �| |�S rN )rO �ref)r �callbackr r r rO s zSpecification.weakrefc C sz z
| j }W n tk
r( i }| _ Y nX |�|�}|dkrf| jD ]"}|�|�}|dk rB|||< qfqB|dkrr|S |S dS )z+Query for an attribute description
N)re rf r+ rj �direct)r �namer, �attrs�attrZifacer r r r+ s
zSpecification.get)r )T)N)N)r r3 r4 r r@ r> r6 r! rW rZ Z_Specification__setBases�propertyrS r\ rl rp rO r+ r r r r rM � s
�!
rM c @ s� e Zd ZdZd9dd�Zdd� Zdd � Zd
d � Zd:d
d�Zdd� Z d;dd�Z
dd� Z e Z dd� Z
dd� Zd<dd�Zd=dd �Zd>d d �Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z dS )?ra z0Prototype (scarecrow) Interfaces Implementation.r Nc C s� |d kr i }|d kr^|� d�}t|t�r0|d= n.zt�d�jd }W n ttfk
r\ Y nX || _|� d�}|d k r�t|t �s�|d kr�|}|d= |d kr�d}t
� | ||� |� t
d �}|d k r�|�� D ]\}} | �|| � q�|D ]}
t|
t�s�td��q�t� | |� t|�� �D ]~\}} |dk�r.||= �qt| t ��rP| | _| j�s�|| _n>t| t��rpt| | |d�||< n | tk�r�||= n td | ���q|| _d
| j| jf | _d S ) Nr3 r r r r zExpected base interfaces)Z
__locals__r4 �__annotations__)rt zConcrete attribute, �%s.%s) r+ r` �strr r � f_globalsrf rX r3 � Attributer r! �popr �itemsr2 ra rF rM �listr= r r � fromFunctionr �InvalidInterface�_InterfaceClass__attrsZ__identifier__) r rt rT ru r r3 �dZ tagged_datar �valrn rv r r r r! 5 sV
zInterfaceClass.__init__c c s
| V dS )rk Nr r# r r r rl y s zInterfaceClass.interfacesc C s | j S rN )rS r# r r r �getBases~ s zInterfaceClass.getBasesc C s | |kp|� | �S )zSame interface or extends?)rp )r �otherr r r �isEqualOrExtendedBy� s z"InterfaceClass.isEqualOrExtendedByFc C sB |s| j �� S | j �� }| jD ]}|�t�|�|��� q |�� S )z4Return the attribute names defined by the interface.)r� r/ �copyrS �update�dict�fromkeys�names�r �all�rrn r r r r� � s
zInterfaceClass.namesc C s t | jdd��S )NT)r� )�iterr� r# r r r �__iter__� s zInterfaceClass.__iter__c C sP |s| j �� S i }| jddd� D ]}|�t|�|��� q"|�| j � |�� S )z=Return attribute names and descriptions defined by interface.N���)r� r~ rS r� r� �namesAndDescriptionsr� r r r r� � s
z#InterfaceClass.namesAndDescriptionsc C s" | � |�}|dk r|S t|��dS )z4Return the attribute description for the given name.N)r+ rX )r rt r� r r r �getDescriptionFor� s
z InterfaceClass.getDescriptionForc C s | � |�d k S rN �r+ �r rt r r r � __contains__� s zInterfaceClass.__contains__c C s | j �|�S rN )r� r+ r� r r r rs � s zInterfaceClass.directc C s | � ||�S rN r� )r rt r, r r r �queryDescriptionFor� s z"InterfaceClass.queryDescriptionForc C s� | � dg �D ]J}z ||� W q tk
rT } z|dkr:� n
|�|� W 5 d}~X Y q X q | jD ]4}z|�||� W q^ tk
r� |dkr�� Y q^X q^|r�t|��dS )z&validate object to defined invariants.r
N)r- r r rS �validateInvariants)r rG �errorsr �ern r r r r� � s
z!InterfaceClass.validateInvariantsc C sJ t j| |td�}|tk r |S | jD ]"}|j|td�}|tk r"| S q"|S �r' )r, )r r- rE rS )r r) r, r rn r r r r- � s
z InterfaceClass.queryTaggedValuec C s" | j |td�}|tkr t|��|S r� )r- rE rX r1 r r r r* � s z InterfaceClass.getTaggedValuec C s> t t�| ��}| jD ]$}|�� D ]}||kr |�|� q q|S r. )r r r0 rS r )r r/ rn r r r r r0 � s
z!InterfaceClass.getTaggedValueTagsc C sX z| j W S tk
rR | j}| j}|r4d||f }d| jj|f }|| _ | Y S X d S )Nry z<%s %s>)Z_v_reprrf r r3 � __class__)r rt �mr� r r r �__repr__� s zInterfaceClass.__repr__c C s8 z
|| �W S t k
r2 t�� d jd k r.� Y nX d S )N� )rF r �exc_info�tb_next)r rH r r r rC � s
z InterfaceClass._call_conformc C s | j S rN r" r# r r r �
__reduce__ s zInterfaceClass.__reduce__c C sL |dkr dS t | dd�t | dd�f}t |dd�t |dd�f}||k||k S )a� Make interfaces sortable
TODO: It would ne nice if:
More specific interfaces should sort before less specific ones.
Otherwise, sort on name and module.
But this is too complicated, and we're going to punt on it
for now.
For now, sort on interface and module name.
None is treated as a pseudo interface that implies the loosest
contact possible, no contract. For that reason, all interfaces
sort before None.
Nr� r r r3 )rB )r r� Zn1Zn2r r r Z__cmp s
zInterfaceClass.__cmpc C s4 | j }d|ksd|kr$t�d� dS t| j| jf�S )Nr3 r z-Hashing uninitialized InterfaceClass instancer )r[ �warnings�warn�hashr r3 )r r� r r r �__hash__# s
zInterfaceClass.__hash__c C s | � |�}|dkS �Nr ��_InterfaceClass__cmp�r r� �cr r r �__eq__* s
zInterfaceClass.__eq__c C s | � |�}|dkS r� r� r� r r r �__ne__. s
zInterfaceClass.__ne__c C s | � |�}|dk S r� r� r� r r r �__lt__2 s
zInterfaceClass.__lt__c C s | � |�}|dkS r� r� r� r r r �__le__6 s
zInterfaceClass.__le__c C s | � |�}|dkS r� r� r� r r r �__gt__: s
zInterfaceClass.__gt__c C s | � |�}|dkS r� r� r� r r r �__ge__> s
zInterfaceClass.__ge__)r NNN)F)F)N)N)N) r r3 r4 r r! rl r� r� r� r� r� r� � __getitem__r� rs r� r� r- r* r0 r� rC r� r� r� r� r� r� r� r� r� r r r r ra - s< �
D
ra rh zzope.interface)r3 c @ s e Zd ZdZdZdS )r| zAttribute descriptions
N)r r3 r4 r r= r r r r r| E s r| c @ s` e Zd ZdZd ZZd Z ZZdd� Z dd� Z
dd � Z e e e
e �Z
d
d � Zd d
� Zdd� ZdS )�Methodz�Method interfaces
The idea here is that you have objects that describe methods.
This provides an opportunity for rich meta-data.
r Nc C s | j d kri S | j S rN �� _optionalr# r r r �
_get_optional_ s
zMethod._get_optionalc C s
|| _ d S rN r� )r �optr r r �
_set_optionalc s zMethod._set_optionalc C s
d | _ d S rN r� r# r r r �
_del_optionale s zMethod._del_optionalc O s t | j| j��d S rN )�BrokenImplementationr= r )r �args�kwr r r r? i s zMethod.__call__c C s | j | j| j| j| jd�S )N��
positional�required�optional�varargs�kwargsr� r# r r r �getSignatureInfol s �zMethod.getSignatureInfoc C s� g }| j D ]:}|�|� || j�� kr
|d dt| j| � 7 < q
| jr\|�d| j � | jrr|�d| j � dd�|� S )Nr� �=�*z**z(%s)z, )r� r r� r/ �reprr� r� �join)r Zsig�vr r r �getSignatureStringt s
zMethod.getSignatureString)r r3 r4 r r� r� r� r� r� r� r� r� rw r� r? r� r� r r r r r� Q s r� c C s |p| j }t|| j�}t| dd �p$d}| j}|j| }|j|d � }i } |t|� }
|
dk rn||
d � }d}
| �t t
||
d � |��� |d |� |_ |d |
� |_ | |_
|} |jt@ r�|| |_| d } nd |_|jt@ r�|| |_nd |_||_| j�� D ]\} }
|�| |
� �q |S )N� __defaults__r r r )r r� r rB �__code__� co_argcount� co_varnames�lenr� r� �zipr� r� r� �co_flags�
CO_VARARGSr� �CO_VARKEYWORDSr� r= r[ r~ r2 )�funcr= �imlevelrt �method�defaults�codeZnar� r� ZnrZargnor r r r r r� � s6
r� c C s& t | t�r| j}n| }t||d|d�S )Nr )r� rt )r` r �__func__r� )�methr= rt r� r r r �
fromMethod� s
r� c C sh ddl m} ddlm} | t|� ddlm} | t|� ddlm} | t|� ddlm } | t
|� d S )Nr )�classImplements)�
IAttribute)�IMethod)�
IInterface)�ISpecification) �zope.interface.declarationsr� Zzope.interface.interfacesr� r| r� r� r� ra r� rM )r� r� r� r� r� r r r �_wire� s
r� )r: )r6 )r� )r� )Nr N)NN)*r Z
__future__r r �typesr r r� rO Zzope.interface.exceptionsr Zzope.interface.ror r� r� r �objectr r r r r5 r@ Z-zope.interface._zope_interface_coptimizations� ImportErrorrE rA rL rJ rM ra rh r| r� r� r� r� r� r: r6 r� r� r r r r �<module> s` +" 0
-