o

%weB�@s�dZd
dl
mZ
d
dlmZ
d
dlmZ
d
dlmZ
er&d
dlm	Z	
e	dZ
eGdd	�d	e��
Zee�
Z
d
d�ee
�
D�
Zdd
�eD�
ZdS)a"

Scope definition and related utilities.

Those are defined here, instead of in the 'fixtures' module because
their use is spread across many other pytest modules, and centralizing it in 'fixtures'
would cause circular references.

Also this makes the module light to import, as it should.
�)
�Enum)
�total_ordering)
�Optional)
�
TYPE_CHECKING)
�Literal)�session�package�module�class�functionc
@s�eZ
dZUd
ZdZded<dZded<dZded<d	Zded
<dZ	ded<ddd�Z
ddd�Zddd
efdd�Z
e	ddddedeed
dfdd��
ZdS)�Scopez�
    Represents one of the possible fixture scopes in pytest.

    Scopes are ordered from lower to higher, that is:

              ->>> higher ->>>

    Function < Class < Module < Package < Session

              <<<- lower  <<<-
    r�
_ScopeName�Functionr
�Classr	�Moduler�Packager�Session�returnc
Cs*t|}
|
d
krt
|�d��
�
t|
dS)zReturn the next lower scope.r
z is the lower-most scope�
)�_SCOPE_INDICES�
ValueError�_ALL_SCOPES��self�index�r�F/home/arjun/projects/env/lib/python3.10/site-packages/_pytest/scope.py�
next_lower*s


zScope.next_lowerc
Cs2t|}
|
t
t�
d
krt|�d��
�
t|
d
S)zReturn the next higher scope.rz is the upper-most scope)r�lenrrrrrr�next_higher1s


zScope.next_higher�othercCst|}t|
}||kS�
N)
r)rr �
self_index�other_indexrrr�__lt__8s


zScope.__lt__N�
scope_name�descr�wherec
CsVd
dlm
}
zt|
�
}W|Sty*


|d�||r d|�d�n
d|
�dd�
Y|Sw)	a

        Given a scope name from the user, return the equivalent Scope enum. Should be used
        whenever we want to convert a user provided scope name to its enum object.

        If the scope name is invalid, construct a user friendly message and call pytest.fail.
        r
)
�failz'{} {}got an unexpected scope value '{}'zfrom �
 �F)
�pytrace)�_pytest.outcomesr(rr�format)�clsr%r&r'r(�scoperrr�	from_user=s

�


���zScope.from_user)rrr!)�__name__�
__module__�__qualname__�__doc__r�__annotations__rrrrrr�boolr$�classmethod�strrr0rrrrrs*







�
�
�
��rc
Csi|]\}
}||
�qSrr)�.0rr/rrr�
<dictcomp>Wsr:c
Csg|]	}
|
tj
u
r|
�qSr)rr)r9�
xrrr�
<listcomp>[sr<N)r4�enumr�	functoolsr�typingrr�typing_extensionsrr
r�listr�	enumerater�HIGH_SCOPESrrrr�<module>
s	




@