Your IP : 216.73.216.52
�
^[�i]� � �f � d Z ddlmZ ddlZddlZddlZddlmZmZm Z m
Z
m Z m Z ddl
mZ ddlmZmZ e eef Z e de� � Zeeegef Zdd
�Zd d �Zd d �Z G d
� de� Z G d� dej8 �� Z G d� de � Z ej> d� Z d d�Z!d d�Z"d d�Z#d d�Z$ G d� de � Z%y)!z�
.. testsetup::
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
from packaging.version import Version
� )� annotationsN)�Callable�Final�Iterable�Iterator�TypeVar�Union� )�canonicalize_version)�InvalidVersion�Version�UnparsedVersionVar)�boundc �` � t | t � s t | � } | S | S # t $ r Y y w xY w�N)�
isinstancer
r ��versions ��/build/snapcraft-certbot-8ace4148c346cc61c23dfdbf9a13f72e/parts/certbot/install/lib/python3.12/site-packages/packaging/specifiers.py�_coerce_versionr s: � � �g�w� '� � �g�&�G� �N�7�N�� � �� �s � ! � -�-c �& � | j d �� S )N)�local�� __replace__r s r �_public_versionr # s � � � � �T� � *�*� c �, � | j d d d d �� S )N)�pre�post�devr r r s r �
_base_versionr! ' s � � � � �4�d��D� � I�Ir 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 �J � e Zd ZdZdZed d�� Zej d d�� Z ej d
d�� Z
ej dd�� Z eej dd�� � Z e j dd�� Z ej ddd
�� Zej d dd �� Zy )�
BaseSpecifierr( )�_strc � � t | � S )z Internal property for match_args��str��selfs r r+ zBaseSpecifier._str; s � � �4�y�r c � � y)z�
Returns the str representation of this Specifier-like object. This
should be representative of the Specifier itself.
Nr( r/ s r �__str__zBaseSpecifier.__str__@ � � r c � � y)zF
Returns a hash value for this Specifier-like object.
Nr( r/ s r �__hash__zBaseSpecifier.__hash__G r3 r c � � 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( �r0 �others r �__eq__zBaseSpecifier.__eq__M r3 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.prereleasesV r3 r c � � y)zQSetter for :attr:`prereleases`.
:param value: The value to set.
Nr( �r0 �values r r; zBaseSpecifier.prereleases_ r3 r Nc � � y)zR
Determines if the given item is contained within this specifier.
Nr( �r0 �itemr; s r �containszBaseSpecifier.containsf r3 r c � � 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( )r0 �iterabler; s r �filterzBaseSpecifier.filterl r3 r ��returnr. �rG �int�r8 �objectrG �bool�rG � bool | None)r> rL rG �Noner )rA r. r; rN rG rL �rD z Iterable[UnparsedVersionVar]r; rN rG z Iterator[UnparsedVersionVar])r$ r% r& � __slots__�__match_args__�propertyr+ �abc�abstractmethodr2 r5 r9 r; �setterrB rE r( r r r* r* 7 s� � ��I� �N�
�� �� ��� � � � ��� � � �
��� � � � ���� � � � � ��� � � � ��� � � �
���QU� �4� �CN� � %� � � r r* )� metaclassc � � e Zd ZU dZdZdZdZ ej dez ez dz ej ej z � Z dddd d
d d d
d�Z de
d< d*d+d�Zd,d�Zd-d�Zed.d�� Zej& d/d�� Zed0d�� Zed0d�� Zd0d�Zd0d�Zed1d�� Zd2d �Zd3d �Zd4d �Zd5d �Z d5d �Z d5d!�Z d5d"�Z d5d#�Z d6d$�Z!d6d%�Z"d7d&�Z#d8d'�Z$d9d:d(�Z% d9 d;d)�Z&y)<� 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).
)� _prereleases�_spec�
_spec_versionz8
(?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*�
compatible�equal� not_equal�less_than_equal�greater_than_equal� less_than� greater_than� arbitrary)�~=�==�!=z<=�>=�<�>�===r �
_operatorsNc � � | j j |� }|st d|��� �|j d� j � |j d� j � f| _ || _ d| _ 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� fullmatchr# �group�stripr[ rZ r\ )r0 �specr; �matchs r �__init__zSpecifier.__init__� sw � � � � �%�%�d�+���"�%8���#A�B� B�
�K�K�
� #� )� )� +� �K�K� � "� (� (� *�'
��
� (��� :>��r c � � | j �!| j d |k( r| j d S t |� }|�y||f| _ |S )zDOne element cache, as only one spec Version is needed per Specifier.Nr r
)r\ r )r0 r �version_specifiers r �_get_spec_versionzSpecifier._get_spec_version sY � � � � � )�d�.@�.@��.C�w�.N��%�%�a�(� (� +�G� 4�� � $�� %�'8� 9��� � r c �0 � | j |� }|�J �|S )z�Get spec version, asserting it's valid (not for === operator).
This method should only be called for operators where version
strings are guaranteed to be valid PEP 440 versions (not ===).
)rx )r0 r � spec_versions r �_require_spec_versionz Specifier._require_spec_version s& � � �-�-�g�6� ��'�'�'��r c �� � | j � | j S | j \ }}|dk7 r8|dk( r|j d� ry| j |� }|�y |j ryy)Nrg rf �.*FT)rZ r[ �endswithrx �
is_prerelease)r0 rn � version_strr s r r; zSpecifier.prereleases% sy � � � � � (��$�$� $� !%�
�
� ��+� �t� � �4� �K�$8�$8��$>� � �,�,�[�9�G���� �$�$��r c � � || _ y r �rZ r= s r r; zSpecifier.prereleasesB �
� � !��r c � � | j d S )z`The operator of this specifier.
>>> Specifier("==1.2.3").operator
'=='
r �r[ r/ s r rn zSpecifier.operatorF � � � �z�z�!�}� r c � � | j d S )zaThe version of this specifier.
>>> Specifier("==1.2.3").version
'1.2.3'
r
r� r/ s r r zSpecifier.versionO r� 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=� ri �(�)>)rZ r; � __class__r$ r. �r0 r s r �__repr__zSpecifier.__repr__X 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{}{})�formatr[ r/ s r r2 zSpecifier.__str__j s � � �v�}�}�d�j�j�)�)r c � � | j \ }}|dk( s|j d� r||fS | j |� }t ||dk7 �� }||fS )Nrk r} re ��strip_trailing_zero)r[ r~ r{ r )r0 rn r rz �canonical_versions r �_canonical_speczSpecifier._canonical_spect sc � � �J�J���'� �u� �� 0� 0�� 6��W�$� $��1�1�'�:� � 0� �x�4�/?�
�� �*�*�*r c �, � t | j � S r )�hashr� r/ s r r5 zSpecifier.__hash__� s � ��D�(�(�)�)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 r. r� r# �NotImplementedr� r7 s r r9 zSpecifier.__eq__� si � �& �e�S� !�
&� ���s�5�z�2�� �E�4�>�>�2�!� !��#�#�u�'<�'<�<�<�� $�
&�%�%�
&�s �A" �"A4�3A4c �> � t | d| j | � �� }|S )N� _compare_)�getattrrl )r0 �op�operator_callables r �
_get_operatorzSpecifier._get_operator� s+ � �.5� �I�d�o�o�b� 1� 2�3�/
�� !� r c
�� � t t t j t t |� � � d d � }|dz
} | j
d� ||� xr | j
d� ||� S )N���r} rh rf )�
_version_join�list� itertools� takewhile�_is_not_suffix�_version_splitr� )r0 � prospectivers �prefixs r �_compare_compatiblez Specifier._compare_compatible� sw � � � ��$�$�^�^�D�5I�J� K�C�R� P�
��
�$���'�t�!�!�$�'� �T�:�
�?W�t�?Q�?Q�RV�?W� ��@
�
r c �: � |j d� r^t t |� d�� }t |d d d�� }t |� }t |� }t ||� \ }}|d t |� } | |k( S | j
|� }
|
j s t |� }||
k( S )Nr} Fr� ���)r~ r r r� � _pad_version�lenr{ r ) r0 r� rs �normalized_prospective�normalized_spec�
split_spec�split_prospective�padded_prospective�_�shortened_prospectiverz s 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� �5�5�d�;�L�
�%�%� -�k� :� � �,�.� .r c �( � | j ||� S r )r� �r0 r� rs s r �_compare_not_equalz Specifier._compare_not_equal� s � ��&�&�{�D�9�9�9r c �< � t |� | j |� k S r �r r{ r� s r �_compare_less_than_equalz"Specifier._compare_less_than_equal� � � � �{�+�t�/I�/I�$�/O�O�Or c �< � t |� | j |� k\ S r r� r� s r �_compare_greater_than_equalz%Specifier._compare_greater_than_equal� r� r c � � | j |� }||k sy|j s$|j rt |� t |� k( ryy�NFT)r{ r r! �r0 r� �spec_strrs s r �_compare_less_thanz Specifier._compare_less_than� sO � � �)�)�(�3��
�T�!�� �"�"��)�)� �k�*�m�D�.A�A��
r c �� � | j |� }||kD sy|j s$|j rt |� t |� k( ry|j �t |� t |� k( ryyr� )r{ �is_postreleaser! r r� s r �_compare_greater_thanz Specifier._compare_greater_than sy � � �)�)�(�3��
�T�!�� �#�#��*�*� �k�*�m�D�.A�A�� � � � (�]� �.
�
�4�
�.!� �
r c �h � t |� j � t |� j � k( S r )r. �lowerr� s r �_compare_arbitraryz Specifier._compare_arbitrary0 s& � ��;� �%�%�'�3�t�9�?�?�+<�<�<r 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")
True
>>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True)
True
�rB �r0 rA s r � __contains__zSpecifier.__contains__3 � � �& �}�}�T�"�"r c �N � t t | j |g|�� � � S )as 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 will follow the recommendation from
:pep:`440` and match prereleases, as there are no other versions.
>>> 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")
True
>>> Specifier(">=1.2.3", prereleases=False).contains("1.3.0a1")
False
>>> Specifier(">=1.2.3").contains("1.3.0a1")
True
�r; )rL r� rE r@ s r rB zSpecifier.containsH s# � �2 �D����d�V���E�F�G�Gr c # �� K � g }d}|�|n | j }| j | j � }|D ]� }t |� }|�2| j dk( s� | j || j
� s�=|�� �B ||| j
� s�V|j r|rd}|�� �k|��n| j dus�}|j |� �� |s |�| j dur |E d{ ��� yyyy7 ��w)a 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 follow the recommendation from :pep:`440`
and match prereleases if there are no other versions.
>>> 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']
FNrk T) r; r� rn r r� r r rZ �append) r0 rD r; �prereleases_versions�found_non_prereleases�include_prereleasesr� r �parsed_versions r rE zSpecifier.filterc s � �� �0 "� � %� � '�2�K��8H�8H� �
!� .� .�t�}�}� =�� � 9�G� ,�W� 5�N� �%��=�=�E�)�d�.E�.E��T�\�\�/� "�M�"�>�4�<�<�@�%�3�3�7J�,0�)�!�M� �(�T�->�->�e�-K�(�/�/��8� 9�( &��#��!�!��.�+� +� +� /� $� &�
,�s0 �AC&� C&�1C&�
C&�"C&�1*C&�C$� C&�r� N)rs r. r; rN rG rO )r r. rG �Version | None)r r. rG r
rM �r> rN rG rO rF )rG ztuple[str, str]rH rJ )r� r. rG �CallableOperator)r� r
rs r. rG rL )r� r
r� r. rG rL )r� z
Version | strrs r. rG rL )rA z
str | VersionrG rL r )rA �UnparsedVersionr; rN rG rL rP )'r$ r% r& r' rQ �_operator_regex_str�_version_regex_str�re�compile�VERBOSE�
IGNORECASEro rl �__annotations__ru rx r{ rS r; rV rn r r� r2 r� r5 r9 r� r� r� r� r� r� r� r� r� r� rB rE r( r r rY rY v sl � �� ;�I� ��\ ��| �R�Z�Z��$�$�'9�9�F�B�
�
�
�R�]�]�"��F� ��� �"�
�
�� �J�� �>�8
!� � �� ��8 ���"� �"� � � � � � � � �B�$*� � +� � +�*�=�:!�
�(&/�P:�P� P� �6 �D=�#�*H�8 RV�<,�4�<,�CN�<,� %�<,r rY 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_regexrp �extend�groups)r �result�epochr� �restrA rt s r r� r� � s~ � � �F� �'�'��,�N�E�1�d�
�M�M�%�,�3� ��
�
�3�� �� �'�'��-�� � �M�M�%�,�,�.� )� �M�M�$� � � �Mr c �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)�
componentsr� r� s r r� r� � s' � � �L�E�D��W�A�c�h�h�t�n�%� &�&r c �. � � t � fd�dD � � S )Nc 3 �@ �K � | ] }�j |� �� � y �wr )�
startswith)�.0r� �segments �r � <genexpr>z!_is_not_suffix.<locals>.<genexpr>� s! �� �� � �'-����6�"��s � )r �a�b�rcr )�any)r� s `r r� r� � s" �� �� �1P�� � � r c �� � 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)�left�right�
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 �� � e Zd ZdZdZ d dd�Zedd�� Zej dd�� Zdd�Z dd�Z
dd �Z dd
�Z dd �Z
dd �Zdd
�Zdd�Z d d d�Z d d d�Zy) � 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.
)rZ �_specsNc �" � t |t � rc|j d� D �cg c]# }|j � s�|j � ��% }}t t t |� � | _ || _ yt |� | _ || _ yc c}w )a� 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.
May also be an iterable of ``Specifier`` instances, which will be used
as is.
: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 r. r� rr � frozenset�maprY r rZ )r0 �
specifiersr; �s�split_specifierss r ru zSpecifierSet.__init__� s{ � �, �j�#� &� 4>�3C�3C�C�3H� V�a�A�G�G�I���� � V� � V� $�C� �3C�$D�E�D�K� (��� $�J�/�D�K� (���� Ws
�B �B c � � | j � | j S | j sy t d� | j D � � ryy )Nc 3 �4 K � | ] }|j �� � y �wr r� �r� r s r r� z+SpecifierSet.prereleases.<locals>.<genexpr> s � �� �2��q�}�}�2�s �T)rZ r r� r/ s r r; zSpecifierSet.prereleases sB � � � � � (��$�$� $�
�{�{�� �2�d�k�k�2� 2��r c � � || _ y r r� r= s r r; zSpecifierSet.prereleases$ r� 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)>
r� r� z<SpecifierSet(r� )rZ r; r. r� s r r� 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 r- r s r r� z'SpecifierSet.__str__.<locals>.<genexpr>H s � �� � ;�!�s�1�v� ;�s �)r� �sortedr r/ s r r2 zSpecifierSet.__str__= s" � � �x�x�� ;�t�{�{� ;�;�<�<r c �, � t | j � S r )r� r r/ s r r5 zSpecifierSet.__hash__J s � ��D�K�K� � r c � � t |t � r t |� }nt |t � st S t � }t | j
|j
z � |_ | j � |j �|j |_ |S | j � |j �| 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 r. r r� r r rZ �
ValueError)r0 r8 � specifiers r �__and__zSpecifierSet.__and__M s� � � �e�S� !� ��'�E��E�<�0�!� !� �N� �$�T�[�[�5�<�<�%?�@� �� � � � $��);�);�)G�%*�%7�%7�I� "� ��
� � � )�e�.@�.@�.H�
�
�
�%�"4�"4�
4�%)�%6�%6�I� "� �� �X��
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 r. rY r r� r r7 s r r9 zSpecifierSet.__eq__l 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__� 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__� s � � �D�K�K� � r c �$ � | j |� S )aq 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")
True
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)
True
r� r� s r r� zSpecifierSet.__contains__� r� r c � � t |� }|�|r|j rd}|�|n|}t t | j |g|�� � � 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 will follow the recommendation from :pep:`440`
and match prereleases, as there are no other versions.
:param installed:
Whether or not the item is installed. If set to ``True``, it will
accept prerelease versions even if the specifier does not allow them.
>>> 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")
True
>>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False).contains("1.3.0a1")
False
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True)
True
Tr� )r r rL r� rE )r0 rA r; � installedr �
check_items r rB zSpecifierSet.contains� sN � �@ "�$�'�� � �9��1F�1F� �K� $�_�T�'�
��D����j�\�{��K�L�M�Mr c � � � |�| j � | j }| j r5| j D ] }|j ||�dn|�� }� |�)t |� S |du r t |� S |du r � fd�|D � S g }g }d}|D ]c }t |� }|�#|j |� |j |� �3|j r|j |� �Q|j |� d}�e t |r|� S |� 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 follow the recommendation from :pep:`440`
and match prereleases if there are no other versions.
>>> 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"]))
['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']
Tr� Fc 3 �T �K � | ] }t |� x�� �j s|�� �! y �wr )r r )r� rA r s �r r� z&SpecifierSet.filter.<locals>.<genexpr> s2 �� �� � � �#2�4�#8�8��A�"�0�0� ��s �%()r; r rE r) r r� r )
r0 rD r; rs �filtered_items�found_prereleases�found_final_releaserA r� r s
@r rE zSpecifierSet.filter� s5 �� �N � �4�#3�#3�#?� �*�*�K�
�;�;� � � �
�� �;�;� �+�2E�$�;� '� ��
�
�&� �H�~�%� �d�"��H�~�%��e�#�� (�� � 46��68�� #�� � +�D� ,�T� 2�N� �%� �%�%�d�+�!�(�(��.� �-�-�!�(�(��.� �%�%�d�+�&*�#� +� �&9�N�Q�Q�?P�Q�Qr r� )r zstr | Iterable[Specifier]r; rN rG rO rM r� rF rH )r8 zSpecifierSet | strrG r rJ )rG zIterator[Specifier])rA r� rG rL )NN)rA r� r; rN r- rN rG rL r rP )r$ r% r& r' rQ ru rS r; rV r� r2 r5 r$ r9 r' r* r� rB rE r( r r r r � s� � �� +�I� 13�#'�$(�-�$(� !�$(�
� $(�L �� ��& ���"� �"�5�* =�!� �>+�4 �!�#�0 $(�!%� &N� �&N� !�&N� � &N�
� &N�R RV�[R�4�[R�CN�[R� %�[Rr r )r r� rG r� )r r
rG r
)r r. rG � list[str])r� r4 rG r. )r� r. rG rL )r
r4 r r4 rG ztuple[list[str], list[str]])&r' �
__future__r rT r� r� �typingr r r r r r �utilsr r r r
r. r� r rL r� r r r! r" r# �ABCMetar* rY r� r� r� r� r� r� r r( r r �<module>r9 s� ��� #�
� � � F� F� '� ,���� �%�� � 1� �I� ��W�c�N�D� 0�1� ��+�J� �z� �< �c�k�k� < �~i,�
� i,�X ��
�
�:�;�
��,'�� �*KR�=� KRr