ruạṛ
a �u:j]� � @ sP d Z ddlmZ ddlZddlZddlZddlmZmZm Z m Z m Z m Z ddl mZ ddlmZmZ e eef Ze ded �Zeeegef Zd d d �d d�Zddd �dd�Zddd �dd�ZG dd� de�ZG dd� dej d�Z G dd� de �Z e� d�Z d d d �d d �Z!d d d �d!d"�Z"d d#d$�d%d&�Z#d d d'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 � )� annotationsN)�Callable�Final�Iterable�Iterator�TypeVar�Union� )�canonicalize_version)�InvalidVersion�Version�UnparsedVersionVar)�bound�UnparsedVersion�Version | None��version�returnc C s0 t | t�s,z t| �} W n ty* Y d S 0 | S �N)� isinstancer r �r � r �Z/opt/bart/bart_venv/lib/python3.9/site-packages/setuptools/_vendor/packaging/specifiers.py�_coerce_version s r r c C s | j d d�S )N)�local�� __replace__r r r r �_public_version# s r c C s | j d d d d d�S )N)�pre�post�devr r r r r r � _base_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 ZdZdZedd�dd��Zejdd�dd��Z ejd d�d d ��Z ejd d d�dd��Z eejdd�dd���Z e j d dd�dd��Z ejd ddd d�dd��Zejd!ddd d �d d ��ZdS )"� BaseSpecifierr )�_str�str�r c C s t | �S )z Internal property for match_args�r) ��selfr r r r( ; s zBaseSpecifier._strc C s dS )z� Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr r, r r r �__str__@ s zBaseSpecifier.__str__�intc C s dS )zF Returns a hash value for this Specifier-like object. Nr r, r r r �__hash__G s zBaseSpecifier.__hash__�object�bool��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- r4 r r r �__eq__M s zBaseSpecifier.__eq__� bool | Nonec 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 � prereleasesV s zBaseSpecifier.prereleases�None��valuer c C s dS )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r- r; r r r r8 _ s N��itemr8 r c C s dS )zR Determines if the given item is contained within this specifier. Nr �r- r> r8 r r r �containsf s zBaseSpecifier.contains� Iterable[UnparsedVersionVar]� Iterator[UnparsedVersionVar]��iterabler8 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- rD r8 r r r �filterl s zBaseSpecifier.filter)N)N)r# r$ r% � __slots__�__match_args__�propertyr( �abc�abstractmethodr. r0 r6 r8 �setterr@ rE r r r r r' 7 s( �r' )� metaclassc @ s e Zd ZU dZdZdZdZe�de e d ej ej B �Z dddd d d d d d�Z de d< d\dddd�dd�Zddd�dd �Zdd d�d d �Zedd �d!d"��Zejddd#�d$d"��Zedd �d%d&��Zedd �d'd(��Zdd �d)d*�Zdd �d+d,�Zed-d �d.d/��Zd0d �d1d2�Zd3d4d5�d6d7�Zdd8d9�d:d;�Zd dd4d<�d=d>�Z d dd4d<�d?d@�Z d dd4d<�dAdB�Z d dd4d<�dCdD�Z d dd4d<�dEdF�Z d dd4dG�dHdI�Z!d dd4dG�dJdK�Z"dLdd4d<�dMdN�Z#dOd4dP�dQdR�Z$d]dSdd4dT�dUdV�Z%d^dWddXdY�dZd[�Z&dS )_� 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 � _operators� Nr) r7 r9 )�specr8 r c C sL | j �|�}|s td|����|�d��� |�d��� f| _|| _d| _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� fullmatchr" �group�striprO rN rP )r- rb r8 �matchr r r �__init__� s �zSpecifier.__init__r r c C sD | j dur"| j d |kr"| j d S t|�}|du r6dS ||f| _ |S )zDOne element cache, as only one spec Version is needed per Specifier.Nr r )rP r )r- r �version_specifierr r r �_get_spec_version s zSpecifier._get_spec_versionr c C s | � |�}|dusJ �|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 ===). N)rk )r- r � spec_versionr r r �_require_spec_version s z Specifier._require_spec_versionr* c C s\ | j d ur| j S | j\}}|dkrX|dkr8|�d�r8dS | �|�}|d u rNd S |jrXdS dS )Nr[ rZ �.*FT)rN rO �endswithrk � is_prerelease)r- rc � version_strr r r r r8 % s zSpecifier.prereleasesr: c C s || _ d S r �rN r< r r r r8 B s c C s | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rO r, r r r rc F s zSpecifier.operatorc C s | j d S )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rs r, r r r r O s zSpecifier.versionc C s8 | j durd| 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=ra r] �(�)>)rN r8 � __class__r# r) �r- r r r r �__repr__X 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{}{})�formatrO r, r r r r. j s zSpecifier.__str__ztuple[str, str]c C sF | j \}}|dks |�d�r$||fS | �|�}t||dkd�}||fS )Nr_ rn rY ��strip_trailing_zero)rO ro rm r )r- rc r rl �canonical_versionr r r �_canonical_spect s �zSpecifier._canonical_specr/ c C s t | j�S r )�hashr~ r, r r r r0 � s zSpecifier.__hash__r1 r2 r3 c C sR t |t�r6z| �t|��}W qF ty2 t Y S 0 nt || j�sFtS | 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 r) rw r" �NotImplementedr~ r5 r r r r6 � s zSpecifier.__eq__�CallableOperator)�opr c C s t | d| j| � ��}|S )N� _compare_)�getattrr` )r- r� �operator_callabler r r � _get_operator� s �zSpecifier._get_operator)� prospectiverb r c C sH t tt�tt|���d d� �}|d7 }| �d�||�oF| �d�||�S )N���rn r\ rZ )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitr� )r- r� rb �prefixr r r �_compare_compatible� s ��z Specifier._compare_compatiblec C s� |� d�rdtt|�dd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS | �|�} | js|t|�}|| kS d S )Nrn Fr{ ���)ro r r r� � _pad_version�lenrm r ) r- r� rb �normalized_prospective�normalized_spec� split_spec�split_prospective�padded_prospective�_�shortened_prospectiverl r r r �_compare_equal� s � zSpecifier._compare_equalc C s | � ||� S r )r� �r- r� rb r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |�| �|�kS r �r rm r� r r r �_compare_less_than_equal� s z"Specifier._compare_less_than_equalc C s t |�| �|�kS r r� r� r r r �_compare_greater_than_equal� s z%Specifier._compare_greater_than_equal)r� �spec_strr c C s: | � |�}||k sdS |js6|jr6t|�t|�kr6dS dS �NFT)rm rp r! �r- r� r� rb r r r �_compare_less_than� s ���z Specifier._compare_less_thanc C sX | � |�}||ksdS |js6|jr6t|�t|�kr6dS |jd urTt|�t|�krTdS dS r� )rm �is_postreleaser! r r� r r r �_compare_greater_than s" ��� ��z Specifier._compare_greater_thanz Version | strc C s t |��� t |��� kS r )r) �lowerr� r r r �_compare_arbitrary0 s z Specifier._compare_arbitraryz str | Version�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") True >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True �r@ �r- r> r r r � __contains__3 s zSpecifier.__contains__r r= c C s t t| j|g|d���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 �r8 )r2 r� rE r? r r r r@ H s zSpecifier.containsrA rB rC c c s� g }d}|dur|n| j }| �| j�}|D ]r}t|�}|du r^| jdkr�| �|| j�r�|V q*||| j�r*|jrt|r�d}|V q*|du r*| jdur*|�|� q*|s�|du r�| jdur�|E dH dS )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'] FNr_ T) r8 r� rc r r� r rp rN �append) r- rD r8 �prereleases_versions�found_non_prereleases�include_prereleasesr� r �parsed_versionr r r rE c s2 � � ���zSpecifier.filter)ra N)N)N)'r# r$ r% r& rF �_operator_regex_str�_version_regex_str�re�compile�VERBOSE� IGNORECASErd r` �__annotations__ri rk rm rH r8 rK rc r ry r. r~ r0 r6 r� r� r� r� r� r� r� r� r� r� r@ rE r r r r rM v s^ ^ �� (" �rM z ([0-9]+)((?:a|b|c|rc)[0-9]+)r) z list[str]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_regexre �extend�groups)r �result�epochr� �restr> rh r r r r� � s r� )� 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 r� � s r� r2 )�segmentr c s t � fdd�dD �� S )Nc 3 s | ]}� � |�V qd S r )� startswith)�.0r� �r� r r � <genexpr>� s z!_is_not_suffix.<locals>.<genexpr>)r �a�b�rcr )�anyr� r r� r r� � s �r� ztuple[list[str], list[str]])�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� r� r� r� r� �insert�max�chain� from_iterable)r� r� � left_split� right_splitr r r r� � s ,,�r� c @ s� e Zd ZdZdZd1dddd�d d �Zedd �d d ��Zejddd�dd ��Zdd �dd�Z dd �dd�Z dd �dd�Z dd d�dd�Z d d d�d d �Z dd �d d!�Zd"d �d#d$�Zd%d d&�d'd(�Zd2d%ddd d)�d*d+�Zd3d,dd-d.�d/d0�ZdS )4� 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. )rN �_specsra Nzstr | Iterable[Specifier]r7 r9 )� specifiersr8 r c C sD t |t�r0dd� |�d�D �}ttt|��| _n t|�| _|| _dS )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. c S s g | ]}|� � r|� � �qS r )rg �r� �sr r r � <listcomp> r� z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r r) r� � frozenset�maprM r� rN )r- r� r8 �split_specifiersr r r ri � s zSpecifierSet.__init__r* c C s6 | j d ur| j S | jsd S tdd� | jD ��r2dS d S )Nc s s | ] }|j V qd S r r� r� r r r r� r� z+SpecifierSet.prereleases.<locals>.<genexpr>T)rN r� r� r, r r r r8 s zSpecifierSet.prereleasesr: c C s || _ d S r rr r< r r r r8 $ s r) c C s. | j durd| 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)> Nrt ra z<SpecifierSet(rv )rN r8 r) rx r r r ry ( 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 r+ r� r r r r� H r� z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r, r r r r. = s zSpecifierSet.__str__r/ c C s t | j�S r )r r� r, r r r r0 J s zSpecifierSet.__hash__zSpecifierSet | strr3 c C s� t |t�rt|�}nt |t�s"tS t� }t| j|jB �|_| jdu rX|jdurX|j|_n2| jdurl|jdu sx| 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 r) r� r� r� r� rN � ValueError)r- r4 � specifierr r r �__and__M s& �� � �zSpecifierSet.__and__r1 r2 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 r) rM r� r� r� r5 r r r r6 l s zSpecifierSet.__eq__c C s t | j�S )z7Returns the number of specifiers in this specifier set.)r� r� r, r r r �__len__� s zSpecifierSet.__len__zIterator[Specifier]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__� s zSpecifierSet.__iter__r r� c C s | � |�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� r r r r� � s zSpecifierSet.__contains__)r> r8 � installedr c C sF t |�}|dur |r |jr d}|du r*|n|}tt| j|g|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 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 NTr� )r rp r2 r� rE )r- r> r8 r� r � check_itemr r r r@ � s zSpecifierSet.containsrA rB rC c s� |du r| j dur| j }| jrV| jD ] }|j||du r:dn|d�}q$|dur�t|�S n*|du rft|�S |du r�� fdd�|D �S g }g }d}|D ]J}t|�}|du r�|�|� |�|� q�|jr�|�|� q�|�|� d}q�t|r�|n|�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'] NTr� Fc 3 s( | ] }t |� � d u s � js|V qd S r )r rp )r� r> r r r r� s �z&SpecifierSet.filter.<locals>.<genexpr>)r8 r� rE r� r r� rp ) r- rD r8 rb �filtered_items�found_prereleases�found_final_releaser> r� r r r rE � s8 ' � � zSpecifierSet.filter)ra N)NN)N)r# r$ r% r& rF ri rH r8 rK ry r. r0 r� r6 r� r� r� r@ rE r r r r r� � s, �& �) �r� )&r& � __future__r rI r� r� �typingr r r r r r �utilsr r r r r) r r r2 r� r r r! r� r" �ABCMetar' rM r� r� r� r� r� r� r� r r r r �<module> s4 ? 0
cải xoăn