3
\" @ sv d Z ddlmZ dd ZG dd deZG dd deZG d d
d
eZ G d d d e
Z G d
d de dZ dd Z
dS )z3Abstract Base Classes (ABCs) according to PEP 3119. )WeakSetc C s
d| _ | S )a A decorator indicating abstract methods.
Requires that the metaclass is ABCMeta or derived from it. A
class that has a metaclass derived from ABCMeta cannot be
instantiated unless all of its abstract methods are overridden.
The abstract methods can be called using any of the normal
'super' call mechanisms.
Usage:
class C(metaclass=ABCMeta):
@abstractmethod
def my_abstract_method(self, ...):
...
T)__isabstractmethod__)funcobj r /usr/lib64/python3.6/abc.pyabstractmethod s r c s$ e Zd ZdZdZ fddZ ZS )abstractclassmethodaO
A decorator indicating abstract classmethods.
Similar to abstractmethod.
Usage:
class C(metaclass=ABCMeta):
@abstractclassmethod
def my_abstract_classmethod(cls, ...):
...
'abstractclassmethod' is deprecated. Use 'classmethod' with
'abstractmethod' instead.
Tc s d|_ t j| d S )NT)r super__init__)selfcallable) __class__r r r
0 s z abstractclassmethod.__init__)__name__
__module__ __qualname____doc__r r
__classcell__r r )r
r r s r c s$ e Zd ZdZdZ fddZ ZS )abstractstaticmethodaO
A decorator indicating abstract staticmethods.
Similar to abstractmethod.
Usage:
class C(metaclass=ABCMeta):
@abstractstaticmethod
def my_abstract_staticmethod(...):
...
'abstractstaticmethod' is deprecated. Use 'staticmethod' with
'abstractmethod' instead.
Tc s d|_ t j| d S )NT)r r r
)r r )r
r r r
H s z abstractstaticmethod.__init__)r r r r r r
r r r )r
r r 5 s r c @ s e Zd ZdZdZdS )abstractpropertyak
A decorator indicating abstract properties.
Requires that the metaclass is ABCMeta or derived from it. A
class that has a metaclass derived from ABCMeta cannot be
instantiated unless all of its abstract properties are overridden.
The abstract properties can be called using any of the normal
'super' call mechanisms.
Usage:
class C(metaclass=ABCMeta):
@abstractproperty
def my_abstract_property(self):
...
This defines a read-only property; you can also define a read-write
abstract property using the 'long' form of property declaration:
class C(metaclass=ABCMeta):
def getx(self): ...
def setx(self, value): ...
x = abstractproperty(getx, setx)
'abstractproperty' is deprecated. Use 'property' with 'abstractmethod'
instead.
TN)r r r r r r r r r r M s r c sF e Zd ZdZdZ fddZdd Zddd Zd
d Zd d
Z Z
S )ABCMetaai Metaclass for defining Abstract Base Classes (ABCs).
Use this metaclass to create an ABC. An ABC can be subclassed
directly, and then acts as a mix-in class. You can also register
unrelated concrete classes (even built-in classes) and unrelated
ABCs as 'virtual subclasses' -- these and their descendants will
be considered subclasses of the registering ABC by the built-in
issubclass() function, but the registering ABC won't show up in
their MRO (Method Resolution Order) nor will method
implementations defined by the registering ABC be callable (not
even via super()).
r c s t j| |||f|}dd |j D }xF|D ]>}x8t|dt D ]&}t||d }t|ddrB|j| qBW q.W t||_t |_ t |_
t |_ t j
|_|S )Nc S s h | ]\}}t |d dr|qS )r F)getattr).0namevaluer r r s z"ABCMeta.__new__..__abstractmethods__r F)r __new__itemsr setadd frozensetr r
_abc_registry
_abc_cache_abc_negative_cacher _abc_invalidation_counter_abc_negative_cache_version) mclsr bases namespacekwargscls abstractsbaser )r
r r r s
zABCMeta.__new__c C sP t |tstdt|| r |S t| |r2td| jj| t jd7 _|S )zsRegister a virtual subclass of an ABC.
Returns the subclass, to allow usage as a class decorator.
zCan only register classesz'Refusing to create an inheritance cycle )
isinstancetype TypeError
issubclass RuntimeErrorr! r r r$ )r* subclassr r r register s
zABCMeta.registerNc C s| t d| j| jf |d t dtj |d xLt| jD ]>}|jdr6t| |}t |t
r`t |}t d||f |d q6W dS )z'Debug helper to print the ABC registry.z Class: %s.%s)filezInv.counter: %s_abc_z%s: %rN) printr r r r$ sorted__dict__
startswithr r. r r )r* r5 r r r r r _dump_registry s
zABCMeta._dump_registryc sb |j }| jkrdS t|}||krH jtjkr>| jkr>dS j|S t fdd||hD S )z'Override for isinstance(instance, cls).TFc 3 s | ]} j |V qd S )N)__subclasscheck__)r c)r* r r s z,ABCMeta.__instancecheck__..) r
r" r/ r% r r$ r# r< any)r* instancer3 subtyper )r* r __instancecheck__ s
zABCMeta.__instancecheck__c C s || j krdS | jtjk r,t | _tj| _n|| jkr:dS | j|}|tk r|t|t sZt
|rl| j j | n | jj | |S | t |df kr| j j | dS x(| j
D ] }t||r| j j | dS qW x*| j D ] }t||r| j j | dS qW | jj | dS )z'Override for issubclass(subclass, cls).TF__mro__)r" r% r r$ r r# __subclasshook__NotImplementedr. boolAssertionErrorr r r! r1 __subclasses__)r* r3 okrclssclsr r r r< s6
zABCMeta.__subclasscheck__)N) r r r r r$ r r4 r; rB r< r r r )r
r r m s
r c @ s e Zd ZdZdS )ABCzVHelper class that provides a standard way to create an ABC using
inheritance.
N)r r r r r r r r rL s rL ) metaclassc C s t jS )zReturns the current ABC cache token.
The token is an opaque object (supporting equality testing) identifying the
current version of the ABC cache for virtual subclasses. The token changes
with every call to ``register()`` on any ABC.
)r r$ r r r r get_cache_token s rN N)r _weakrefsetr r classmethodr staticmethodr propertyr r/ r rL rN r r r r s