JezK
Edit File: enum.cpython-39.pyc
a �i� � @ 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 � /usr/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