Server : Apache/2.4.62 (Unix) OpenSSL/1.0.2k-fips System : Linux server1.richineiserver.com 3.10.0-1160.119.1.el7.x86_64 #1 SMP Tue Jun 4 14:43:51 UTC 2024 x86_64 User : fdshops ( 1003) PHP Version : 8.2.21 Disable Function : NONE Directory : /lib64/python2.7/site-packages/zope/interface/ |
�
�/Qc @ s- d Z d Z d d l Z d d l m Z d d l m Z d d l m Z d d l Z d d l Z d d l m
Z
d d l m Z d d l m
Z
d d
l m Z d d l m Z d d l m Z i Z d
Z d Z d e f d � � YZ d e f d � � YZ d � Z e Z d � Z d � Z d � Z d d9 d � � YZ d d: d � � YZ d � Z d � Z d � Z! d e f d � � YZ" e" Z# e j$ � Z% d � Z" e& e" _' d! � Z( d" � Z) d# � Z* d$ e+ f d% � � YZ, e, Z- e, Z. y d d l/ Z/ Wn e0 k
rn Xd d& l/ m. Z. d' e e. f d( � � YZ1 d) � Z2 d* � Z3 d+ � Z4 d, d; d- � � YZ5 d. � Z6 d/ � Z7 d0 � Z8 e8 Z9 d1 � Z: e: Z; d2 e+ f d3 � � YZ< e< Z= d d4 � Z? e � Z@ y d d l/ Z/ Wn e0 k
r�nA Xd d5 l/ m Z d d6 l/ m; Z; d d7 l/ m9 Z9 d d8 l/ m= Z= e= � ZA d S(< s� Implementation of interface declarations
There are three flavors of declarations:
- Declarations are used to simply name declared interfaces.
- ImplementsDeclarations are used to express the interfaces that a
class implements (that instances of the class provides).
Implements specifications support inheriting interfaces.
- ProvidesDeclarations are used to express interfaces directly
provided by objects.
t restructuredtexti����N( t FunctionType( t
MethodType( t
ModuleType( t addClassAdvisor( t InterfaceClass( t SpecificationBase( t
Specification( t CLASS_TYPES( t PYTHON3sI Class advice impossible in Python3. Use the @%s class decorator instead.s\ The %s API is deprecated, and will not work in Python3 Use the @%s class decorator instead.t Declarationc B sS e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e Z
RS( s Interface declarationsc G s t j | t | � � d S( N( R t __init__t _normalizeargs( t selft
interfaces( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR 7 s c C s2 t j | | � y
| ` Wn t k
r- n Xd S( N( R t changedt _v_attrst AttributeError( R
t originally_changed( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR : s
c C s | j | � o | | j � k S( s: Test whether an interface is in the specification
( t extendsR ( R
t interface( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __contains__A s c C s
| j � S( sC Return an iterator for the interfaces in the specification
( R ( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __iter__G s c C s
t | j � S( sC Return an iterator of all included and extended interfaces
( t itert __iro__( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt flattenedL s c C sT t g | j � D]= } g | j � D] } | j | d � r# | ^ q# s | ^ q � S( s/ Remove interfaces from a specification
i ( R
R R ( R
t othert it j( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __sub__Q s c C s� i } g } x: | j � D], } | | k r d | | <| j | � q q Wx: | j � D], } | | k rV d | | <| j | � qV qV Wt | � S( sC Add two specifications or a specification and an interface
i ( R t appendR
( R
R t seent resultR ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __add__[ s
( t __name__t
__module__t __doc__R R R R R R R! t __radd__( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR
4 s
t
Implementsc B s, e Z d Z d Z d Z d � Z d � Z RS( t ?c C s d | j S( Ns <implementedBy %s>( R" ( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __repr__~ s c C s t | j f f S( N( t
implementedByt inherit( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt
__reduce__� s N( ( R" R# t NoneR* t declaredR( R+ ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR& t s
c
C s` y | j j d � } Wnu t k
r� t | d d � } | d k rg t j | � } | d k rc | St S| j t k rz | St t
| f � � SXt | t � r� | S| d k r� t j | � } | d k r� | Sn | d k r| f } t t
| � � } d | _ | `
ns y
| j } Wn5 t k
rLt | � sCt d | � � n d } n Xt g | D] } t | � ^ qW� } | | _ t | d d � p�d d t | d d � p�d | _ ym | | _
t | d � s�t | _ n t | t � r d | j k r t | t | d t | � � � | _ n Wn< t k
r[t | t � sNt d
| � � n | t | <n X| S(
sk Return the interfaces implemented for a class' instances
The value returned is an IDeclaration.
t __implemented__s$ ImplementedBy called for non-factoryR# R' t .R" t __providedBy__t __provides__t __class__s! ImplementedBy called for non-typeN( ( t __dict__t getR t getattrR, t# BuiltinImplementationSpecificationst _emptyR2 R& R
R t
isinstanceR* R. t __bases__t callablet TypeErrorR) R" t hasattrt objectSpecificationDescriptorR0 t DescriptorAwareMetaClassest
ClassProvidest typeR1 ( t clst spect basest c( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt implementedByFallback� s\
% 5 %
c G s/ t | � } d | _ d | _ t | | � d S( s8 Declare the only interfaces implemented by instances of a class
The arguments after the class are one or more interfaces or interface
specifications (``IDeclaration`` objects).
The interfaces given (including the interfaces in the specifications)
replace any previous declarations.
N( ( R) R- R, R* t classImplements( RA R RB ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt classImplementsOnly� s c G s� t | � } | j t t | � � 7_ g } i } x7 | j D], } | | k r= d | | <| j | � q= q= W| j d k r� xI | j j D]8 } t | � } | | k r� d | | <| j | � q� q� Wn t | � | _ d S( sI Declare additional interfaces implemented for instances of a class
The arguments after the class are one or more interfaces or
interface specifications (``IDeclaration`` objects).
The interfaces given (including the interfaces in the specifications)
are added to any interfaces previously declared.
i N( R) R- t tupleR R R* R, R9 ( RA R RB RC R t bRD ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRF � s
c C s* | j d \ } } | ` | | | � | S( Nt __implements_advice_data__( R3 RJ ( RA R RF ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt _implements_advice s
t implementerc B s e Z d Z d � Z d � Z RS( s Declare the interfaces implemented by instances of a class.
This function is called as a class decorator.
The arguments are one or more interfaces or interface
specifications (IDeclaration objects).
The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.
Previous declarations include declarations for base classes
unless implementsOnly was used.
This function is provided for convenience. It provides a more
convenient way to call classImplements. For example::
@implementer(I1)
class C(object):
pass
is equivalent to calling::
classImplements(C, I1)
after the class has been created.
c G s
| | _ d S( N( R ( R
R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR - s c C sf t | t � r# t | | j � | St | j � } y
| | _ Wn t k
ra t d | � � n X| S( Ns Can't declare implements( R8 R> RF R R& R. R R; ( R
t obRB ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __call__0 s
( R" R# R$ R RN ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRL s t implementer_onlyc B s e Z d Z d � Z d � Z RS( sn Declare the only interfaces implemented by instances of a class
This function is called as a class decorator.
The arguments are one or more interfaces or interface
specifications (IDeclaration objects).
Previous declarations including declarations for base classes
are overridden.
This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example::
@implementer_only(I1)
class C(object): pass
is equivalent to calling::
classImplementsOnly(I1)
after the class has been created.
c G s
| | _ d S( N( R ( R
R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR T s c C s< t | t t f � r$ t d � � n t | | j � | Sd S( NsI The implementer_only decorator is not supported for methods or functions.( R8 R R t
ValueErrorRG R ( R
RM ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRN W s ( R" R# R$ R RN ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRO < s c C s� t r t d � � n t j d � } | j } | | j k sH d | k r[ t | d � � n d | k rz t | d � � n | | f | d <t t d d �d S( Ns" Class advice impossible in Python3i R# s* can be used only from a class definition.RJ s- can be used only once in a class definition.t depthi ( R R; t syst _getframet f_localst f_globalsR RK ( t nameR RF t framet locals( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt _implementsc s c G s- t r t t d � � n t d | t � d S( s� Declare interfaces implemented by instances of a class
This function is called in a class definition.
The arguments are one or more interfaces or interface
specifications (IDeclaration objects).
The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.
Previous declarations include declarations for base classes
unless implementsOnly was used.
This function is provided for convenience. It provides a more
convenient way to call classImplements. For example::
implements(I1)
is equivalent to calling::
classImplements(C, I1)
after the class has been created.
RL t
implementsN( R R; t
_ADVICE_ERRORRY RF ( R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRZ w s c G s- t r t t d � � n t d | t � d S( sL Declare the only interfaces implemented by instances of a class
This function is called in a class definition.
The arguments are one or more interfaces or interface
specifications (IDeclaration objects).
Previous declarations including declarations for base classes
are overridden.
This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example::
implementsOnly(I1)
is equivalent to calling::
classImplementsOnly(I1)
after the class has been created.
RO t implementsOnlyN( R R; R[ RY RG ( R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR\ � s t Providesc B s/ e Z d Z d � Z d � Z d Z d � Z RS( s� Implement __provides__, the instance-specific specification
When an object is pickled, we pickle the interfaces that it implements.
c G s: | f | | _ | | _ t j | | t | � f � d S( N( t _Provides__argst _clsR
R R) ( R
RA R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR � s c C s
t | j f S( N( R] R^ ( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR+ � s s zope.interfacec C s/ | d k r | | j k r | St d � � d S( sH Make sure that a class __provides__ doesn't leak to an instance
R1 N( R, R_ R ( R
t instRA ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt __get__� s ( R" R# R$ R R+ Ra ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR] � s
c G s8 t j | � } | d k r4 t | � } | t | <n | S( s� Cache instance declarations
Instance declarations are shared among instances that have the same
declaration. The declarations are cached in a weak value dictionary.
N( t InstanceDeclarationsR4 R, t
ProvidesClass( R RB ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR] � s
c G s� t | d d � } | d k rW t | d d � | k rW t | t � sW t d � � qW n t | � } | d k r~ t | � } n t } x' t D] } t | | � r� t } Pq� q� W| r� t
| | | � | _ n t | | � | _ d S( s@ Declare interfaces declared directly for an object
The arguments after the object are one or more interfaces or interface
specifications (``IDeclaration`` objects).
The interfaces given (including the interfaces in the specifications)
replace interfaces previously declared for the object.
R2 sH Attempt to make an interface declaration on a non-descriptor-aware classN(
R5 R, R8 R> R; R R@ t Falset
issubclasst TrueR? R1 R] ( t objectR RA t issubt damc( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt directlyProvides� s $
c G s t | t | � | � d S( sA Declare interfaces declared directly for an object
The arguments after the object are one or more interfaces or interface
specifications (``IDeclaration`` objects).
The interfaces given (including the interfaces in the specifications) are
added to the interfaces previously declared for the object.
N( Rj t directlyProvidedBy( Rg R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt alsoProvides s c C s9 t | t | � | � | j | � r5 t d � � n d S( s; Removes a directly provided interface from an object.
s- Can only remove directly provided interfaces.N( Rj Rk t
providedByRP ( Rg R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt noLongerProvides s t ClassProvidesBaseFallbackc B s e Z d � Z RS( c C s6 | | j k r& | d k r | S| j St d � � d S( NR1 ( R_ R, RY R ( R
R` RA ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRa s
( R" R# Ra ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRo s ( t ClassProvidesBaseR? c B s) e Z d Z d � Z d � Z e j Z RS( s� Special descriptor for class __provides__
The descriptor caches the implementedBy info, so that
we can get declarations for objects without instance-specific
interfaces a bit quicker.
c G sL | | _ t | � | _ | | f | | _ t j | | t | � f � d S( N( R_ R) RY t _ClassProvides__argsR
R ( R
RA t metaclsR ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR @ s c C s | j | j f S( N( R2 Rq ( R
( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR+ F s ( R" R# R$ R R+ Rp Ra ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR? 9 s c C sB t | d d � } | d k s- t | t � r1 t St | j d � S( sp Return the interfaces directly provided by the given object
The value returned is an ``IDeclaration``.
R1 i����N( R5 R, R8 R& R7 R
R9 ( Rg t provides( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRk L s
c G s� t r t t d � � n t j d � } | j } | | j k sL d | k r[ t d � � n d | k rv t d � � n t | � | d <t t d d �d S(
s� Declare interfaces provided directly by a class
This function is called in a class definition.
The arguments are one or more interfaces or interface specifications
(``IDeclaration`` objects).
The given interfaces (including the interfaces in the specifications)
are used to create the class's direct-object interface specification.
An error will be raised if the module class has an direct interface
specification. In other words, it is an error to call this function more
than once in a class definition.
Note that the given interfaces have nothing to do with the interfaces
implemented by instances of the class.
This function is provided for convenience. It provides a more convenient
way to call directlyProvides for a class. For example::
classProvides(I1)
is equivalent to calling::
directlyProvides(theclass, I1)
after the class has been created.
t provideri R# s7 classProvides can be used only from a class definition.R1 s: classProvides can only be used once in a class definition.RQ i N(
R R; R[ RR RS RT RU R R t _classProvides_advice( R RW RX ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt
classProvides^ s c C s$ | j d } | ` t | | � | S( NR1 ( R3 R1 Rj ( RA R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRu � s
Rt c B s e Z d Z d � Z d � Z RS( s( Class decorator version of classProvidesc G s
| | _ d S( N( R ( R
R ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR � s c C s t | | j � | S( N( Rj R ( R
RM ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRN � s ( R" R# R$ R RN ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRt � s c G sz t j d � } | j } | | j k s3 d | k rB t d � � n d | k r] t d � � n t t t | � � | d <d S( s� Declare interfaces provided by a module
This function is used in a module definition.
The arguments are one or more interfaces or interface specifications
(``IDeclaration`` objects).
The given interfaces (including the interfaces in the specifications) are
used to create the module's direct-object interface specification. An
error will be raised if the module already has an interface specification.
In other words, it is an error to call this function more than once in a
module definition.
This function is provided for convenience. It provides a more convenient
way to call directlyProvides. For example::
moduleImplements(I1)
is equivalent to::
directlyProvides(sys.modules[__name__], I1)
i R" s9 moduleProvides can only be used from a module definition.R1 s< moduleProvides can only be used once in a module definition.N( RR RS RT RU R; R] R R ( R RW RX ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt moduleProvides� s c C s
t | | � S( sf Provide object specifications
These combine information for the object and for it's classes.
( R] ( t directRA ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt ObjectSpecification� s c C s` t | d d � } | d k r4 t | t � r4 | Sn y
| j } Wn t k
rU t SXt | � S( NR1 ( R5 R, R8 R R2 R R7 R) ( RM Rs RA ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt getObjectSpecificationFallback� s
c C s� y
| j } Wn t k
r' t | � SXy | j Wnz t k
r� y
| j } Wn t k
rm t | j � SXy | j j } Wn t k
r� | SX| | k r� t | j � Sn X| S( N( R0 R t getObjectSpecificationR R1 R) R2 ( RM t rt cp( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt providedByFallback� s$
t% ObjectSpecificationDescriptorFallbackc B s e Z d Z d � Z RS( s� Implement the `__providedBy__` attribute
The `__providedBy__` attribute computes the interfaces peovided by
an object.
c C sB | d k r t | � St | d d � } | d k r8 | St | � S( s2 Get an object specification for an object
R1 N( R, R{ R5 R) ( R
R` RA Rs ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyRa s
( R" R# R$ Ra ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR s c C sn | d k r g } n | j } t | j k s< t | j k rL | j | � n x | D] } t | | � qS W| S( s� Normalize declaration arguments
Normalization arguments might contain Declarions, tuples, or single
interfaces.
Anything but individial interfaces or implements specs will be expanded.
N( R, R2 R t __mro__R& R R ( t sequencet outputRA t v( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyR 0 s
( R) ( Rm ( R{ ( t ObjectSpecificationDescriptor( ( ( (B R$ t
__docformat__RR t typesR R R t warningst weakreft zope.interface.adviceR t zope.interface.interfaceR R R t zope.interface._compatR R> R R6 R[ t _ADVICE_WARNINGR
R& RE R) RG RF RK RL RO RY RZ R\ R] Rc t WeakValueDictionaryRb Rf t __safe_for_unpickling__Rj Rl Rn Rg Ro t ClassProvidesBasePyRp t _zope_interface_coptimizationst ImportErrorR? Rk Rv Ru Rt Rw Ry Rz R{ R~ Rm R R� R, R R7 R= ( ( ( sA /usr/lib64/python2.7/site-packages/zope/interface/declarations.pyt <module> s� @ W ,'
$
2
, 1