shell bypass 403
a
$b� � @ 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/local/python-3.9/lib/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)Zcls_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��selfZprotor 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 r4 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 user? z4_generate_next_value_ must be defined before members�_generate_next_valuerA �,� z-_ignore_ cannot specify already set names: %rZ __order__r= zAttempted to reuse key: %rz%r already defined as: %rr T) r$ � _cls_name�warnings�warn�DeprecationWarningr �
ValueErrorr8 r% �setattr�
isinstance�str�replace�split�listr7 �setr5 r r r r1 r0 rB r r6 �appendr3 � __setitem__)r' �keyr1 rF Zalreadyr: r r rR X sf ��
��
� z_EnumDict.__setitem__)r- r* r. r/ r4 rR �
__classcell__r r r: r r2 J s r2 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 )Nr? )�_check_for_existing_membersr2 rE � _get_mixins_�getattr)�metaclsr+ �bases�kwdsZ 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 )NrA c s i | ]}|� | �qS r r )�.0�k)� classdictr r �
<dictcomp>� � z$EnumMeta.__new__.<locals>.<dictcomp>r= �mro� z Invalid enum member name: {0}rC r/ zAn enumeration.c S s. h | ]&}|j �� D ]\}}t|t�r|�qqS r )�__dict__�itemsrK r )r^ �cr_ �vr r r � <setcomp>� s
�z#EnumMeta.__new__.<locals>.<setcomp>r) )Z__getnewargs_ex__�__getnewargs__r) �
__reduce__c 3 s | ]}|� j v V qd S �N�re �r^ �m)r[ r r � <genexpr>� rb z#EnumMeta.__new__.<locals>.<genexpr>�__new__c 3 s | ]}|� j v V qd S rl rm rn )�baser r rp rb FT�_value_)�__repr__�__str__�
__format__r) rD z#member order does not match _order_)&�
setdefaultrQ �poprV �
_find_new_r5 rP rI �format�joinr3 rq �_member_names_� _member_map_�
_member_type_rc �_value2member_map_�object�anyr, �__mro__re rK �tupler rs �_name_� __objclass__r4 rf rJ r% rW r �__new_member__rL rM rN ) rX r+ rY r` rZ �ignorerS r\ rq �save_new�use_argsZ enum_membersr r= Z
invalid_names�
enum_classZdynamic_attributes�methodsZsabotage�chain� member_namer1 �argsZ enum_memberZcanonical_memberZ class_methodZ
obj_methodZ enum_methodr: )rr r` r[ r rq � s� �
��
zEnumMeta.__new__c C s dS )z6
classes/types should always be True.
Tr r9 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� )rq �_create_)r+ r1 �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')rK r r% r� r. 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- r3 � __delattr__)r+ �attrr: r r r� � s
zEnumMeta.__delattr__c C s g d�| j S )N)r; r/ � __members__r* �r| r9 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 rl �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 rl r� �r^ r �r+ r r rp � rb z$EnumMeta.__iter__.<locals>.<genexpr>r� r� r r� r �__iter__� s zEnumMeta.__iter__c C s
t | j�S rl )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 rt � s zEnumMeta.__repr__c s � fdd�t � j�D �S )z>
Returns members in reverse definition order.
c 3 s | ]}� j | V qd S rl r� r� r� r r rp � rb 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)re �getr� r3 � __setattr__)r+ r r1 Z
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.
NrC rD r r r- )r; rV r] rK rL rM rN r� rO � enumerater? rQ rq �sys� _getframe� f_globalsr� rI r� r, r* r. )r+ �
class_namer� r� r� r� r� rX rY r r\ r` Zoriginal_names� last_values�countr r1 �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 )r^ r r1 ��filterr r �
<listcomp>! s �z&EnumMeta._convert_.<locals>.<listcomp>c S s | d | d fS )Nr r r ��tr r r �<lambda>' rb z$EnumMeta._convert_.<locals>.<lambda>)rS c S s | d S �Nr r r� r r r r� * rb )r� )
�varsr� �modulesrf �sortr% �_reduce_ex_by_namer) �updater� )r+ r r� r� �sourceZmodule_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� rY r� rr r r r rU 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 )Nrq r z%r: too many data types: %r) rP r� r� r� r r~ �addre r r% rx )rY Z
data_typesr� � candidaterr �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� rY r� r\ r[ r r� r rV ; 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__
rq N)r� rq FT)r� rW rq r� r ) r` r[ r\ rq r� �methodZpossible�targetr� r r r ry j s* �
zEnumMeta._find_new_)N)N) r- r* r. r/ � classmethodr] rq r� r� r� r� r� r� r� r� r� �propertyr� rt r� r� r� r� � staticmethodrU rV ry rT 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} �valuesrs r@ � ExceptionrK rI r. r- � __context__)r+ r1 r� �exc�result�eZve_excr r r rq � 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 r? � s zEnum._generate_next_value_c C s d S rl r )r+ r1 r r r r@ � s zEnum._missing_c C s d| j j| j| jf S )N� <%s.%s: %r>)r; r- r� rs r9 r r r rt � s �z
Enum.__repr__c C s d| j j| jf S )N�%s.%s)r; r- r� r9 r r r ru � 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 )re r} )r^ r+ ro r9 r r r� � s
�z Enum.__dir__.<locals>.<listcomp>c S s g | ]}|d dkr|�qS r� r rn r r r r� � rb )r; r/ r* )r; rc re )r' Zadded_behaviorr r9 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� ru r r r~ r� rL rs rv )r' � format_specZstr_overriddenr+ �valr r r rv � s
zEnum.__format__c C s
t | j�S rl )�hashr� r9 r r r �__hash__ s z
Enum.__hash__c C s | j | jffS rl �r; rs r& r r r r) s zEnum.__reduce_ex__c C s | j S )z The name of the Enum member.)r� r9 r r r r s z Enum.namec C s | j S )z The value of the Enum member.�rs r9 r r r r1 s z
Enum.valueN)r- r* r. r/ rq r? r� r@ rt ru r� rv r� r) r r r1 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* r. r/ r r r r r s r c C s | j S rl 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� Zhigh_bitr r r r? * 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+ r1 Zoriginal_valueZpossible_memberr r r r@ = 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� �
_decomposerI r. r� rq r� rs rw )r+ r1 �
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� )rK r; r% r� r. rs �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 �rL r� rs rn r r r r� o rb z!Flag.__repr__.<locals>.<listcomp>)r; r� r- rs r� r{ �r' r+ r� � uncoveredr r r rt 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� rn r r r r� } rb z Flag.__str__.<locals>.<listcomp>)r; r� r- r� rs r r{ r� r r r ru s s
�z Flag.__str__c C s
t | j�S rl )�boolrs r9 r r r r� � s z
Flag.__bool__c C s" t || j�stS | �| j|jB �S rl �rK r; �NotImplementedrs r� r r r �__or__� s z Flag.__or__c C s" t || j�stS | �| j|j@ �S rl r� r� r r r �__and__� s z Flag.__and__c C s" t || j�stS | �| j|jA �S rl 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; rs )r' r� r� Zinvertedro r r r �
__invert__� s
zFlag.__invert__N)r- r* r. r/ r? r� r@ r> r� rt ru 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� )rK �intrI r. r> )r+ r1 Z
new_memberr r r r@ � 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� rQ r� r� rq r� rs rw )r+ r1 r� Zneed_to_creater r� Zbit�
flag_valuer r r r> � s(
�
z IntFlag._create_pseudo_member_c C s0 t || jtf�stS | �| j| �|�jB �}|S rl �rK r; r� r� rs )r' r� r� r r r r� � s zIntFlag.__or__c C s, t || jtf�stS | �| j| �|�j@ �S rl r� r� r r r r� � s zIntFlag.__and__c C s, t || jtf�stS | �| j| �|�jA �S rl r� r� r r r r� � s zIntFlag.__xor__c C s | � | j �}|S rl r� )r' r� r r r r� � s zIntFlag.__invert__N)r- r* r. r/ r� r@ 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)r1 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 )r^ �aliasr r r r r� � rb zunique.<locals>.<listcomp>z duplicate values found in %r: %s)r� rf r rQ r{ rI )Z enumerationZ
duplicatesr r� Z
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 rl r� )ro r r r r� rb z _decompose.<locals>.<lambda>T)rS �reverser )r1 rQ r� r r� r rx ) Zflagr1 Z not_covered�negativer� r� r� Ztmpr� r r r r� � s,
r� )r� �typesr r �__all__r r r r$ r, r� r0 r �dictr2 r r� r r� r r� r r r� r
r� r r r r �<module> s0
T { vI