a
R�f� � @ s� d dl Z d dlmZmZ g d�Zdd� Zdd� Zdd � Zd
d � Zd d
� Z e
� Z G dd� d�Z G dd� de
�ZdZG dd� de�ZG dd� ded�ZG dd� dee�Zdd� ZG dd � d e�ZG d d � d ee�Zd d � Zd!d"� Zd#d$� ZdS )%� N)�MappingProxyType�DynamicClassAttribute)�EnumMeta�Enum�IntEnum�Flag�IntFlag�auto�uniquec C s t | d�p t | d�p t | d�S )z?
Returns True if obj is a descriptor, False otherwise.
�__get__�__set__�
__delete__)�hasattr)�obj� r �)/opt/alt/python39/lib64/python3.9/enum.py�_is_descriptor s
��r c C sL t | �dkoJ| dd� | dd� ko.dkn oJ| d dkoJ| d dkS )z=
Returns True if a __dunder__ name, False otherwise.
� N� ����__�_�����len��namer r r �
_is_dunder s &�
�
�r c C sL t | �dkoJ| d | d ko&dkn oJ| dd� dkoJ| dd� dkS )z;
Returns True if a _sunder_ name, False otherwise.
r r ���r � r r r r r r �
_is_sunder! s ���r c C sT d| f }t |�dkrL|�|�rL|t |� dkrL|d dksH|d dkrLdS dS d S )Nz_%s__� r r r TF)r �
startswith)�cls_namer �patternr r r � _is_private, s
���
�
�r% c C s dd� }|| _ d| _dS )z,
Make the given class un-picklable.
c S s t d| ��d S )Nz%r cannot be pickled)� TypeError��self�protor r r �_break_on_call_reduce= s z6_make_class_unpicklable.<locals>._break_on_call_reducez <unknown>N)�
__reduce_ex__�
__module__)�clsr* r r r �_make_class_unpicklable9 s r. c @ s e Zd ZdZeZdS )r zP
Instances are replaced with an appropriate value in Enum class suites.
N)�__name__r, � __qualname__�__doc__�
_auto_null�valuer r r r r C s r c s, e Zd ZdZ� fdd�Z� fdd�Z� ZS )� _EnumDictz�
Track enum member order and ensure member names are not reused.
EnumMeta will use the names found in self._member_names as the
enumeration member names.
c s& t � �� g | _g | _g | _d| _d S )NF)�super�__init__�
_member_names� _last_values�_ignore� _auto_called�r( �� __class__r r r6 Q s
z_EnumDict.__init__c s� t | j|�r*ddl}|jd|f tdd� t|�r�|dvrBtd��|dkrf| jrXtd ��t | d
|� nV|d kr�t
|t �r�|� d d
��
� }nt|�}|| _t|�t| j�@ }|r�td|f ��n�t|�r�|dkr�d}n�|| jv r�td| ��n�|| jv r�n�t|��s~|| v �r td|| | f ��t
|t��rf|jtk�r`| �|dt| j�| jdd� �|_d| _|j}| j�|� | j�|� t� � ||� dS )z�
Changes anything not dundered or not a descriptor.
If an enum member name is used twice, an error is raised; duplicate
values are not checked for.
Single underscore (sunder) names are reserved.
r Nz@private variables, such as %r, will be normal attributes in 3.10r )�
stacklevel)�_order_�_create_pseudo_member_�_generate_next_value_� _missing_�_ignore_z(_names_ are reserved for future Enum userA z4_generate_next_value_ must be defined before members�_generate_next_valuerC �,� z-_ignore_ cannot specify already set names: %r� __order__r? zAttempted to reuse key: %rz%r already defined as: %rr T) r% � _cls_name�warnings�warn�DeprecationWarningr �
ValueErrorr: r& �setattr�
isinstance�str�replace�split�listr9 �setr7 r r r r3 r2 rD r r8 �appendr5 � __setitem__)r( �keyr3 rI �alreadyr< r r rU X sf ��
��
� z_EnumDict.__setitem__)r/ r, r0 r1 r6 rU �
__classcell__r r r< r r4 J s r4 c s� e Zd ZdZedd� �Z� fdd�Zdd� Zd-dddd d
�d d �Zd
d� Z � fdd�Z
dd� Z dd� Z dd� Z
dd� Zdd� Zedd � �Zd d � Zd d � Z� fd!d"�Zdddd d
�d#d$�Zd.d%d&�Zed'd(� �Zed)d*� �Zed+d,� �Z� ZS )/r z
Metaclass for Enum
c K sD | � ||� t� }||_| �||�\}}|d ur@t|dd �|d< |S )NrA )�_check_for_existing_membersr4 rH � _get_mixins_�getattr)�metaclsr- �bases�kwds� enum_dict� member_type�
first_enumr r r � __prepare__� s �zEnumMeta.__prepare__c s� �� dg ��d� �d }|D ]}��|d � q | �||�\�}| ���|�\}} }
�fdd��jD �} �jD ]
} �| = qn��dd �}
t| �ddh@ }|r�td�d� |����d �vr�d
�d < t
� j | ||�fi |��}g |_ i |_
�|_d d � |�� D �}i |_d
�v�r̈tu�r�d}t�fdd�|D ���s�d�v �rFt|� n�d }|D ]n}|jD ]P� � tu �rl�qXn:t� fdd�|D ���r�d} �q�nd� jv �rXd} �q��qX|d u�rN �q��qN|�r�t|� �jD �]*}| | }t|t��s�|f}n|}�tu �r|f}|
�s*||�}t|d��sb||_n8||g|�R � }t|d��sb�tu �rX||_n
�|� |_|j}||_||_|j |� |j
� � D ]"\} }|j|jk�r�|} �q��q�|j �|� ||v�r�t |||� ||j
|< z||j|< W n t �y� Y n0 �q�dD ]V} | �v �r�qt || �}t �| d �}t || d �}|d u�r||u �rt || |� �qt!d u�rz| �rr||_"t!j |_ |
d u�r�t|
t#��r�|
�$dd��%� }
|
|j k�r�t d��|S )NrC c s i | ]}|� | �qS r r )�.0�k)� classdictr r �
<dictcomp>� � z$EnumMeta.__new__.<locals>.<dictcomp>r? �mro� z Invalid enum member name: {0}rE r1 zAn enumeration.c S s. h | ]&}|j �� D ]\}}t|t�r|�qqS r )�__dict__�itemsrN r )rc �crd �vr r r � <setcomp>� s
�z#EnumMeta.__new__.<locals>.<setcomp>r+ )�__getnewargs_ex__�__getnewargs__r+ �
__reduce__c 3 s | ]}|� j v V qd S �N�rj �rc �m)r` r r � <genexpr>� rg z#EnumMeta.__new__.<locals>.<genexpr>�__new__c 3 s | ]}|� j v V qd S rr rs rt )�baser r rv rg FT�_value_)�__repr__�__str__�
__format__r+ rF z#member order does not match _order_)&�
setdefaultrT �poprZ �
_find_new_r7 rS rL �format�joinr5 rw �_member_names_� _member_map_�
_member_type_rh �_value2member_map_�object�anyr. �__mro__rj rN �tupler ry �_name_� __objclass__r6 rk rM r& r[ r �__new_member__rO rP rQ ) r\ r- r] re r^ �ignorerV ra rw �save_new�use_args� enum_membersr r? �
invalid_names�
enum_class�dynamic_attributes�methods�sabotage�chain� member_namer3 �args� enum_member�canonical_member� class_method�
obj_method� enum_methodr< )rx re r` r rw � s� �
��
zEnumMeta.__new__c C s dS )z6
classes/types should always be True.
Tr r; r r r �__bool__` s zEnumMeta.__bool__Nr ��module�qualname�type�startc C s* |du r| � | |�S | j||||||d�S )a!
Either returns an existing member, or creates a new enum class.
This method is used both when an enum class is given a value to match
to an enumeration member (i.e. Color(3)) and for the functional API
(i.e. Color = Enum('Color', names='RED GREEN BLUE')).
When used for the functional API:
`value` will be the name of the new class.
`names` should be either a string of white-space/comma delimited names
(values will start at `start`), or an iterator/mapping of name, value pairs.
`module` should be set to the module this class is being created in;
if it is not set, an attempt to find that module will be made, but if
it fails the class will not be picklable.
`qualname` should be set to the actual location this class can be found
at in its module; by default it is set to the global scope. If this is
not correct, unpickling will fail in some circumstances.
`type`, if set, will be mixed in as the first base class.
Nr� )rw �_create_)r- r3 �namesr� r� r� r� r r r �__call__f s �zEnumMeta.__call__c C s: t |t�s$tdt|�j| jjf ��t || �o8|j| jv S )N�3unsupported operand type(s) for 'in': '%s' and '%s')rN r r& r� r0 r= r� r� )r- �memberr r r � __contains__� s
��zEnumMeta.__contains__c s( || j v rtd| j ��t� �|� d S )Nz %s: cannot delete Enum member.)r� �AttributeErrorr/ r5 � __delattr__)r- �attrr< r r r� � s
zEnumMeta.__delattr__c C s g d�| j S )N)r= r1 � __members__r, �r� r; r r r �__dir__� s ��zEnumMeta.__dir__c C s> t |�rt|��z | j| W S ty8 t|�d�Y n0 dS )a=
Return the enum member matching `name`
We use __getattr__ instead of descriptors or inserting into the enum
class' __dict__ in order to support `name` and `value` being both
properties for enum members (which live in the class' __dict__) and
enum members themselves.
N)r r� r� �KeyError�r- r r r r � __getattr__� s zEnumMeta.__getattr__c C s
| j | S rr �r� r� r r r � __getitem__� s zEnumMeta.__getitem__c s � fdd�� j D �S )z6
Returns members in definition order.
c 3 s | ]}� j | V qd S rr r� �rc r �r- r r rv � rg z$EnumMeta.__iter__.<locals>.<genexpr>r� r� r r� r �__iter__� s zEnumMeta.__iter__c C s
t | j�S rr )r r� r� r r r �__len__� s zEnumMeta.__len__c C s
t | j�S )z�
Returns a mapping of member name->value.
This mapping lists all enum members, including aliases. Note that this
is a read-only view of the internal mapping.
)r r� r� r r r r� � s zEnumMeta.__members__c C s
d| j S )Nz <enum %r>)r/ r� r r r rz � s zEnumMeta.__repr__c s � fdd�t � j�D �S )z>
Returns members in reverse definition order.
c 3 s | ]}� j | V qd S rr r� r� r� r r rv � rg z(EnumMeta.__reversed__.<locals>.<genexpr>)�reversedr� r� r r� r � __reversed__� s zEnumMeta.__reversed__c s0 | j �di �}||v r td��t� �||� dS )a
Block attempts to reassign Enum members.
A simple assignment to the class namespace only changes one of the
several possible ways to get an Enum member from the Enum class,
resulting in an inconsistent Enumeration.
r� zCannot reassign members.N)rj �getr� r5 � __setattr__)r- r r3 �
member_mapr< r r r� � s zEnumMeta.__setattr__c
C sn | j }|du r| fn|| f}| �| |�\} }
|�||�} t|t�rR|�dd��� }t|ttf�r�|r�t|d t�r�|g } }g }
t | �D ]8\}}|
�
||||
dd� �}|
� |� |� ||f� q�|D ].}t|t�r�||| }}n|\}}|| |< q�|� |||| �}|du �r@zt
�d�jd }W n tttf�y> Y n0 |du �rTt|� n||_|du�rj||_|S )a�
Convenience method to create a new Enum class.
`names` can be:
* A string containing member names, separated either with spaces or
commas. Values are incremented by 1 from `start`.
* An iterable of member names. Values are incremented by 1 from `start`.
* An iterable of (member name, value) pairs.
* A mapping of member name -> value pairs.
NrE rF r r r/ )r= rZ rb rN rO rP rQ r� rR � enumeraterA rT rw �sys� _getframe� f_globalsr� rL r� r. r, r0 )r- �
class_namer� r� r� r� r� r\ r] r ra re �original_names� last_values�countr r3 �itemr� � member_valuer� r r r r� � s<
zEnumMeta._create_c s� t tj| �}|r t |�}n|}� fdd�|�� D �}z|jdd� d� W n" tyl |jdd� d� Y n0 | |||d�} t| _|�| j � | ||< | S )z[
Create a new Enum subclass that replaces a collection of global constants
c s g | ]\}}� |�r||f�qS r r )rc r r3 ��filterr r �
<listcomp>! s �z&EnumMeta._convert_.<locals>.<listcomp>c S s | d | d fS )Nr r r ��tr r r �<lambda>' rg z$EnumMeta._convert_.<locals>.<lambda>)rV c S s | d S �Nr r r� r r r r� * rg )r� )
�varsr� �modulesrk �sortr& �_reduce_ex_by_namer+ �updater� )r- r r� r� �source�module_globals�membersr r� r � _convert_ s
� zEnumMeta._convert_c C s< |D ]2}|j D ]&}t|t�r|jrtd| |jf ��qqd S )Nz %s: cannot extend enumeration %r)r� �
issubclassr r� r& r/ )r� r] r� rx r r r rY 1 s
��z$EnumMeta._check_for_existing_membersc sT |s t tfS � fdd�}|d }t|t�s2td��||�p<t }|jrLtd��||fS )z�
Returns the type for creating enum members, and the first inherited
enum class.
bases: the tuple of bases that was given to __new__
c s� t � }| D ]x}d }|jD ]h}|tu r(qqt|t�rN|jtur�|�|j� q
qd|jv rxt|t�rdq|�|pn|� q
q|p~|}qq
t|�dkr�t d� |f ��n|r�|�
� S d S d S )Nrw r z%r: too many data types: %r) rS r� r� r� r r� �addrj r r& r~ )r] �
data_typesr� � candidaterx �r� r r �_find_data_typeF s*
z.EnumMeta._get_mixins_.<locals>._find_data_typer zZnew enumerations should be created as `EnumName([mixin_type, ...] [data_type,] enum_type)`zCannot extend enumerations)r� r r� r& r� )r� r] r� ra r` r r� r rZ ; s
zEnumMeta._get_mixins_c C s� | � dd�}|du}|du rpdD ]H}||fD ].}t||d�}|ddjtjtjhvr,|} q\q,|dur qpq tj}|tju r�d}nd}|||fS )a
Returns the __new__ to be used for creating the enum members.
classdict: the class dictionary given to __new__
member_type: the data type whose __new__ will be used by default
first_enum: enumeration to check for an overriding __new__
rw N)r� rw FT)r� r[ rw r� r ) re r` ra rw r� �method�possible�targetr� r r r r j s* �
zEnumMeta._find_new_)N)N) r/ r, r0 r1 � classmethodrb rw r� r� r� r� r� r� r� r� r� �propertyr� rz r� r� r� r� � staticmethodrY rZ r rX r r r< r r � s6
.%
5
!
.r c @ st e Zd ZdZdd� Zdd� Zedd� �Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
edd� �Zedd� �ZdS )r zV
Generic enumeration.
Derive from this class to define new enumerations.
c
C s( t |�| u r|S z | j| W S ty. Y n8 tyd | j�� D ]}|j|krD| Y S qDY n0 zd }| �|�}W n, ty� } z|}d }W Y d }~n
d }~0 0 zrt || �r�|W d }d }S t
d|| j f �}|d u r�|d u r�|�n |d u �rtd| j |f �}||_
|�W d }d }n
d }d }0 d S )N�%r is not a valid %szDerror in %s._missing_: returned %r instead of None or a valid member)r� r� r� r& r� �valuesry rB � ExceptionrN rL r0 r/ � __context__)r- r3 r� �exc�result�e�ve_excr r r rw � sJ
�
���z Enum.__new__c C s4 t |�D ]&}z|d W S ty, Y q0 q|S )��
Generate the next value when not given.
name: the name of the member
start: the initial start value or None
count: the number of existing members
last_value: the last value assigned or None
r N)r� r& )r r� r� r� �
last_valuer r r rA � s zEnum._generate_next_value_c C s d S rr r )r- r3 r r r rB � s zEnum._missing_c C s d| j j| j| jf S )N� <%s.%s: %r>)r= r/ r� ry r; r r r rz � s �z
Enum.__repr__c C s d| j j| jf S )N�%s.%s)r= r/ r� r; r r r r{ � s z Enum.__str__c s4 � fdd�� j �� D �dd� � jD � }g d�| S )z<
Returns all members and all public methods
c s2 g | ]*}|j D ] }|d dkr|� jvr|�qqS �r r )rj r� )rc r- ru r; r r r� � s
�z Enum.__dir__.<locals>.<listcomp>c S s g | ]}|d dkr|�qS r� r rt r r r r� � rg )r= r1 r, )r= rh rj )r( �added_behaviorr r; r r� � s
��z Enum.__dir__c C sJ t | �jtjtjfv}| jtu s$|r2t}t| �}n | j}| j}|�||�S )z\
Returns format using actual value type unless __str__ has been overridden.
) r� r{ r r r� r� rO ry r| )r( � format_spec�str_overriddenr- �valr r r r| � s
zEnum.__format__c C s
t | j�S rr )�hashr� r; r r r �__hash__ s z
Enum.__hash__c C s | j | jffS rr �r= ry r' r r r r+ s zEnum.__reduce_ex__c C s | j S )z The name of the Enum member.)r� r; r r r r s z Enum.namec C s | j S )z The value of the Enum member.�ry r; r r r r3 s z
Enum.valueN)r/ r, r0 r1 rw rA r� rB rz r{ r� r| r� r+ r r r3 r r r r r � s -
r )� metaclassc @ s e Zd ZdZdS )r z.Enum where members are also (and must be) intsN)r/ r, r0 r1 r r r r r s r c C s | j S rr r r' r r r r� " s r� c @ sp e Zd ZdZdd� Zedd� �Zedd� �Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� ZdS )r z
Support for flags
c C sb |s|dur|S dS t |�D ]8}zt|�}W qVW q tyR td| �d�Y q 0 q d|d S )r� Nr zInvalid Flag value: %rr )r� � _high_bitr� r& )r r� r� r� r� �high_bitr r r rA * s
zFlag._generate_next_value_c C s. |}|dk r| }| � |�}|dk r*| }|S )�V
Returns member (possibly creating it) if one can be found for value.
r )r@ )r- r3 �original_value�possible_memberr r r rB = s
zFlag._missing_c C sb | j �|d�}|du r^t| |�\}}|r:td|| jf ��t�| �}d|_||_| j � ||�}|S )�L
Create a composite member iff value contains only members.
Nr� )
r� r� �
_decomposerL r0 r� rw r� ry r} )r- r3 �
pseudo_memberr � extra_flagsr r r r@ J s
zFlag._create_pseudo_member_c C s8 t || j�s&tdt|�j| jjf ��|j| j@ |jkS )zP
Returns True if self has at least the same flags set as other.
r� )rN r= r& r� r0 ry �r( �otherr r r r� ^ s ��zFlag.__contains__c C sV | j }| jd ur$d|j| j| jf S t|| j�\}}d|jd�dd� |D ��| jf S )Nr� �|c S s g | ]}t |jp|j��qS r �rO r� ry rt r r r r� o rg z!Flag.__repr__.<locals>.<listcomp>)r= r� r/ ry r r� �r( r- r� � uncoveredr r r rz h s
�z
Flag.__repr__c C s� | j }| jd ur d|j| jf S t|| j�\}}t|�dkr^|d jd u r^d|j|d jf S d|jd�dd� |D ��f S d S )Nr� r r z%s.%rr c S s g | ]}t |jp|j��qS r r rt r r r r� } rg z Flag.__str__.<locals>.<listcomp>)r= r� r/ r ry r r� r r r r r{ s s
�z Flag.__str__c C s
t | j�S rr )�boolry r; r r r r� � s z
Flag.__bool__c C s" t || j�stS | �| j|jB �S rr �rN r= �NotImplementedry r r r r �__or__� s z Flag.__or__c C s" t || j�stS | �| j|j@ �S rr r
r r r r �__and__� s z Flag.__and__c C s" t || j�stS | �| j|jA �S rr r
r r r r �__xor__� s z Flag.__xor__c C sN t | j| j�\}}| �d�}| jD ] }||vr"|j| j@ s"||B }q"| �|�S r� )r r= ry )r( r� r �invertedru r r r �
__invert__� s
zFlag.__invert__N)r/ r, r0 r1 rA r� rB r@ r� rz r{ r� r r
r r r r r r r % s
r c @ sT e Zd ZdZedd� �Zedd� �Zdd� Zdd � Zd
d � Z eZ
eZ e Z d d
� Z
dS )r z)
Support for integer-based Flags
c C s* t |t�s td|| jf ��| �|�}|S )r� r� )rN �intrL r0 r@ )r- r3 �
new_memberr r r rB � s
zIntFlag._missing_c C s� | j �|d�}|du r�|g}t| |�\}}|rtt|�}d| }|| j vrZ||vrZ|�|� || krjd}q*||N }q*t|�D ]*}t�| |�}d|_||_ | j �
||�}q||S )r� Nr r ) r� r� r r� rT r� r rw r� ry r} )r- r3 r �need_to_creater r �bit�
flag_valuer r r r@ � s(
�
z IntFlag._create_pseudo_member_c C s0 t || jtf�stS | �| j| �|�jB �}|S rr �rN r= r r ry )r( r r� r r r r � s zIntFlag.__or__c C s, t || jtf�stS | �| j| �|�j@ �S rr r r r r r r
� s zIntFlag.__and__c C s, t || jtf�stS | �| j| �|�jA �S rr r r r r r r � s zIntFlag.__xor__c C s | � | j �}|S rr r� )r( r� r r r r � s zIntFlag.__invert__N)r/ r, r0 r1 r� rB r@ r r
r �__ror__�__rand__�__rxor__r r r r r r � s
r c C s | � � d S )zJ
returns index of highest bit, or -1 if value is zero or negative
r )�
bit_length)r3 r r r r� � s r� c C s^ g }| j �� D ]"\}}||jkr|�||jf� q|rZd�dd� |D ��}td| |f ��| S )zI
Class decorator for enumerations ensuring unique member values.
z, c S s g | ]\}}d ||f �qS )z%s -> %sr )rc �aliasr r r r r� � rg zunique.<locals>.<listcomp>z duplicate values found in %r: %s)r� rk r rT r� rL )� enumeration�
duplicatesr r� �
alias_detailsr r r r
� s
��r
c C s� |}|dk }g }| D ].}|j }|r||@ |kr|�|� || M }q|s�|}|r�dt|� }|| jv r�|�| j| � || M }|| M }qL|s�|| jv r�|�| j| � |jdd� dd� t|�dkr�|d j |kr�|�d� ||fS )z-
Extract all members from the value.
r r c S s | j S rr r� )ru r r r r� rg z _decompose.<locals>.<lambda>T)rV �reverser )r3 rT r� r� r� r r~ ) �flagr3 � not_covered�negativer� r� r� �tmpr r r r r � s,
r )r� �typesr r �__all__r r r r% r. r� r2 r �dictr4 r r� r r r r� r r r� r
r r r r r �<module> s0
T { vI