3
[P @ s d Z ddlmZ ddlZddlmZ ddlmZ ddlZddlZddl m
Z
ddl m Z dZ
d Zd
Ze Zd d Zd
d ZG dd deZG dd deZeZyddlmZ W n ek
r Y nX e ZG dd deZeZyddlmZ W n ek
r Y nX g Z yddlm Z W n ek
r0 Y nX G dd deZ G dd deee Z e d d d Z G d d d eZ 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 jdj}|jti }|jdg }|j| tS )N
invariants)sys _getframef_locals
setdefault TAGGED_DATAappend_decorator_non_return)callr
Ztagsr
r !/usr/lib64/python3.6/interface.py invariant" s
r c C s$ t jdj}|jti }||| < tS )z;Attaches a tagged value to an interface at definition time.r )r r r
r r r )keyvaluer
Z
tagged_valuesr r r taggedValue* s r c @ sL e Zd ZdZdddZdd Zdd Zd d
Zdd d
Zdd Z dd Z
d S )ElementzI
Default implementation of `zope.interface.interfaces.IElement`.
c C s2 | r |j ddkr |}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 )z* Returns the value associated with 'tag'. )r )r tagr r r getTaggedValueM s zElement.getTaggedValueNc C s | j j||S )z* Returns the value associated with 'tag'. )r get)r r$ defaultr r r queryTaggedValueQ s zElement.queryTaggedValuec C s
| j j S )z Returns a list of all tags. )r keys)r r r r getTaggedValueTagsU s zElement.getTaggedValueTagsc C s || j |< dS )z Associates 'value' with 'key'. N)r )r r$ r r r r setTaggedValueY s zElement.setTaggedValue)r )N) r
__module__ __qualname__r r! r" r# r% r( r* r+ 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 obspecr r r r/ _ s z SpecificationBasePy.providedByc C s t |}| |jkS )zTest whether the specification is implemented by a class or factory.
Raise TypeError if argument is neither a class nor a callable.
)
implementedByr0 )r clsr2 r r r r3 e s z!SpecificationBasePy.implementedByc C s
|| j kS )zCIs the interface the same as or extend the given interface
)r0 )r interfacer r r isOrExtendsm s z SpecificationBasePy.isOrExtendsN)r r, r- r/ r3 r6 __call__r r r r r. ] s r. )SpecificationBasec @ s$ e Zd ZdZefddZdd ZdS )InterfaceBasePyz:Base class that wants to be replaced with a C base :)
c C s\ t |dd}|dk r*| j|}|dk r*|S | j|}|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 alternateconformadapterr r r r7 s
zInterfaceBasePy.__call__c C s6 | j |r|S x"tD ]}|| |}|dk r|S qW dS )z(Adapt an object to the reciever
N)r/
adapter_hooks)r r? hookrA r r r r< s
zInterfaceBasePy.__adapt__N)r r, r- r r= r7 r< r r r r r9 { s r9 )
InterfaceBase)rB c @ s| e Zd ZdZejZejZf fddZdd Zdd Z dd Z
e d
d e
Z d d
Z
dd ZdddZdddZdddZdS )
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.
c C s i | _ tj | _t|| _d S )N)r0 weakrefWeakKeyDictionary
dependentstuple __bases__)r basesr r r r! s
zSpecification.__init__c C s | j j|dd | j |< d S )Nr r )rH r& )r dependentr r r subscribe s zSpecification.subscribec C s@ | j j|dd }|s | j |= n |dkr4|| j |< nt|d S )Nr r )rH r& KeyError)r rL nr r r unsubscribe s
zSpecification.unsubscribec C sJ x| j D ]}|j| qW || jd< x|D ]}|j| q*W | j| d S )NrJ )rJ rP __dict__rM changed)r rK br r r Z
__setBases s
zSpecification.__setBasesc C s | j jdf S )NrJ )rQ r& )r r r r s zSpecification.c C s y| ` W n tk
r Y nX | j}|j t| }yt|krH|jt W n tk
r^ Y nX t|| _ tdd |D | _
x|D ] }f ||< qW x t| j j D ]}|j
| qW dS )z4We, or something we depend on, have changed
c S s g | ]}t |tr|qS r )
isinstanceInterfaceClass).0ancestorr r r
s z)Specification.changed..N)_v_attrsAttributeErrorr0 clearr Interfacer NameErrorrI Z__sro____iro__rH r) rR )r Zoriginally_changedZimpliedZ ancestorsrX rL r r r rR s$
zSpecification.changedc c s@ i }x6| j D ],}x&|j D ]}||krd||< |V qW q W dS )zDReturn an iterator for the interfaces in the specification.
r N)rJ
interfaces)r seenbaser5 r r r r` s zSpecification.interfacesTc C s || j ko| p| |kS )zDoes the specification extend the given interface?
Test whether an interface in the specification extends the
given interface
)r0 )r r5 strictr r r extends s
zSpecification.extendsNc C s t j| |S )N)rF ref)r callbackr r r rF s zSpecification.weakrefc C s| y
| j }W n tk
r( i }| _ Y nX |j|}|dkrhx*| jD ] }|j|}|dk rD|||< P qDW |dkrt|S |S dS )z+Query for an attribute description
N)rZ r[ r& r_ direct)r namer' attrsattrZifacer r r r& s
zSpecification.get)T)N)N)r r, r- r r8 r6 r/ r! rM rP Z_Specification__setBasespropertyrJ rR r` rd rF r& r r r r rE s !
rE c @ s e Zd ZdZf dddfddZdd Zdd Zd d
Zd2d d
Zdd Z d3ddZ
dd Z e Z dd Z
dd Zd4ddZd5ddZd d Zd d Zd d! Zd"d# Zd$d% Zd&d' Zd(d) Zd*d+ Zd,d- Zd.d/ Zd0d1 ZdS )6rV z0Prototype (scarecrow) Interfaces Implementation.Nc C s |d kr i }|d kr^|j d}t|tr0|d= n.ytjdjd }W n ttfk
r\ Y nX || _|j d}|d k rt|t s|d kr|}|d= |d krd}t
j | || |j t
d }|d k rx |j D ]\}} | j|| qW x |D ]}
t|
tstdqW tj | | xt|j D ]~\}} |d
kr8||= q t| t rZ| | _| js|| _n>t| trzt| | |d
||< n | tkr||= n td | q W || _d | j| jf | _d S )Nr, r r r r zExpected base interfaces
__locals__r- __annotations__)rh zConcrete attribute, z%s.%s)rl r- rm ) r& rU strr r f_globalsr[ rN r, Attributer r! popr itemsr+ rV r> rE listr5 r r fromFunctionr InvalidInterface_InterfaceClass__attrsZ__identifier__) r rh rK ri r r, dZ tagged_datar valrb rj r r r r! 5 sV
zInterfaceClass.__init__c c s
| V dS )zDReturn an iterator for the interfaces in the specification.
Nr )r r r r r` y s zInterfaceClass.interfacesc C s | j S )N)rJ )r r r r getBases~ s zInterfaceClass.getBasesc C s | |kp|j | S )zSame interface or extends?)rd )r otherr r r isEqualOrExtendedBy s z"InterfaceClass.isEqualOrExtendedByFc C sF |s| j j S | j j }x$| jD ]}|jtj|j| q W |j S )z4Return the attribute names defined by the interface.)rv r) copyrJ updatedictfromkeysnames)r allrrb r r r r s
zInterfaceClass.namesc C s t | jddS )NT)r )iterr )r r r r __iter__ s zInterfaceClass.__iter__c C sT |s| j j S i }x,| jddd D ]}|jt|j| q$W |j| j |j S )z=Return attribute names and descriptions defined by interface.Nr )rv rr rJ r} r~ namesAndDescriptions)r r r rb r r r r s
z#InterfaceClass.namesAndDescriptionsc C s" | j |}|dk r|S t|dS )z4Return the attribute description for the given name.N)r& rN )r rh r r r r getDescriptionFor s
z InterfaceClass.getDescriptionForc C s | j |d k S )N)r& )r rh r r r __contains__ s zInterfaceClass.__contains__c C s | j j|S )N)rv r& )r rh r r r rg s zInterfaceClass.directc C s | j ||S )N)r& )r rh r' r r r queryDescriptionFor s z"InterfaceClass.queryDescriptionForc C s xZ| j dg D ]J}y || W q tk
rV } z |dkr< n
|j| W Y dd}~X qX qW x>| jD ]4}y|j|| W qd tk
r |dkr Y qdX qdW |rt|dS )z&validate object to defined invariants.r
N)r( r r rJ validateInvariants)r r? errorsr erb r r r r s z!InterfaceClass.validateInvariantsc C sR y| j S tk
rL | j}| j}|r2d||f }d| jj|f }|| _ |S X d S )Nz%s.%sz<%s %s>)Z_v_reprr[ r r, __class__)r rh mr r r r __repr__ s zInterfaceClass.__repr__c C s6 y|| S t k
r0 tj d jd k r, Y nX d S )N )r> r exc_infotb_next)r r@ r r r r; s z InterfaceClass._call_conformc C s | j S )N)r )r r r r
__reduce__ s zInterfaceClass.__reduce__c C sL |dkr dS t | ddt | ddf}t |ddt |ddf}||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 r, r )r: )r rz Zn1Zn2r r r Z__cmp s
zInterfaceClass.__cmpc C s4 | j }d|ksd|kr$tjd dS t| j| jfS )Nr, r z-Hashing uninitialized InterfaceClass instancer )rQ warningswarnhashr r, )r rw r r r __hash__ s
zInterfaceClass.__hash__c C s | j |}|dkS )Nr )_InterfaceClass__cmp)r rz cr r r __eq__ s
zInterfaceClass.__eq__c C s | j |}|dkS )Nr )r )r rz r r r r __ne__ s
zInterfaceClass.__ne__c C s | j |}|dk S )Nr )r )r rz r r r r __lt__ s
zInterfaceClass.__lt__c C s | j |}|dkS )Nr )r )r rz r r r r __le__ s
zInterfaceClass.__le__c C s | j |}|dkS )Nr )r )r rz r r r r __gt__ s
zInterfaceClass.__gt__c C s | j |}|dkS )Nr )r )r rz r r r r __ge__# s
zInterfaceClass.__ge__)F)F)N)N) r r, r- r r! r` ry r{ r r r r __getitem__r rg r r r r; r r r r r r r r r r r r r rV - s4 C
rV r] zzope.interface)r, c @ s e Zd ZdZdZdS )rp zAttribute descriptions
N)r r, r- r r5 r r r r rp * s rp c @ s` e Zd ZdZf ZZd Z ZZdd Z dd Z
dd Z e e e
e Z
d d
Zd d Zd
d ZdS )MethodzMethod interfaces
The idea here is that you have objects that describe methods.
This provides an opportunity for rich meta-data.
Nc C s | j d kri S | j S )N) _optional)r r r r
_get_optionalD s
zMethod._get_optionalc C s
|| _ d S )N)r )r optr r r
_set_optionalH s zMethod._set_optionalc C s
d | _ d S )N)r )r r r r
_del_optionalJ s zMethod._del_optionalc O s t | j| jd S )N)BrokenImplementationr5 r )r argskwr r r r7 N s zMethod.__call__c C s | j | j| j| j| jdS )N)
positionalrequiredoptionalvarargskwargs)r r r r r )r r r r getSignatureInfoQ s
zMethod.getSignatureInfoc C s g }xD| j D ]:}|j| || jj kr |d dt| j| 7 < q W | jr`|jd| j | jrv|jd| j ddj| S )Nr =*z**z(%s)z, r )r r r r) reprr r join)r Zsigvr r r getSignatureStringY s
"zMethod.getSignatureString)r r, r- r r r r r r r r r rk r r7 r r r r r r r 6 s r c C s |p| j }t|| j}t| dd p$f }| j}|j| }|j|d }i } |t| }
|
dk rn||
d }d}
| jt t
||
d | |d | |_ |d |
|_ | |_
|} |jt@ r|| |_| d } nd |_|jt@ r|| |_nd |_||_x$| jj D ]\} }
|j| |
qW |S )N __defaults__r r )r r r r: __code__ co_argcount co_varnameslenr} r~ zipr r r co_flags
CO_VARARGSr CO_VARKEYWORDSr r5 rQ rr r+ )funcr5 imlevelrh methodZdefaultscodeZnar r ZnrZargnor r r r r rt f s6
rt c C s& t | tr| j}n| }t||d|dS )Nr )r rh )rU r __func__rt )methr5 rh 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 rp r r r rV r rE )r r r r r r r r _wire s
r )r3 )r/ )ru )r )Nr N)NN)*r Z
__future__r r typesr r r rF Zzope.interface.exceptionsr Zzope.interface.ror r r r objectr r r r r. r8 Z-zope.interface._zope_interface_coptimizations ImportErrorr= r9 rD rB rE rV r] rp r rt r r r r3 r/ ru r r r r r s^ +" | 0
-