�
�֥gNN � �0 � S r SSKrSSKrSSKJr SSKJr SSKJrJr SSK J
r
J r J r J
r
SSKJr SS KJr / S
QrS rS r\S
5 r\
" SSSS9 " S S5 5 rS r\
" SSSS9 " S S5 5 rS=S jr\
" SSSS9 " S S5 5 rS r\
" SSSS9 " S S 5 5 r S r \
" SSSS9 " S S 5 5 r S r \
" SSSS9 " S! S"5 5 r S>S# jr!\
" SSSS9 " S$ S%5 5 r"S>S& jr#\
" SSSS9 " S' S(5 5 r$S) r%S* r&S+ r'S, r(\
" SSSS9 " S- S.5 5 r)S/ r*\
" SSSS9 " S0 S15 5 r+S2 r,\
" SSSS9 " S3 S45 5 r-S5 r.\
" SSSS9 " S6 S75 5 r/S\0\14S8.S9 jr2\
" SSSS9 " S: S;5 5 r3S< r4g)?z
Commonly useful validators.
� N)�contextmanager)�Pattern� )�get_run_validators�set_run_validators)�
_AndValidator�and_�attrib�attrs)�default_if_none)�NotCallableError)r �
deep_iterable� deep_mapping�disabled�ge� get_disabled�gt�in_� instance_of� is_callable�le�lt�
matches_re�max_len�min_len�not_�optional�or_� set_disabledc �$ � [ U ( + 5 g)z�
Globally disable or enable running validators.
By default, they are run.
Args:
disabled (bool): If `True`, disable running all validators.
.. warning::
This function is not thread-safe!
.. versionadded:: 21.3.0
N�r )r s �1/usr/lib/python3/dist-packages/attr/validators.pyr r * s � � �8�|�$� c � � [ 5 ( + $ )z�
Return a bool indicating whether validators are currently disabled or not.
Returns:
bool:`True` if validators are currently disabled.
.. versionadded:: 21.3.0
)r � r# r" r r < s � � "�#� #�#r# c # �b # � [ S5 Sv � [ S5 g! [ S5 f = f7f)z�
Context manager that disables running validators within its context.
.. warning::
This context manager is not thread-safe!
.. versionadded:: 21.3.0
FNTr! r% r# r" r r H s( � � � �u� �!�
��4� ���4� �s � /� � /�
,�/FT)�repr�slots� unsafe_hashc �. � \ rS rSr\" 5 rS rS rSrg)�_InstanceOfValidator�Z c �� � [ X0R 5 ( dH SUR SU R < SU< SUR < S3 n[ UUU R U5 eg)�@
We use a callable class to be able to change the ``__repr__``.
�'�
' must be � (got z that is a �).N)�
isinstance�type�name� __class__� TypeError��self�inst�attr�value�msgs r" �__call__� _InstanceOfValidator.__call__^ sf � � �%���+�+��d�i�i�[�
�4�9�9�-�v�e�Y�k�RW�Ra�Ra�Qd�df�g�C����� � �� �
� ,r# c �$ � SU R < S3$ )Nz <instance_of validator for type �>�r4 �r9 s r" �__repr__� _InstanceOfValidator.__repr__k � � �1�$�)�)� �a�@�@r# r% N� �__name__�
__module__� __qualname__�__firstlineno__r
r4 r> rD �__static_attributes__r% r# r" r+ r+ Z � � � �8�D� �Ar# r+ c � � [ U 5 $ )a�
A validator that raises a `TypeError` if the initializer is called with a
wrong type for this particular attribute (checks are performed using
`isinstance` therefore it's also valid to pass a tuple of types).
Args:
type (type | tuple[type]): The type to check for.
Raises:
TypeError:
With a human readable error message, the attribute (of type
`attrs.Attribute`), the expected type, and the value it got.
)r+ rB s r" r r o � � � �� %�%r# )r' �frozenr( c �< � \ rS rSr\" 5 r\" 5 rS rS rSr g)�_MatchesReValidator� c � � U R U5 ( dD SUR SU R R < SU< S3n[ UUU R U5 eg)r. r/ z' must match regex z (z doesn't)N)�
match_funcr5 �pattern�
ValueErrorr8 s r" r> � _MatchesReValidator.__call__� s` � � ���u�%�%��d�i�i�[� 3�D�L�L�4H�4H�3K�2�e�Y�V_�`�C� ���� � �� �
� &r# c �$ � SU R < S3$ )Nz"<matches_re validator for pattern rA )rV rC s r" rD � _MatchesReValidator.__repr__� s � �3�D�L�L�3C�1�E�Er# r% N)
rH rI rJ rK r
rV rU r> rD rL r% r# r" rR rR � s � ��h�G���J� �Fr# rR c
�& � [ R S[ R [ R 4nX#; aD SR SR [
S [ U5 5 5 5 5 n[ U5 e[ U [ 5 ( a U( a
Sn[ U5 eU nO[ R " X5 nU[ R L a
UR nO,U[ R L a
UR nO UR n[ XV5 $ )a�
A validator that raises `ValueError` if the initializer is called with a
string that doesn't match *regex*.
Args:
regex (str, re.Pattern):
A regex string or precompiled pattern to match against
flags (int):
Flags that will be passed to the underlying re function (default 0)
func (typing.Callable):
Which underlying `re` function to call. Valid options are
`re.fullmatch`, `re.search`, and `re.match`; the default `None`
means `re.fullmatch`. For performance reasons, the pattern is
always precompiled using `re.compile`.
.. versionadded:: 19.2.0
.. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern.
Nz'func' must be one of {}.z, c 3 �\ # � U H" o=( a UR =( d S v � M$ g7f)�NoneN)rH )�.0�es r" � <genexpr>� matches_re.<locals>.<genexpr>� s! � � �N�=M��(�a�j�j�3�V�3�=M�s �*,zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)�re� fullmatch�search�match�format�join�sorted�setrW r3 r r7 �compilerR )�regex�flags�func� valid_funcsr= rV rU s r" r r � s� � �* �<�<��r�y�y�"�(�(�;�K� � �)�0�0� �I�I��N�S��=M�N�N�
�
��
��o� ��%��!�!� �f�C��C�.� ����*�*�U�*�� �r�x�x�� �]�]�
�
���� � �^�^�
� �&�&�
� �w� 3�3r# c �. � \ rS rSr\" 5 rS rS rSrg)�_OptionalValidator�� c �0 � Uc g U R XU5 g �N�� validator�r9 r: r; r< s r" r> �_OptionalValidator.__call__� s � � �=� � ���t�5�)r# c �$ � SU R < S3$ )Nz<optional validator for z or None>rt rC s r" rD �_OptionalValidator.__repr__� s � �)�$�.�.�);�9�E�Er# r% N) rH rI rJ rK r
ru r> rD rL r% r# r" rp rp � s � ���I�*� Fr# rp c �v � [ U [ [ 45 ( a [ [ U 5 5 $ [ U 5 $ )a�
A validator that makes an attribute optional. An optional attribute is one
which can be set to `None` in addition to satisfying the requirements of
the sub-validator.
Args:
validator
(typing.Callable | tuple[typing.Callable] | list[typing.Callable]):
A validator (or validators) that is used for non-`None` values.
.. versionadded:: 15.1.0
.. versionchanged:: 17.1.0 *validator* can be a list of validators.
.. versionchanged:: 23.1.0 *validator* can also be a tuple of validators.
)r3 �list�tuplerp r rt s r" r r � s0 � � �)�d�E�]�+�+�!�-� �":�;�;� �i� (�(r# c �: � \ rS rSr\" 5 r\" SS9rS rS rSr g)� _InValidator�� F)�hashc �� � X0R ; nU( d: SUR SU R < SU< S3n[ UUU R U5 eg ! [ a Sn NPf = f)NFr/ z
' must be in r1 �))�optionsr7 r5 �_original_optionsrW )r9 r: r; r< �
in_optionsr= s r" r> �_InValidator.__call__� sx � � � �,�,�.�J� ��d�i�i�[�
�d�.D�.D�-G�v�e�Y�VW�X�C� ����&�&�� �
� �� � � �J� �s �A � A!� A!c �$ � SU R < S3$ )Nz <in_ validator with options rA )r� rC s r" rD �_InValidator.__repr__� s � �-�d�.D�.D�-G�q�I�Ir# r% N)
rH rI rJ rK r
r� r� r> rD rL r% r# r" r~ r~ � s � ��h�G� �E�*��
� Jr# r~ c �r � U n[ U [ [ [ 45 ( a [ U 5 n [ X5 $ )a�
A validator that raises a `ValueError` if the initializer is called with a
value that does not belong in the *options* provided.
The check is performed using ``value in options``, so *options* has to
support that operation.
To keep the validator hashable, dicts, lists, and sets are transparently
transformed into a `tuple`.
Args:
options: Allowed options.
Raises:
ValueError:
With a human readable error message, the attribute (of type
`attrs.Attribute`), the expected options, and the value it got.
.. versionadded:: 17.1.0
.. versionchanged:: 22.1.0
The ValueError was incomplete until now and only contained the human
readable error message. Now it contains all the information that has
been promised since 17.1.0.
.. versionchanged:: 24.1.0
*options* that are a list, dict, or a set are now transformed into a
tuple to keep the validator hashable.
)r3 r{ �dictri r| r~ )r� � repr_optionss r" r r s1 � �8 �L��'�D�$��,�-�-���.�� �� .�.r# c � � \ rS rSrS rS rSrg)�_IsCallableValidatori$ c � � [ U5 ( d. Sn[ UR UR X3R S9US9eg)r. z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r5 r< �actual)r= r< N)�callabler
rf r5 r6 )r9 r: r; r< �messages r" r> � _IsCallableValidator.__call__& sN � � ����8�
� #��N�N� ���%��� #� � � �
� r# c � � g)Nz<is_callable validator>r% rC s r" rD � _IsCallableValidator.__repr__6 s � �(r# r% N)rH rI rJ rK r> rD rL r% r# r" r� r� $ s � �� )r# r� c � � [ 5 $ )ad
A validator that raises a `attrs.exceptions.NotCallableError` if the
initializer is called with a value for this particular attribute that is
not callable.
.. versionadded:: 19.1.0
Raises:
attrs.exceptions.NotCallableError:
With a human readable error message containing the attribute
(`attrs.Attribute`) name, and the value it got.
)r� r% r# r" r r : s
� � � !�!r# c �Z � \ rS rSr\" \" 5 S9r\" S\" \" 5 5 S9rS r S r
Sr g)�
_DeepIterableiJ rt N��defaultru c �x � U R b U R XU5 U H nU R XU5 M g�r. N��iterable_validator�member_validator)r9 r: r; r< �members r" r> �_DeepIterable.__call__Q s: � � � "� "� .� � #� #�D�� 6��F� � !� !�$�f� 5� r# c �h � U R c SOSU R < 3nSU SU R < S3$ )N� � z <deep_iterable validator forz iterables of rA r� )r9 �iterable_identifiers r" rD �_DeepIterable.__repr__[ sP � � �&�&�.�
��T�,�,�/�0� � +�+>�*?� �T� 2� 2� 5�Q�
8�
r# r% ) rH rI rJ rK r
r r� r r� r> rD rL r% r# r" r� r� J s0 � � � �
�6�� ���� � 7���6�
r# r� c �^ � [ U [ [ 45 ( a [ U 6 n [ X5 $ )a
A validator that performs deep validation of an iterable.
Args:
member_validator: Validator to apply to iterable members.
iterable_validator:
Validator to apply to iterable itself (optional).
Raises
TypeError: if any sub-validators fail
.. versionadded:: 19.1.0
)r3 r{ r| r r� �r� r� s r" r r g s. � � �"�T�5�M�2�2� �!1�2�� �)� >�>r# c �p � \ rS rSr\" \" 5 S9r\" \" 5 S9r\" S\" \" 5 5 S9r S r
S r Sr g)� _DeepMappingi{ rt Nr� c � � U R b U R XU5 U H) nU R XU5 U R XX4 5 M+ gr� )�mapping_validator�
key_validator�value_validator)r9 r: r; r< �keys r" r> �_DeepMapping.__call__� sL � � � !� !� -� � "� "�4�u� 5��C� � � �t�3� /� � � ��U�Z� 8� r# c �@ � SU R < SU R < S3$ )Nz,<deep_mapping validator for objects mapping z to rA )r� r� rC s r" rD �_DeepMapping.__repr__� s( � �=�d�>P�>P�=S�SW�X\�Xl�Xl�Wo�op�q�qr# r% )
rH rI rJ rK r
r r� r� r r� r> rD rL r% r# r" r� r� { s9 � ��[�]�3�M� �{�}�5�O� �t�x� �
�7N�O�� 9�rr# r� c � � [ XU5 $ )ag
A validator that performs deep validation of a dictionary.
Args:
key_validator: Validator to apply to dictionary keys.
value_validator: Validator to apply to dictionary values.
mapping_validator:
Validator to apply to top-level mapping attribute (optional).
.. versionadded:: 19.1.0
Raises:
TypeError: if any sub-validators fail
)r� )r� r� r� s r" r r � s � �" �
�8I� J�Jr# c �J � \ rS rSr\" 5 r\" 5 r\" 5 rS rS r Sr
g)�_NumberValidatori� c � � U R X0R 5 ( d7 SUR SU R SU R SU 3n[ U5 eg)r. r/ r0 r� �: N)� compare_func�boundr5 �
compare_oprW r8 s r" r> �_NumberValidator.__call__� sS � � � � ��
�
�3�3��d�i�i�[�
�4�?�?�*;�1�T�Z�Z�L��5�'�R�C� �S�/� !� 4r# c �< � SU R SU R S3$ )Nz<Validator for x r� rA )r� r� rC s r" rD �_NumberValidator.__repr__� s � �"�4�?�?�"3�1�T�Z�Z�L��B�Br# r% N) rH rI rJ rK r
r� r� r� r> rD rL r% r# r" r� r� � s" � � �H�E���J��8�L�"�Cr# r� c �8 � [ U S[ R 5 $ )z�
A validator that raises `ValueError` if the initializer is called with a
number larger or equal to *val*.
The validator uses `operator.lt` to compare the values.
Args:
val: Exclusive upper bound for values.
.. versionadded:: 21.3.0
�<)r� �operatorr ��vals r" r r � � � � �C��h�k�k� 2�2r# c �8 � [ U S[ R 5 $ )z�
A validator that raises `ValueError` if the initializer is called with a
number greater than *val*.
The validator uses `operator.le` to compare the values.
Args:
val: Inclusive upper bound for values.
.. versionadded:: 21.3.0
z<=)r� r� r r� s r" r r � � � � �C��x�{�{� 3�3r# c �8 � [ U S[ R 5 $ )z�
A validator that raises `ValueError` if the initializer is called with a
number smaller than *val*.
The validator uses `operator.ge` to compare the values.
Args:
val: Inclusive lower bound for values
.. versionadded:: 21.3.0
z>=)r� r� r r� s r" r r � r� r# c �8 � [ U S[ R 5 $ )z�
A validator that raises `ValueError` if the initializer is called with a
number smaller or equal to *val*.
The validator uses `operator.ge` to compare the values.
Args:
val: Exclusive lower bound for values
.. versionadded:: 21.3.0
rA )r� r� r r� s r" r r � r� r# c �. � \ rS rSr\" 5 rS rS rSrg)�_MaxLengthValidatori� c � � [ U5 U R :� a3 SUR SU R S[ U5 3n[ U5 eg)r. � Length of 'z
' must be <= r� N)�len�
max_lengthr5 rW r8 s r" r> � _MaxLengthValidator.__call__� �H � � �u�:���� '� �� � �{�-����7H��3�u�:�,�W�C� �S�/� !� (r# c �" � SU R S3$ )Nz<max_len validator for rA )r� rC s r" rD � _MaxLengthValidator.__repr__� � � �(�� � �(9��;�;r# r% N) rH rI rJ rK r
r� r> rD rL r% r# r" r� r� � � � ���J�"�<r# r� c � � [ U 5 $ )z�
A validator that raises `ValueError` if the initializer is called
with a string or iterable that is longer than *length*.
Args:
length (int): Maximum length of the string or iterable
.. versionadded:: 21.3.0
)r� ��lengths r" r r � � � �v� &�&r# c �. � \ rS rSr\" 5 rS rS rSrg)�_MinLengthValidatori c � � [ U5 U R : a3 SUR SU R S[ U5 3n[ U5 eg)r. r� z
' must be >= r� N)r� �
min_lengthr5 rW r8 s r" r> � _MinLengthValidator.__call__ r� r# c �" � SU R S3$ )Nz<min_len validator for rA )r� rC s r" rD � _MinLengthValidator.__repr__ r� r# r% N) rH rI rJ rK r
r� r> rD rL r% r# r" r� r� r� r# r� c � � [ U 5 $ )z�
A validator that raises `ValueError` if the initializer is called
with a string or iterable that is shorter than *length*.
Args:
length (int): Minimum length of the string or iterable
.. versionadded:: 22.1.0
)r� r� s r" r r r� r# c �. � \ rS rSr\" 5 rS rS rSrg)�_SubclassOfValidatori, c � � [ X0R 5 ( d: SUR SU R < SU< S3n[ UUU R U5 eg)r. r/ z' must be a subclass of r1 r2 N)�
issubclassr4 r5 r7 r8 s r" r> � _SubclassOfValidator.__call__0 sY � � �%���+�+��d�i�i�[� 8����
�V�E�9�TV�W�C����� � �� �
� ,r# c �$ � SU R < S3$ )Nz <subclass_of validator for type rA rB rC s r" rD � _SubclassOfValidator.__repr__= rF r# r% NrG r% r# r" r� r� , rM r# r� c � � [ U 5 $ )a�
A validator that raises a `TypeError` if the initializer is called with a
wrong type for this particular attribute (checks are performed using
`issubclass` therefore it's also valid to pass a tuple of types).
Args:
type (type | tuple[type, ...]): The type(s) to check for.
Raises:
TypeError:
With a human readable error message, the attribute (of type
`attrs.Attribute`), the expected type, and the value it got.
)r� rB s r" � _subclass_ofr� A rO r# c �t � \ rS rSr\" 5 r\" \" S5 S9r\" \" \ " \
5 \ " \ 5 S9S9r
S rS rSrg )
�
_NotValidatoriR zCnot_ validator child '{validator!r}' did not raise a captured error)� converterr� rt c �� � U R XU5 [ U R R U R U R S9UU R UU R 5 e! U R a g f = f)N�ru � exc_types)ru rW r= rf r� rv s r" r> �_NotValidator.__call__b su � � � �N�N�4�u� -� ������ "�n�n� "�n�n� � � �������� �
�� �~�~� � � �s �A# �#A6�5A6c �@ � SU R < SU R < S3$ )Nz<not_ validator wrapping z , capturing rA r� rC s r" rD �_NotValidator.__repr__s s" � �*�4�>�>�*<�L�� � �HZ�Z[�\�\r# r% N)rH rI rJ rK r
ru r r= r r� � Exceptionr r| r� r> rD rL r% r# r" r� r� R sO � ���I�
�!�
-�
� �C� � � )�)� 4� *�5� 1�
��I��"]r# r� )r= r� c �X � [ U5 n[ XU5 $ ! [ a U4n Nf = f)a�
A validator that wraps and logically 'inverts' the validator passed to it.
It will raise a `ValueError` if the provided validator *doesn't* raise a
`ValueError` or `TypeError` (by default), and will suppress the exception
if the provided validator *does*.
Intended to be used with existing validators to compose logic without
needing to create inverted variants, for example, ``not_(in_(...))``.
Args:
validator: A validator to be logically inverted.
msg (str):
Message to raise if validator fails. Formatted with keys
``exc_types`` and ``validator``.
exc_types (tuple[type, ...]):
Exception type(s) to capture. Other types raised by child
validators will not be intercepted and pass through.
Raises:
ValueError:
With a human readable error message, the attribute (of type
`attrs.Attribute`), the validator that failed to raise an
exception, the value it got, and the expected exception types.
.. versionadded:: 22.2.0
)r| r7 r� )ru r= r� s r" r r w s8 � �:!��)�$� � ��� 3�3�� � !� �L� �!�s � �
)�)c �. � \ rS rSr\" 5 rS rS rSrg)� _OrValidatori� c � � U R H
n U" XU5 g SU R < SU< 3n[ U5 e! [ a M= f = f)NzNone of z satisfied for value )�
validatorsr� rW )r9 r: r; r< �vr= s r" r> �_OrValidator.__call__� s\ � �� � �A�
��$�e�$� �
!� �� � �+�+@�� �J����o� ��
�
��
�s � =�
A �
A c �$ � SU R < S3$ )Nz<or validator wrapping rA )r� rC s r" rD �_OrValidator.__repr__� s � �(�� � �(;�1�=�=r# r% N) rH rI rJ rK r
r� r> rD rL r% r# r" r� r� � s � ���J�
�>r# r� c � � / nU H6 nUR [ U[ 5 ( a UR OU/5 M8 [ [ U5 5 $ )a�
A validator that composes multiple validators into one.
When called on a value, it runs all wrapped validators until one of them is
satisfied.
Args:
validators (~collections.abc.Iterable[typing.Callable]):
Arbitrary number of validators.
Raises:
ValueError:
If no validator is satisfied. Raised with a human-readable error
message listing all the wrapped validators and the value that
failed all of them.
.. versionadded:: 24.1.0
)�extendr3 r� r� r| )r� �valsr� s r" r r � sD � �& �D�
�� � � �J�q�,�$?�$?�A�L�L�a�S�I� � ��d� � $�$r# )r Nrs )5�__doc__r� rb �
contextlibr r �_configr r �_maker r r
r �
convertersr �
exceptionsr
�__all__r r r r+ r rR r rp r r~ r r� r r� r r� r r� r r r r r� r r� r r� r� r� rW r7 r r� r r% r# r" �<module>r s ��� � � %� � ;� 5� 5� '� (� ��.%�$ $� �!� �!�" �E��4�0�A� A� 1�A�(&�" �E�$�d�+�F� F� ,�F�*-4�` �E��4�0�
F�
F� 1�
F�)�* �E��4�0�J� J� 1�J�. /�F �E��D�1�)� )� 2�)�*
"� �E��4�0�
�
� 1�
�8?�( �E��4�0�r� r� 1�r�(K�( �E�$�d�+�C� C� ,�C�" 3� 4� 4� 3� �E�$�d�+� <� <� ,� <�
'� �E�$�d�+� <� <� ,� <�
'� �E��4�0�A� A� 1�A�(&�" �E��4�0�!]� !]� 1�!]�H �J� �+B� !4�H �E��4�0�>� >� 1�>�&%r#