| Server IP : 157.230.181.24 / Your IP : 216.73.217.11 Web Server : Apache/2.4.58 (Ubuntu) System : Linux conductive 6.8.0-117-generic #117-Ubuntu SMP PREEMPT_DYNAMIC Tue May 5 19:26:24 UTC 2026 x86_64 User : ( 1000) PHP Version : 8.3.31 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python3/dist-packages/packaging/__pycache__/ |
Upload File : |
�
R" fh� � � � d Z ddlZddlZddlZddlmZmZmZmZm Z m
Z
m Z m Z ddl
mZ ddlmZ e eef Z e de�� Zeeegef Zd ed
efd �Z G d � d
e� Z G d� dej2 �� Z G d� de� Z ej8 d� Z d ed
ee fd�Z dee d
efd�Z ded
efd�Z dee dee d
e
ee ee f fd�Z! G d � d e� Z"y) z�
.. testsetup::
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
from packaging.version import Version
� N)�Callable�Iterable�Iterator�List�Optional�Tuple�TypeVar�Union� )�canonicalize_version)�Version�UnparsedVersionVar)�bound�version�returnc �< � t | t � s t | � } | S �N)�
isinstancer
)r s �6/usr/lib/python3/dist-packages/packaging/specifiers.py�_coerce_versionr s � � �g�w� '��'�"�� �N� c � � e Zd ZdZy)�InvalidSpecifiera
Raised when attempting to create a :class:`Specifier` with a specifier
string that is invalid.
>>> Specifier("lolwat")
Traceback (most recent call last):
...
packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat'
N)�__name__�
__module__� __qualname__�__doc__� r r r r s � �r r c �x � e Zd Zej defd�� Zej defd�� Zej de de
fd�� Z e ej de
e
fd�� � Zej de
ddfd �� Zej dd
ed e
e
de
fd �� Zej dd
ee d e
e
dee fd�� Zy)�
BaseSpecifierr c � � y)z�
Returns the str representation of this Specifier-like object. This
should be representative of the Specifier itself.
Nr ��selfs r �__str__zBaseSpecifier.__str__+ � � r c � � y)zF
Returns a hash value for this Specifier-like object.
Nr r" s r �__hash__zBaseSpecifier.__hash__2 r% r �otherc � � y)z�
Returns a boolean representing whether or not the two Specifier-like
objects are equal.
:param other: The other object to check against.
Nr �r# r( s r �__eq__zBaseSpecifier.__eq__8 r% r c � � y)z�Whether or not pre-releases as a whole are allowed.
This can be set to either ``True`` or ``False`` to explicitly enable or disable
prereleases or it can be set to ``None`` (the default) to use default semantics.
Nr r" s r � prereleaseszBaseSpecifier.prereleasesA r% r �valueNc � � y)zQSetter for :attr:`prereleases`.
:param value: The value to set.
Nr �r# r. s r r- zBaseSpecifier.prereleasesJ r% r �itemr- c � � y)zR
Determines if the given item is contained within this specifier.
Nr )r# r1 r- s r �containszBaseSpecifier.containsQ r% r �iterablec � � y)z�
Takes an iterable of items and filters them so that only items which
are contained within this specifier are allowed in it.
Nr )r# r4 r- s r �filterzBaseSpecifier.filterW r% r r )r r r �abc�abstractmethod�strr$ �intr' �object�boolr+ �propertyr r- �setterr3 r r r r6 r r r r r * s7 � ���� �� � � � ��� �#� � � �
��� �F� �t� � � � ���� �X�d�^� � � � � ��� �� �$� � � � ��� �S� �x��~� �� � � �
���TX� � �!3�4� �CK�D�>� � �$� %� � � r r )� metaclassc � � e Zd ZdZdZdZ ej dez ez dz ej ej z � Z
dddd d
d d d
d�Z d0de de
e ddfd�Zedefd�� Zej$ deddfd�� Zede fd�� Zede fd�� Zde fd�Zde fd�Zedee e f fd�� Zdefd �Zd edefd �Z d e de fd �Z d!e de defd"�Z d!e de defd#�Z!d!e de defd$�Z"d!e de defd%�Z#d!e de defd&�Z$d!e d'e defd(�Z%d!e d'e defd)�Z&d!e de defd*�Z'd+e(e e f defd,�Z) d1d+e*de
e defd-�Z+ d1d.e,e- de
e de.e- fd/�Z/y)2� Specifiera? This class abstracts handling of version specifiers.
.. tip::
It is generally not required to instantiate this manually. You should instead
prefer to work with :class:`SpecifierSet` instead, which can parse
comma-separated version specifiers (which is what package metadata contains).
z8
(?P<operator>(~=|==|!=|<=|>=|<|>|===))
a�
(?P<version>
(?:
# The identity operators allow for an escape hatch that will
# do an exact string match of the version you wish to install.
# This will not be parsed by PEP 440 and we cannot determine
# any semantic meaning from it. This operator is discouraged
# but included entirely as an escape hatch.
(?<====) # Only match for the identity operator
\s*
[^\s;)]* # The arbitrary version can be just about anything,
# we match everything except for whitespace, a
# semi-colon for marker support, and a closing paren
# since versions can be enclosed in them.
)
|
(?:
# The (non)equality operators allow for wild card and local
# versions to be specified so we have to define these two
# operators separately to enable that.
(?<===|!=) # Only match for equals and not equals
\s*
v?
(?:[0-9]+!)? # epoch
[0-9]+(?:\.[0-9]+)* # release
# You cannot use a wild card and a pre-release, post-release, a dev or
# local version together so group them with a | and make them optional.
(?:
\.\* # Wild card syntax of .*
|
(?: # pre release
[-_\.]?
(alpha|beta|preview|pre|a|b|c|rc)
[-_\.]?
[0-9]*
)?
(?: # post release
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
)?
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
(?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
)?
)
|
(?:
# The compatible operator requires at least two digits in the
# release segment.
(?<=~=) # Only match for the compatible operator
\s*
v?
(?:[0-9]+!)? # epoch
[0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *)
(?: # pre release
[-_\.]?
(alpha|beta|preview|pre|a|b|c|rc)
[-_\.]?
[0-9]*
)?
(?: # post release
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
)?
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
)
|
(?:
# All other operators only allow a sub set of what the
# (non)equality operators do. Specifically they do not allow
# local versions to be specified nor do they allow the prefix
# matching wild cards.
(?<!==|!=|~=) # We have special cases for these
# operators so we want to make sure they
# don't match here.
\s*
v?
(?:[0-9]+!)? # epoch
[0-9]+(?:\.[0-9]+)* # release
(?: # pre release
[-_\.]?
(alpha|beta|preview|pre|a|b|c|rc)
[-_\.]?
[0-9]*
)?
(?: # post release
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
)?
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
)
)
z^\s*z\s*$�
compatible�equal� not_equal�less_than_equal�greater_than_equal� less_than� greater_than� arbitrary)�~=�==z!=�<=�>=�<�>�===N�specr- r c �� � | j j |� }|st d|� d�� �|j d� j � |j d� j � f| _ || _ y)a� Initialize a Specifier instance.
:param spec:
The string representation of a specifier which will be parsed and
normalized before use.
:param prereleases:
This tells the specifier if it should accept prerelease versions if
applicable or not. The default of ``None`` will autodetect it from the
given specifiers.
:raises InvalidSpecifier:
If the given specifier is invalid (i.e. bad syntax).
zInvalid specifier: '�'�operatorr N)�_regex�searchr �group�strip�_spec� _prereleases)r# rQ r- �matchs r �__init__zSpecifier.__init__� so � � � � �"�"�4�(���"�%9�$��q�#A�B� B�
�K�K�
� #� )� )� +� �K�K� � "� (� (� *�'
��
� (��r c � � | j � | j S | j \ }}|dv r1|dk( r|j d� r|d d }t |� j ryy)N)rK rM rL rJ rP rK �.*���TF)rZ rY �endswithr
�
is_prerelease)r# rT r s r r- zSpecifier.prereleases� sm � � � � � (��$�$� $�
!�J�J���'� �6� 6� �4� �G�$4�$4�T�$:�!�#�2�,�� �w� �-�-��r r. c � � || _ y r �rZ r0 s r r- zSpecifier.prereleases �
� � !��r c � � | j d S )z`The operator of this specifier.
>>> Specifier("==1.2.3").operator
'=='
r �rY r" s r rT zSpecifier.operator � � � �z�z�!�}� r c � � | j d S )zaThe version of this specifier.
>>> Specifier("==1.2.3").version
'1.2.3'
r rf r" s r r zSpecifier.version rg r c � � | j �d| j ��nd}d| j j � dt | � �|� d�S )aT A representation of the Specifier that shows all internal state.
>>> Specifier('>=1.0.0')
<Specifier('>=1.0.0')>
>>> Specifier('>=1.0.0', prereleases=False)
<Specifier('>=1.0.0', prereleases=False)>
>>> Specifier('>=1.0.0', prereleases=True)
<Specifier('>=1.0.0', prereleases=True)>
�, prereleases=� rN �(�)>)rZ r- � __class__r r9 �r# �pres r �__repr__zSpecifier.__repr__$ sU � � � � �,� �T� -� -� 0� 1�� � �4�>�>�*�*�+�1�S��Y�M�#��b�A�Ar c �4 � dj | j � S )z�A string representation of the Specifier that can be round-tripped.
>>> str(Specifier('>=1.0.0'))
'>=1.0.0'
>>> str(Specifier('>=1.0.0', prereleases=False))
'>=1.0.0'
z{}{})�formatrY r" s r r$ zSpecifier.__str__6 s � � �v�}�}�d�j�j�)�)r c �x � t | j d | j d dk7 �� }| j d |fS )Nr r rJ ��strip_trailing_zero)r rY )r# �canonical_versions r �_canonical_speczSpecifier._canonical_spec@ s> � � 0� �J�J�q�M�!%���A� �$�!6�
�� �z�z�!�}� /�/�/r c �, � t | j � S r )�hashrx r" s r r' zSpecifier.__hash__H s � ��D�(�(�)�)r r( c �� � t |t � r | j t |� � }n t || j � st S | j
|j
k( S # t $ r t cY S w xY w)a> Whether or not the two Specifier-like objects are equal.
:param other: The other object to check against.
The value of :attr:`prereleases` is ignored.
>>> Specifier("==1.2.3") == Specifier("== 1.2.3.0")
True
>>> (Specifier("==1.2.3", prereleases=False) ==
... Specifier("==1.2.3", prereleases=True))
True
>>> Specifier("==1.2.3") == "==1.2.3"
True
>>> Specifier("==1.2.3") == Specifier("==1.2.4")
False
>>> Specifier("==1.2.3") == Specifier("~=1.2.3")
False
)r r9 rn r �NotImplementedrx r* s r r+ zSpecifier.__eq__K si � �& �e�S� !�
&� ���s�5�z�2�� �E�4�>�>�2�!� !��#�#�u�'<�'<�<�<�� $�
&�%�%�
&�s �A" �"A4�3A4�opc �> � t | d| j | � �� }|S )N� _compare_)�getattr�
_operators)r# r} �operator_callables r �
_get_operatorzSpecifier._get_operatorh s+ � �.5� �I�d�o�o�b� 1� 2�3�/
�� !� r � prospectivec
�� � t t t j t t |� � � d d � }|dz
} | j
d� ||� xr | j
d� ||� S )N���r^ rM rK )�
_version_join�list� itertools� takewhile�_is_not_suffix�_version_splitr� )r# r� rQ �prefixs r �_compare_compatiblez Specifier._compare_compatiblen sw � � � ��$�$�^�^�D�5I�J� K�C�R� P�
��
�$���'�t�!�!�$�'� �T�:�
�?W�t�?Q�?Q�RV�?W� ��@
�
r c �D � |j d� r_t |j d�� }t |d d d�� }t |� }t |� }t ||� \ }}|d t |� } | |k( S t
|� }
|
j st
|j � }||
k( S )Nr^ Fru r_ )r` r �publicr� � _pad_version�lenr
�local) r# r� rQ �normalized_prospective�normalized_spec�
split_spec�split_prospective�padded_prospective�_�shortened_prospective� spec_versions r �_compare_equalzSpecifier._compare_equal� s� � � �=�=�� �%9��"�"��&� "� 3�4���9�RW� X�O� (��8�J�
!/�/E� F� � %1�1B�J�$O� !� ��
%7�7H��Z� �$I� !�(�J�6� 6� #�4�=�L�
�%�%� %�k�&8�&8� 9� � �,�.� .r c �( � | j ||� S r )r� �r# r� rQ s r �_compare_not_equalz Specifier._compare_not_equal� s � ��&�&�{�D�9�9�9r c �D � t |j � t |� k S r �r
r� r� s r �_compare_less_than_equalz"Specifier._compare_less_than_equal� � � �
�{�)�)�*�g�d�m�;�;r c �D � t |j � t |� k\ S r r� r� s r �_compare_greater_than_equalz%Specifier._compare_greater_than_equal� r� r �spec_strc � � t |� }||k sy|j s8|j r,t |j � t |j � k( ryy�NFT)r
ra � base_version�r# r� r� rQ s r �_compare_less_thanz Specifier._compare_less_than� sT � � �x� ��
�T�!�� �!�!�k�&?�&?��{�/�/�0�G�D�<M�<M�4N�N� �
r c � � t |� }||kD sy|j s8|j r,t |j � t |j � k( ry|j �,t |j � t |j � k( ryyr� )r
�is_postreleaser� r� r� s r �_compare_greater_thanz Specifier._compare_greater_than� s� � � �x� ��
�T�!�� �"�"�{�'A�'A��{�/�/�0�G�D�<M�<M�4N�N� � � � � (��{�/�/�0�G�D�<M�<M�4N�N� �
r c �h � t |� j � t |� j � k( S r )r9 �lowerr� s r �_compare_arbitraryz Specifier._compare_arbitrary� s& � ��;� �%�%�'�3�t�9�?�?�+<�<�<r r1 c �$ � | j |� S )a; Return whether or not the item is contained in this specifier.
:param item: The item to check for.
This is used for the ``in`` operator and behaves the same as
:meth:`contains` with no ``prereleases`` argument passed.
>>> "1.2.3" in Specifier(">=1.2.3")
True
>>> Version("1.2.3") in Specifier(">=1.2.3")
True
>>> "1.0.0" in Specifier(">=1.2.3")
False
>>> "1.3.0a1" in Specifier(">=1.2.3")
False
>>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True)
True
�r3 �r# r1 s r � __contains__zSpecifier.__contains__� � � �& �}�}�T�"�"r c � � |� | j }t |� }|j r|sy| j | j � } ||| j
� S )al Return whether or not the item is contained in this specifier.
:param item:
The item to check for, which can be a version string or a
:class:`Version` instance.
:param prereleases:
Whether or not to match prereleases with this Specifier. If set to
``None`` (the default), it uses :attr:`prereleases` to determine
whether or not prereleases are allowed.
>>> Specifier(">=1.2.3").contains("1.2.3")
True
>>> Specifier(">=1.2.3").contains(Version("1.2.3"))
True
>>> Specifier(">=1.2.3").contains("1.0.0")
False
>>> Specifier(">=1.2.3").contains("1.3.0a1")
False
>>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1")
True
>>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True)
True
F)r- r ra r� rT r )r# r1 r- �normalized_itemr� s r r3 zSpecifier.contains
sY � �8 � � �*�*�K� *�$�/��
� (� (��� /3�.@�.@�� � �.O�� � �$�,�,�?�?r r4 c # � K � d}g }d|�|ndi}|D ]S }t |� } | j |fi |��s�"|j r |s | j s|j |� �Nd}|�� �U |s|r |D ] }|�� � yyy�w)aO Filter items in the given iterable, that match the specifier.
:param iterable:
An iterable that can contain version strings and :class:`Version` instances.
The items in the iterable will be filtered according to the specifier.
:param prereleases:
Whether or not to allow prereleases in the returned iterator. If set to
``None`` (the default), it will be intelligently decide whether to allow
prereleases or not (based on the :attr:`prereleases` attribute, and
whether the only versions matching are prereleases).
This method is smarter than just ``filter(Specifier().contains, [...])``
because it implements the rule from :pep:`440` that a prerelease item
SHOULD be accepted if no other versions match the given specifier.
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
['1.3']
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")]))
['1.2.3', '1.3', <Version('1.4')>]
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"]))
['1.5a1']
>>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
['1.3', '1.5a1']
>>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
['1.3', '1.5a1']
Fr- NT)r r3 ra r- �append)r# r4 r- �yielded�found_prereleases�kwr �parsed_versions r r6 zSpecifier.filter; s� � �� �< �� ���K�,C�[��
N�� � "�G� ,�W� 5�N� �t�}�}�^�2�r�2� "�/�/� �4�#3�#3�%�,�,�W�5� #�G�!�M� "�( �,�,�
�� �
�
� -�w�s �0A9�AA9�rk Nr )0r r r r �_operator_regex_str�_version_regex_str�re�compile�VERBOSE�
IGNORECASErU r� r9 r r< r\ r= r- r> rT r rq r$ r rx r: r' r; r+ �CallableOperatorr� r
r� r� r� r� r� r� r� r� r
r� �UnparsedVersionr3 r r r r6 r r r rA rA a s� � �� ��\ ��| �R�Z�Z��%�%�(:�:�W�D�
�
�
�R�]�]�"��F� ��� �"�
�
�� �J�(�S� (�H�T�N� (�d� (�4 ��T� � ��. ���"�� "�$� "� �"� � �#� � � � � �� � � �B�#� B�$*�� *� �0��s�C�x� � 0� �0�*�#� *�=�F� =�t� =�:!�� !�(8� !�
�w�
�c�
�d�
�*'/�'� '/�� '/�� '/�R:�g� :�S� :�T� :�<�G� <�3� <�4� <�<�w� <�c� <�d� <��g� �� �� �2 �� �C� �D� �>=�g� =�S� =�T� =�#��s�G�|�!4� #�� #�, DH�,@�#�,@�2:�4�.�,@�
�,@�^ UY�; � �!3�4�; �CK�D�>�; � �$� %�; r rA z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c � � g }| j d� \ }}}|j |xs d� |j d� D ]J }t j |� }|r |j |j
� � �:|j |� �L |S )a Split version into components.
The split components are intended for version comparison. The logic does
not attempt to retain the original version string, so joining the
components back with :func:`_version_join` may not produce the original
version string.
�!�0�.)�
rpartitionr� �split�
_prefix_regexrV �extend�groups)r �result�epochr� �restr1 r[ s r r� r� | s~ � � �F� �'�'��,�N�E�1�d�
�M�M�%�,�3� ��
�
�3�� �� �$�$�T�*�� � �M�M�%�,�,�.� )� �M�M�$� � � �Mr �
componentsc �6 � | ^}}|� ddj |� � �S )z�Join split version components into a version string.
This function assumes the input came from :func:`_version_split`, where the
first component must be the epoch (either empty or numeric), and all other
components numeric.
r� r� )�join)r� r� r� s r r� r� � s' � � �L�E�D��W�A�c�h�h�t�n�%� &�&r �segmentc �. � � t � fd�dD � � S )Nc 3 �@ �K � | ] }�j |� �� � y �wr )�
startswith)�.0r� r� s �r � <genexpr>z!_is_not_suffix.<locals>.<genexpr>� s! �� �� � �'-����6�"��s � )�dev�a�b�rc�post)�any)r� s `r r� r� � s" �� �� �1P�� � � r �left�rightc �� � g g }}|j t t j d� | � � � |j t t j d� |� � � |j | t |d � d � |j |t |d � d � |j ddgt
dt |d � t |d � z
� z � |j ddgt
dt |d � t |d � z
� z � t t j j |� � t t j j |� � fS )Nc �" � | j � S r ��isdigit��xs r �<lambda>z _pad_version.<locals>.<lambda>� s � ����� r c �" � | j � S r r� r� s r r� z _pad_version.<locals>.<lambda>� s � �!�)�)�+� r r r r� ) r� r� r� r� r� �insert�max�chain�
from_iterable)r� r� �
left_split� right_splits r r� r� � s5 � � �"� �J� ���d�9�.�.�/D�d�K�L�M����t�I� /� /�0E�u� M�N�O� ���d�3�z�!�}�-�/�0�1����u�S��Q� � 0� 2�3�4� ���a�#���Q��K��N�(;�c�*�Q�-�>P�(P�!Q�Q�R����q�3�%�#�a��Z��]�);�c�+�a�.�>Q�)Q�"R�R�S�
�Y�_�_�
*�
*�:�
6�7� �Y�_�_�
*�
*�;�
7�8� � r c �H � e Zd ZdZ ddedee ddfd�Zedee fd�� Z e j deddfd �� Z defd
�Z defd �Z de
fd �Zd
ed ef dd fd�Zd
edefd�Zde
fd�Zdee fd�Zdedefd�Z ddedee dee defd�Z ddee dee dee fd�Z y)� SpecifierSetz�This class abstracts handling of a set of version specifiers.
It can be passed a single specifier (``>=3.0``), a comma-separated list of
specifiers (``>=3.0,!=3.1``), or no specifier at all.
N�
specifiersr- r c �� � |j d� D �cg c]# }|j � s�|j � ��% }}t t t |� � | _ || _ yc c}w )aN Initialize a SpecifierSet instance.
:param specifiers:
The string representation of a specifier or a comma-separated list of
specifiers which will be parsed and normalized before use.
:param prereleases:
This tells the SpecifierSet if it should accept prerelease versions if
applicable or not. The default of ``None`` will autodetect it from the
given specifiers.
:raises InvalidSpecifier:
If the given ``specifiers`` are not parseable than this exception will be
raised.
�,N)r� rX � frozenset�maprA �_specsrZ )r# r� r- �s�split_specifierss r r\ zSpecifierSet.__init__� sW � �( 0:�/?�/?��/D�R�!���� �A�G�G�I�R��R� ��I�/?� @�A�� � (���� Ss
�A$�A$c � � | j � | j S | j sy t d� | j D � � S )Nc 3 �4 K � | ] }|j �� � y �wr �r- �r� r� s r r� z+SpecifierSet.prereleases.<locals>.<genexpr>� s � �� �6�Q�1�=�=�6�s �)rZ r� r� r" s r r- zSpecifierSet.prereleases� s? � � � � � (��$�$� $�
�{�{�� �6�$�+�+�6�6�6r r. c � � || _ y r rc r0 s r r- zSpecifierSet.prereleases� rd r c �^ � | j �d| j ��nd}dt | � �|� d�S )a A representation of the specifier set that shows all internal state.
Note that the ordering of the individual specifiers within the set may not
match the input string.
>>> SpecifierSet('>=1.0.0,!=2.0.0')
<SpecifierSet('!=2.0.0,>=1.0.0')>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
<SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
<SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)>
rj rk z<SpecifierSet(rm )rZ r- r9 ro s r rq zSpecifierSet.__repr__� sD � � � � �,� �T� -� -� 0� 1�� � ��D� �}�S�E��4�4r c �X � dj t d� | j D � � � S )an A string representation of the specifier set that can be round-tripped.
Note that the ordering of the individual specifiers within the set may not
match the input string.
>>> str(SpecifierSet(">=1.0.0,!=1.0.1"))
'!=1.0.1,>=1.0.0'
>>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False))
'!=1.0.1,>=1.0.0'
r� c 3 �2 K � | ] }t |� �� � y �wr )r9 r s r r� z'SpecifierSet.__str__.<locals>.<genexpr> s � �� � ;�!�s�1�v� ;�s �)r� �sortedr� r" s r r$ zSpecifierSet.__str__ s" � � �x�x�� ;�t�{�{� ;�;�<�<r c �, � t | j � S r )rz r� r" s r r' zSpecifierSet.__hash__ s � ��D�K�K� � r r( c �� � t |t � r t |� }nt |t � st S t � }t | j
|j
z � |_ | j � |j �|j |_ |S | j � |j �| j |_ |S | j |j k( r| j |_ |S t d� �)a� Return a SpecifierSet which is a combination of the two sets.
:param other: The other object to combine with.
>>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
<SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
>>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
<SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
zFCannot combine SpecifierSets with True and False prerelease overrides.)r r9 r� r| r� r� rZ �
ValueError)r# r( � specifiers r �__and__zSpecifierSet.__and__ s� � � �e�S� !� ��'�E��E�<�0�!� !� �N� �$�T�[�[�5�<�<�%?�@� �� � � � $��);�);�)G�%*�%7�%7�I� "� �� �
�
�
*�u�/A�/A�/I�%)�%6�%6�I� "� �� �
�
�%�"4�"4�
4�%)�%6�%6�I� "� �� � ��
r c � � t |t t f� rt t |� � }nt |t � st S | j
|j
k( S )a� Whether or not the two SpecifierSet-like objects are equal.
:param other: The other object to check against.
The value of :attr:`prereleases` is ignored.
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1")
True
>>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) ==
... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True))
True
>>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1"
True
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0")
False
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2")
False
)r r9 rA r� r| r� r* s r r+ zSpecifierSet.__eq__6 sD � �& �e�c�9� -� .� ��U��,�E��E�<�0�!� !��{�{�e�l�l�*�*r c �, � t | j � S )z7Returns the number of specifiers in this specifier set.)r� r� r" s r �__len__zSpecifierSet.__len__P s � ��4�;�;� � r c �, � t | j � S )z�
Returns an iterator over all the underlying :class:`Specifier` instances
in this specifier set.
>>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str)
[<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>]
)�iterr� r" s r �__iter__zSpecifierSet.__iter__T s � � �D�K�K� � r r1 c �$ � | j |� S )ar Return whether or not the item is contained in this specifier.
:param item: The item to check for.
This is used for the ``in`` operator and behaves the same as
:meth:`contains` with no ``prereleases`` argument passed.
>>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1")
True
>>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1")
True
>>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1")
False
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1")
False
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)
True
r� r� s r r� zSpecifierSet.__contains__^ r� r � installedc � ��� t �t � s t �� ��� | j ��s
�j ry|r!�j rt �j � �t ��fd�| j D � � S )a� Return whether or not the item is contained in this SpecifierSet.
:param item:
The item to check for, which can be a version string or a
:class:`Version` instance.
:param prereleases:
Whether or not to match prereleases with this SpecifierSet. If set to
``None`` (the default), it uses :attr:`prereleases` to determine
whether or not prereleases are allowed.
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3")
True
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3"))
True
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1")
False
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1")
False
>>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1")
True
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True)
True
Fc 3 �D �K � | ] }|j ��� � �� � y�w)r� Nr� )r� r� r1 r- s ��r r� z(SpecifierSet.contains.<locals>.<genexpr>� s �� �� �R��1�:�:�d� �:�<�R�s � )r r
r- ra r� �allr� )r# r1 r- r s `` r r3 zSpecifierSet.containss sm �� �< �$��(��4�=�D�
� � �*�*�K� �t� 1� 1�� ��+�+��4�,�,�-�D� �R�d�k�k�R�R�Rr r4 c �r � |� | j }| j r8| j D ] }|j |t |� �� }� t |� S g }g }|D ]A }t |� }|j r|s|r� |j |� �1|j |� �C |s|r
|� t |� S t |� S )a. Filter items in the given iterable, that match the specifiers in this set.
:param iterable:
An iterable that can contain version strings and :class:`Version` instances.
The items in the iterable will be filtered according to the specifier.
:param prereleases:
Whether or not to allow prereleases in the returned iterator. If set to
``None`` (the default), it will be intelligently decide whether to allow
prereleases or not (based on the :attr:`prereleases` attribute, and
whether the only versions matching are prereleases).
This method is smarter than just ``filter(SpecifierSet(...).contains, [...])``
because it implements the rule from :pep:`440` that a prerelease item
SHOULD be accepted if no other versions match the given specifier.
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
['1.3']
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")]))
['1.3', <Version('1.4')>]
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"]))
[]
>>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
['1.3', '1.5a1']
>>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
['1.3', '1.5a1']
An "empty" SpecifierSet will filter items based on the presence of prerelease
versions in the set.
>>> list(SpecifierSet("").filter(["1.3", "1.5a1"]))
['1.3']
>>> list(SpecifierSet("").filter(["1.5a1"]))
['1.5a1']
>>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"]))
['1.3', '1.5a1']
>>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True))
['1.3', '1.5a1']
r� )r- r� r6 r< r r ra r� )r# r4 r- rQ �filteredr� r1 r� s r r6 zSpecifierSet.filter� s� � �X � � �*�*�K�
�;�;� � � �
P�� �;�;�x�T�+�=N�;�O��
P���>� !�
24�H�:<� � �
*��!0��!6�� "�/�/� �#�)�0�0��6� �O�O�D�)�
*� � 1�k�6I�� -�.�.���>� !r r� )NNr ) r r r r r9 r r< r\ r= r- r> rq r$ r: r' r
r
r; r+ r
r rA r r� r� r3 r r r6 r r r r� r� � st � �� CG�(� �(�19�$� �(�
�(�: �7�X�d�^� 7� �7� ���"�� "�$� "� �"�5�#� 5�* =�� =�!�#� !� �U�>�3�#6� 7� �N� �@+�F� +�t� +�4 �� �!�(�9�-� !�#� � #�T� #�0 '+�$(� 7S� �7S� �d�^�7S� �D�>� 7S�
� 7S�t UY�M"� �!3�4�M"�CK�D�>�M"� �$� %�M"r r� )#r r7 r� r� �typingr r r r r r r r
�utilsr r r
r9 r� r r< r� r r r �ABCMetar rA r� r� r� r� r� r� r� r r r �<module>r s) ��� � � � V� V� V� '� ���� �%�� � 1� �I� ��W�c�N�D� 0�1� ��_� �� � �z� �4 �c�k�k� 4 �nU �
� U �p ��
�
�<�=�
��C� �D��I� �,'�d�3�i� '�C� '��C� �D� � �t�C�y� ��c�� �u�T�#�Y��S� �=Q�7R� �*A"�=� A"r