3
\" � @ sv d Z ddlmZ dd� ZG dd� de�ZG dd� de�ZG d d
� d
e�Z G d d � d e
�Z G d
d� de d�Z 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.py�abstractmethod s r c s$ e Zd ZdZdZ� fdd�Z� 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__)�self�callable)� __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� fdd�Z� 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� fdd�Zdd� 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|dd�rB|j|� qBW q.W t|�|_t� |_ t� |_
t� |_ t j
|_|S )Nc S s h | ]\}}t |d d�r|�qS )r F)�getattr)�.0�name�valuer r r � � s z"ABCMeta.__new__..�__abstractmethods__r F)r �__new__�itemsr �set�add� frozensetr r �
_abc_registry�
_abc_cache�_abc_negative_cacher �_abc_invalidation_counter�_abc_negative_cache_version) �mclsr �bases� namespace�kwargs�cls� abstracts�baser )r
r r r � s
zABCMeta.__new__c C sP t |t�std��t|| �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� ) �
isinstance�type� 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| j�D ]>}|jd�r6t| |�}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 rn|r^| j j|� n | jj|� |S | t |df �kr�| j j|� dS x(| j
D ] }t ||�r�| j j|� dS q�W x*| j � D ] }t ||�r�| j j|� dS q�W | jj|� dS )z'Override for issubclass(subclass, cls).TF�__mro__)
r" r% r r$ r r# �__subclasshook__�NotImplementedr r r! r1 �__subclasses__)r* r3 �ok�rcls�sclsr r r r< � s4
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 rJ � s rJ )� metaclassc C s t jS )z�Returns 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 rL N)r � _weakrefsetr r � classmethodr � staticmethodr �propertyr r/ r rJ rL r r r r � s