관리-도구
편집 파일: specifiers.cpython-38.pyc
U -?�fb� � @ sH d Z ddlZddlZddlZddlmZmZmZmZm Z m Z m Z m Z ddl mZ ddlmZ e eef Ze ded�Zeeegef Zeed �d d �ZG d d � d e�ZG dd� dejd�ZG dd� de�Ze� d�Z eee d �dd�Z ee ed�dd�Z eed�dd�Z ee ee e ee ee f d �d d �Z!G d d � d e�Z"dS )!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 C s t | t�st| �} | S �N)� isinstancer )r � r �Q/opt/hc_python/lib/python3.8/site-packages/wheel/vendored/packaging/specifiers.py�_coerce_version s r c @ s e Zd ZdZdS )�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 r s r c @ s� e Zd Zejed�dd��Zejed�dd��Zeje e d�dd��Z e eje e d�d d ���Zeje d d �d d ��Zejdee e e d�dd��Zejdee e e ee d�dd��Zd S )� BaseSpecifier�r c C s dS )z� Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr ��selfr r r �__str__+ s zBaseSpecifier.__str__c C s dS )zF Returns a hash value for this Specifier-like object. Nr r r r r �__hash__2 s zBaseSpecifier.__hash__��otherr c C s dS )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" r r r �__eq__8 s zBaseSpecifier.__eq__c C s dS )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 r r r � prereleasesA s zBaseSpecifier.prereleasesN��valuer c C s dS )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r r' r r r r% J s ��itemr% r c C s dS )zR Determines if the given item is contained within this specifier. Nr )r r* r% r r r �containsQ s zBaseSpecifier.contains��iterabler% r c C s dS )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 r- r% r r r �filterW s zBaseSpecifier.filter)N)N)r r r �abc�abstractmethod�strr �intr �object�boolr$ �propertyr r% �setterr+ r r r r. r r r r r * s( � �r )� metaclassc @ s� e Zd ZdZdZdZe�de e d ejej B �Z dddd d d d d d�Z dFe e e dd�dd�Zeed�dd��Zejedd�dd��Zee d�dd��Zee d�dd ��Ze d�d d �Ze d�d d �Zeee e f d�d!d"��Zed�d#d$�Zeed%�d&d'�Z e e d(�d)d*�Z e e ed+�d,d-�Z e e ed+�d.d/�Z!e e ed+�d0d1�Z"e e ed+�d2d3�Z#e e ed+�d4d5�Z$e e ed6�d7d8�Z%e e ed6�d9d:�Z&e e ed+�d;d<�Z'e(e e f ed=�d>d?�Z)dGe*e e ed@�dAdB�Z+dHe,e- e e e.e- dC�dDdE�Z/dS )I� 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 C sH | j �|�}|s td|� d���|�d��� |�d��� f| _|| _dS )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 rI r% �matchr r r �__init__� s �zSpecifier.__init__r c C sR | j d k r| j S | j\}}|dkrN|dkr@|�d�r@|d d� }t|�jrNdS dS )N)rB rD rC rA rG rB �.*���TF)rQ rP �endswithr � is_prerelease)r rK r r r r r% � s zSpecifier.prereleasesr& c C s || _ d S r �rQ r( r r r r% s c C s | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rP r r r r rK s zSpecifier.operatorc C s | j d S )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rY r r r r r s zSpecifier.versionc C s8 | j dk rd| j��nd}d| jj� 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)> N�, prereleases=rH rE �(�)>)rQ r% � __class__r r1 �r �prer r r �__repr__$ s ��zSpecifier.__repr__c C s 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{}{})�formatrP r r r r r 6 s zSpecifier.__str__c C s* t | jd | jd dkd�}| jd |fS )Nr r rA ��strip_trailing_zero)r rP )r �canonical_versionr r r �_canonical_spec@ s �zSpecifier._canonical_specc C s t | j�S r )�hashre r r r r r H s zSpecifier.__hash__r! c C sT t |t�r8z| �t|��}W qH tk r4 t Y S X nt || j�sHtS | j|jkS )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 r1 r] r �NotImplementedre r# r r r r$ K s zSpecifier.__eq__)�opr c C s t | d| j| � ��}|S )N� _compare_)�getattr� _operators)r rh �operator_callabler r r � _get_operatorh s �zSpecifier._get_operator)� prospectiverI r c C sH t tt�tt|���d d� �}|d7 }| �d�||�oF| �d�||�S )N���rT rD rB )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitrm )r rn rI �prefixr r r �_compare_compatiblen s � �z Specifier._compare_compatiblec C s� |� d�rbt|jdd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS t|�} | jszt|j�}|| kS d S )NrT Frb rU )rV r �publicru � _pad_version�lenr �local) r rn rI �normalized_prospective�normalized_spec� split_spec�split_prospective�padded_prospective�_�shortened_prospective� spec_versionr r r �_compare_equal� s � zSpecifier._compare_equalc C s | � ||� S r )r� �r rn rI r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |j�t |�kS r �r rx r� r r r �_compare_less_than_equal� s z"Specifier._compare_less_than_equalc C s t |j�t |�kS r r� r� r r r �_compare_greater_than_equal� s z%Specifier._compare_greater_than_equal)rn �spec_strr c C s< t |�}||k sdS |js8|jr8t |j�t |j�kr8dS dS �NFT)r rW � base_version�r rn r� rI r r r �_compare_less_than� s z Specifier._compare_less_thanc C s^ t |�}||ksdS |js8|jr8t |j�t |j�kr8dS |jd k rZt |j�t |j�krZdS dS r� )r �is_postreleaser� r{ r� r r r �_compare_greater_than� s z Specifier._compare_greater_thanc C s t |��� t |��� kS r )r1 �lowerr� r r r �_compare_arbitrary� s z Specifier._compare_arbitrary�r* r c C s | � |�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 �r+ �r r* r r r � __contains__� s zSpecifier.__contains__r) c C s< |dkr| j }t|�}|jr$|s$dS | �| 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 NF)r% r rW rm rK r )r r* r% �normalized_itemrl r r r r+ s zSpecifier.containsr, c c s~ d}g }d|dk r|ndi}|D ]@}t |�}| j|f|�r |jrV|sV| jsV|�|� q d}|V q |sz|rz|D ] }|V qndS )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 r+ rW r% �append)r r- r% �yielded�found_prereleases�kwr �parsed_versionr r r r. 5 s" �� zSpecifier.filter)rH N)N)N)0r r r r �_operator_regex_str�_version_regex_str�re�compile�VERBOSE� IGNORECASErL rk r1 r r4 rS r5 r% r6 rK r r` r r re r2 r r3 r$ �CallableOperatorrm r rw r� r� r� r� r� r� r� r r� �UnparsedVersionr+ r r r r. r r r r r8 a sj ^ �� ( � � / � �r8 z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c C s^ g }| � d�\}}}|�|p d� |�d�D ],}t�|�}|rN|�|�� � q,|�|� q,|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_regexrM �extend�groups)r �result�epochr� �restr* rR r r r ru v s ru )� componentsr c C s | ^}}|� dd� |�� �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� r r r rp � s rp )�segmentr c s t � fdd�dD �� S )Nc 3 s | ]}� � |�V qd S r )� startswith)�.0rv �r� r r � <genexpr>� s z!_is_not_suffix.<locals>.<genexpr>)�dev�a�b�rc�post)�anyr� r r� r rt � s �rt )�left�rightr c C s� g g }}|� tt�dd� | ��� |� tt�dd� |��� |� | t|d �d � � |� |t|d �d � � |�ddgtdt|d �t|d � � � |�ddgtdt|d �t|d � � � ttj�|��ttj�|��fS )Nc S s | � � S r ��isdigit��xr r r �<lambda>� � z _pad_version.<locals>.<lambda>c S s | � � S r r� r� r r r r� � r� r r r� ) r� rq rr rs rz �insert�max�chain� from_iterable)r� r� � left_split� right_splitr r r ry � s ,,�ry c @ s e Zd ZdZd$eee dd�dd�Zeee d�dd ��Z e j edd �d d ��Z ed�d d �Z ed�dd�Z e d�dd�Zed ef d d�dd�Zeed�dd�Ze d�dd�Zee d�dd�Zeed�d d �Zd%eee ee ed �d d �Zd&ee ee ee d!�d"d#�Z dS )'� 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. rH N)� specifiersr% r c C s. dd� |� d�D �}ttt|��| _|| _dS )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. c S s g | ]}|� � r|� � �qS r )rO �r� �sr r r � <listcomp>� s z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r� � frozenset�mapr8 �_specsrQ )r r� r% �split_specifiersr r r rS � s zSpecifierSet.__init__r c C s. | j d k r| j S | jsd S tdd� | jD ��S )Nc s s | ] }|j V qd S r �r% r� r r r r� � s z+SpecifierSet.prereleases.<locals>.<genexpr>)rQ r� r� r r r r r% � s zSpecifierSet.prereleasesr& c C s || _ d S r rX r( r r r r% � s c C s. | j dk rd| 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)> NrZ rH z<SpecifierSet(r\ )rQ r% r1 r^ r r r r` � s ��zSpecifierSet.__repr__c C s d� tdd� | jD ���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 s s | ]}t |�V qd S r )r1 r� r r r r� s z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r r r r r s zSpecifierSet.__str__c C s t | j�S r )rf r� r r r r r s zSpecifierSet.__hash__r! c C s� t |t�rt|�}nt |t�s"tS t� }t| j|jB �|_| jdkrX|jdk rX|j|_n<| jdk rv|jdkrv| j|_n | j|jkr�| j|_ntd��|S )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')> NzFCannot combine SpecifierSets with True and False prerelease overrides.)r r1 r� rg r� r� rQ � ValueError)r r" � specifierr r r �__and__ s �zSpecifierSet.__and__c C s6 t |ttf�r tt|��}nt |t�s*tS | j|jkS )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 r1 r8 r� rg r� r# r r r r$ 0 s zSpecifierSet.__eq__c C s t | j�S )z7Returns the number of specifiers in this specifier set.)rz r� r r r r �__len__J s zSpecifierSet.__len__c C s 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 r r r �__iter__N s zSpecifierSet.__iter__r� c C s | � |�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� r r r r� X s zSpecifierSet.__contains__)r* r% � installedr c s\ t � t�st� �� �dkr | j��s.� jr.dS |rB� jrBt� j�� t� �fdd�| jD ��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 NFc 3 s | ]}|j � �d �V qdS )r� Nr� r� �r* r% r r r� � s z(SpecifierSet.contains.<locals>.<genexpr>)r r r% rW r� �allr� )r r* r% r� r r� r r+ m s zSpecifierSet.containsr, c C s� |dkr| j }| jr:| jD ]}|j|t|�d�}qt|�S g }g }|D ]0}t|�}|jrl|sl|sv|�|� qF|�|� qF|s�|r�|dkr�t|�S t|�S dS )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'] Nr� )r% r� r. r4 r� r rW r� )r r- r% rI �filteredr� r* r� r r r r. � s" , zSpecifierSet.filter)rH N)NN)N) r r r r r1 r r4 rS r5 r% r6 r` r r2 r r r� r3 r$ r� r r8 r� r� r� r+ r r r. r r r r r� � sD � � �� : � �r� )#r r/ rr r� �typingr r r r r r r r �utilsr r r r1 r� r r4 r� r r� r �ABCMetar r8 r� r� ru rp rt ry r� r r r r �<module> s. ( 7 *