← Back
Editing: enum.cpython-310.pyc
o 0�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�pt | d�pt | d�S )z? Returns True if obj is a descriptor, False otherwise. �__get__�__set__� __delete__)�hasattr)�obj� r �+/opt/alt/python310/lib64/python3.10/enum.py�_is_descriptor s ��r c C sL t | �dko%| dd� | dd� kodkn o%| d dko%| d dkS )z= Returns True if a __dunder__ name, False otherwise. � N� ����__�_�����len��namer r r � _is_dunder s &� � �r c C sL t | �dko%| d | d kodkn o%| dd� dko%| 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 s^ d| f }t |�}t |�|kr-|�|�r-|||d � dgkr-|d dks+|d dkr-dS dS )Nz_%s__r r r r TF)r � startswith)�cls_namer �pattern�pat_lenr r r � _is_private, s �r% c C s dd� }|| _ d| _dS )z, Make the given class un-picklable. c S s t d| ��)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_unpicklable: 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 D 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 R s z_EnumDict.__init__c s� t | j|�rddl}|jd|f tdd� t|�r_|dvr!td��|dkr3| jr,td ��t | d |� n�|d kr^t |t �rE|� d d �� � }nt|�}|| _t|�t| j�@ }|r^td|f ��n[t|�rj|dkrid}nP|| jv rutd| ��|| jv r{n?t|�s�|| v r�td|| | f ��t |t�r�|jtkr�| �|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.11r �� stacklevel)�_order_�_create_pseudo_member_�_generate_next_value_� _missing_�_ignore_z(_names_ are reserved for future Enum userB z4_generate_next_value_ must be defined before members�_generate_next_valuerD �,� 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 rE r r8 �appendr5 � __setitem__)r( �keyr3 rJ �alreadyr< r r rV Y sj �� ���� � z_EnumDict.__setitem__)r/ r, r0 r1 r6 rV � __classcell__r r r< r r4 K 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 )NrB )�_check_for_existing_membersr4 rI � _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 ]} �| = q7��dd �} t| �ddh@ }|rWtd�d� |����d �vr_d �d < t � j | ||�fi |��}g |_ i |_ �|_d d � |�� D �}i |_d �vrՈtur�d}t�fdd�|D ��s�d�v r�t|� n6d }|D ]+}|jD ] � � tu r�q�t� fdd�|D ��r�d} n d� jv r�d} nq�|d ur� nq�|r�t|� �jD ]�}| | }t|t�s�|f}n|}�tu r�|f}| s�||�}t|d�s�||_n ||g|�R � }t|d��s�tu �r||_n�|� |_|j}||_||_|j |� |j � � D ]\} }|j|jk�r=|} n�q.|j �|� ||v�rPt |||� ||j |< z||j|< W q� t �yf Y q�w dD ]+} | �v �rr�qit || �}t �| d �}t || d �}|d u�r�||u �r�t || |� �qit!d u�r�| �r�||_"t!j |_ | d u�r�t| t#��r�| �$dd��%� } | |j k�r�t d��|S )NrD c s i | ]}|� | �qS r r )�.0�k)� classdictr r � <dictcomp>� s z$EnumMeta.__new__.<locals>.<dictcomp>r@ �mro� z Invalid enum member name: {0}rF r1 zAn enumeration.c S s. h | ]}|j �� D ] \}}t|t�r |�q qS r )�__dict__�itemsrO r )rd �cre �vr r r � <setcomp>� s ���z#EnumMeta.__new__.<locals>.<setcomp>r+ )�__getnewargs_ex__�__getnewargs__r+ � __reduce__c 3 � � | ]}|� j v V qd S �N�rj �rd �m)ra r r � <genexpr>� � � z#EnumMeta.__new__.<locals>.<genexpr>�__new__c 3 rr rs rt ru )�baser r rw rx FT�_value_)�__repr__�__str__� __format__r+ rG z#member order does not match _order_)&� setdefaultrU �popr[ � _find_new_r7 rT rM �format�joinr5 ry �_member_names_� _member_map_� _member_type_rh �_value2member_map_�object�anyr. �__mro__rj rO �tupler r{ �_name_� __objclass__r6 rk rN r& r\ r �__new_member__rP rQ rR ) r] r- r^ rf r_ �ignorerW rb ry �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< )rz rf ra r ry � s� � �� �� � � � � zEnumMeta.__new__c C s dS )z6 classes/types should always be True. Tr r; r r r �__bool__a 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� )ry �_create_)r- r3 �namesr� r� r� r� r r r �__call__g s �zEnumMeta.__call__c C sR t |t�s dd l}|jdtdd� tdt|�j| jjf ��t || �o(|j | j v S )Nr zpin 3.12 __contains__ will no longer raise TypeError, but will return True if obj is a member or a member's valuer r> �3unsupported operand type(s) for 'in': '%s' and '%s') rO r rJ rK rL r& r� r0 r= r� r� )r- r rJ r r r � __contains__� s ���zEnumMeta.__contains__c s( || j v r td| 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 s6 t |�rt|��z| j| W S ty t|�d�w )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 rs �r� r� r r r � __getitem__� � zEnumMeta.__getitem__c s � fdd�� j D �S )z6 Returns members in definition order. c 3 � � | ]}� j | V qd S rs r� �rd r �r- r r rw � rx z$EnumMeta.__iter__.<locals>.<genexpr>r� r� r r� r �__iter__� s zEnumMeta.__iter__c C � t | j�S rs )r r� r� r r r �__len__� r� zEnumMeta.__len__c C r� )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 r| � r� zEnumMeta.__repr__c s � fdd�t � j�D �S )z> Returns members in reverse definition order. c 3 r� rs r� r� r� r r rw � rx z(EnumMeta.__reversed__.<locals>.<genexpr>)�reversedr� r� r r� r � __reversed__� s zEnumMeta.__reversed__c s0 | j �di �}||v rtd��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 sf | j }|du r | fn|| f}| �| |�\} } |�||�} t|t�r)|�dd��� }t|ttf�ra|rat|d t�ra|g } }g } t | �D ] \}}| � |||| dd� �}| � |� |� ||f� qD|D ]}t|t�rr||| }}n|\}}|| |< qc|� |||| �}|du r�z t �d�jd }W n tttfy� Y nw |du r�t|� n||_|dur�||_|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. NrF rG r r r/ )r= r[ rc rO rP rQ rR r� rS � enumeraterB rU ry �sys� _getframe� f_globalsr� rM r� r. r, r0 )r- � class_namer� r� r� r� r� r] r^ r rb rf �original_names� last_values�countr r3 �itemr� � member_valuer� r r r r� � s> � zEnumMeta._create_c s� t tj| �}|rt |�}n|}� fdd�|�� D �}z |jdd� d� W n ty6 |jdd� d� Y nw | |||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 )rd r r3 ��filterr r � <listcomp>) s ��z&EnumMeta._convert_.<locals>.<listcomp>c S s | d | d fS )Nr r r ��tr r r �<lambda>/ s z$EnumMeta._convert_.<locals>.<lambda>)rW c S s | d S �Nr r r� r r r r� 2 s )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 ]}|j D ]}t|t�r|jrtd| |jf ��qqd S )Nz %s: cannot extend enumeration %r)r� � issubclassr r� r& r/ )r� r^ r� rz r r r rZ 9 s �����z$EnumMeta._check_for_existing_membersc sT |st tfS � fdd�}|d }t|t�std��||�p t }|jr&td��||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 ]:}d }|jD ]2}|tu rq t|t�r&|jtur%|�|j� nq d|jv r:t|t�r1q |�|p6|� n|p=|}q qt|�dkrNt d� |f ��|rT|� � S d S )Nry r z%r: too many data types: %r) rT r� r� r� r r� �addrj r r& r� )r^ � data_typesr� � candidaterz �r� r r �_find_data_typeN 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� rb ra r r� r r[ C s zEnumMeta._get_mixins_c C s� | � dd�}|du}|du r8dD ]$}||fD ]}t||d�}|ddjtjtjhvr-|} nq|dur4 nqtj}|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__ ry N)r� ry FT)r� r\ ry r� r ) rf ra rb ry r� �method�possible�targetr� r r r r� r s. ��� zEnumMeta._find_new_rs ) r/ r, r0 r1 � classmethodrc ry r� r� r� r� r� r� r� r� r� �propertyr� r| r� r� r� r� � staticmethodrZ r[ r� rY r r r< r r � s8 .% 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 n ty2 | j�� D ] }|j|kr/| Y S q"Y nw z d }| �|�}W n tyR } z |}d }W Y d }~nd }~ww z6t || �r`|W d }d }S t d|| j f �}|d u rs|d u rs|�|d u r�td| j |f �}t |t �s�||_ |�d }d }w )N�%r is not a valid %szDerror in %s._missing_: returned %r instead of None or a valid member)r� r� r� r& r� �valuesr{ rC � ExceptionrO rM r0 r/ � __context__)r- r3 �member�exc�result�e�ve_excr r r ry � sP ����� ��� z Enum.__new__c C s2 t |�D ]}z|d W S ty Y qw |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 )r� r& )r r� r� r� � last_valuer r r rB � s �zEnum._generate_next_value_c C s d S rs r )r- r3 r r r rC � s zEnum._missing_c C s d| j j| j| jf S )N� <%s.%s: %r>)r= r/ r� r{ r; r r r r| � 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� )rd r- rv r; r r r� � s ��z Enum.__dir__.<locals>.<listcomp>c S s g | ] }|d dkr|�qS r� r ru r r r r� � � )r= r1 r, )r= rh rj )r( �added_behaviorr r; r r� � s �� z Enum.__dir__c C sJ t | �jtjtjfv}| jtu s|rt}t| �}n| j}| j}|�||�S )z\ Returns format using actual value type unless __str__ has been overridden. ) r� r} r r r� r� rP r{ r~ )r( � format_spec�str_overriddenr- �valr r r r~ � s zEnum.__format__c C r� rs )�hashr� r; r r r �__hash__ r� z Enum.__hash__c C s | j | jffS rs �r= r{ r' r r r r+ s zEnum.__reduce_ex__c C � | j S )z The name of the Enum member.)r� r; r r r r � z Enum.namec C r� )z The value of the Enum member.�r{ r; r r r r3 ! r� z Enum.valueN)r/ r, r0 r1 ry rB r� rC r| 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 r� rs 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 sX |s |dur|S dS t |�D ]}zt|�}W n ty% td| �d�w d|d S )r� Nr zInvalid Flag value: %rr )r� � _high_bitr� r& )r r� r� r� r� �high_bitr r r rB 3 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 )rA )r- r3 �original_value�possible_memberr r r rC F 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� � _decomposerM r0 r� ry r� r{ r )r- r3 � pseudo_memberr � extra_flagsr r r rA S s zFlag._create_pseudo_member_c C s8 t || j�stdt|�j| jjf ��|j| j@ |jkS )zP Returns True if self has at least the same flags set as other. r� )rO r= r& r� r0 r{ �r( �otherr r r r� g s ��zFlag.__contains__c C sV | j }| jd urd|j| j| jf S t|| j�\}}d|jd�dd� |D ��| jf S )Nr� �|c S � g | ] }t |jp |j��qS r �rP r� r{ ru r r r r� x r� z!Flag.__repr__.<locals>.<listcomp>)r= r� r/ r{ r r� �r( r- r� � uncoveredr r r r| q s �z Flag.__repr__c C s| | j }| jd urd|j| jf S t|| j�\}}t|�dkr/|d jd u r/d|j|d jf S d|jd�dd� |D ��f S )Nr� r r z%s.%rr c S r r r ru r r r r� � r� z Flag.__str__.<locals>.<listcomp>)r= r� r/ r r{ r r� r r r r r} | s �z Flag.__str__c C r� rs )�boolr{ r; r r r r� � r� z Flag.__bool__c C s" t || j�stS | �| j|jB �S rs �rO r= �NotImplementedr{ r r r r �__or__� � z Flag.__or__c C s" t || j�stS | �| j|j@ �S rs r r r r r �__and__� r z Flag.__and__c C s" t || j�stS | �| j|jA �S rs r r r r r �__xor__� r z Flag.__xor__c C sN t | j| j�\}}| �d�}| jD ]}||vr!|j| j@ s!||B }q| �|�S r� )r r= r{ )r( r� r �invertedrv r r r � __invert__� s � zFlag.__invert__N)r/ r, r0 r1 rB r� rC rA r� r| 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�std|| jf ��| �|�}|S )r r� )rO �intrM r0 rA )r- r3 � new_memberr r r rC � s zIntFlag._missing_c C s� | j �|d�}|du rU|g}t| |�\}}|r;t|�}d| }|| j vr-||vr-|�|� || kr5d}n||N }|st|�D ]}t�| |�}d|_||_ | j � ||�}q?|S )r Nr r ) r� r� r r rU r� r ry r� r{ r )r- r3 r �need_to_creater r �bit� flag_valuer r r rA � s( � z IntFlag._create_pseudo_member_c C s0 t || jtf�s tS | �| j| �|�jB �}|S rs �rO r= r r r{ )r( r r� r r r r � s zIntFlag.__or__c C s, t || jtf�s tS | �| j| �|�j@ �S rs r r r r r r � � zIntFlag.__and__c C s, t || jtf�s tS | �| j| �|�jA �S rs r r r r r r � r! zIntFlag.__xor__c C s | � | j �}|S rs r� )r( r� r r r r � s zIntFlag.__invert__N)r/ r, r0 r1 r� rC rA 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|r-d�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 )rd �aliasr r r r r� � r� zunique.<locals>.<listcomp>z duplicate values found in %r: %s)r� rk r rU r� rM )� enumeration� duplicatesr r� � alias_detailsr r r r � s � ��r c C s� |}|dk }g }| D ]}|j }|r!||@ |kr!|�|� || M }q |sG|}|rGdt|� }|| jv r@|�| j| � || M }|| M }|s(|sV|| jv rV|�| j| � |jdd� dd� t|�dkrq|d j |krq|�d� ||fS )z- Extract all members from the value. r r c S r� rs r )rv r r r r� s z _decompose.<locals>.<lambda>T)rW �reverser )r3 rU r r� r� r r� ) �flagr3 � not_covered�negativer� r� r� �tmpr r r r r s0 � � 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> s4 T vI
Save File
Cancel