File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-310.pyc
Back
o ;j]� � @ s$ d Z ddlmZ ddlZddlZddlZddlmZmZm Z m Z m Z m Z ddl mZ ddlmZmZ e eef Ze ded �Zeeegef Zd/dd�Zd0dd�Zd0dd�ZG dd� de�ZG dd� dej d�Z G dd� de �Z e� d �Z d1d d �Z!d2d"d#�Z"d3d&d'�Z#d4d+d,�Z$G d-d.� d.e �Z%dS )5z� .. 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�version�UnparsedVersion�return�Version | Nonec C s2 t | t�szt| �} W | S ty Y d S w | S �N)� isinstancer r �r � r �[/opt/saltstack/salt/lib/python3.10/site-packages/setuptools/_vendor/packaging/specifiers.py�_coerce_version s ��r r c C s | j d d�S )N)�local�Z __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 ZdZdZed!dd��Zejd!dd��Z ejd"d d ��Z ejd#dd��Z eejd$dd���Z e j d%dd��Z ejd&d'dd��Zej d&d(d d ��ZdS ))� BaseSpecifierr )�_strr �strc C s t | �S )z Internal property for match_args�r' ��selfr r r r& ; s zBaseSpecifier._strc C � 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__@ � zBaseSpecifier.__str__�intc C r+ )zF Returns a hash value for this Specifier-like object. Nr r) r r r �__hash__G r- zBaseSpecifier.__hash__�other�object�boolc C r+ )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* r0 r r r �__eq__M r- zBaseSpecifier.__eq__� bool | Nonec C r+ )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 r- zBaseSpecifier.prereleases�value�Nonec C r+ )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r* r7 r r r r6 _ r- N�itemr6 c C r+ )zR Determines if the given item is contained within this specifier. Nr �r* r: r6 r r r �containsf r- zBaseSpecifier.contains�iterable� Iterable[UnparsedVersionVar]� Iterator[UnparsedVersionVar]c C r+ )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= r6 r r r �filterl r- zBaseSpecifier.filter�r r' �r r. �r0 r1 r r2 �r r5 )r7 r2 r r8 r )r: r' r6 r5 r r2 �r= r> r6 r5 r r? )r! r" r# � __slots__�__match_args__�propertyr& �abc�abstractmethodr, r/ r4 r6 �setterr< r@ r r r r r% 7 s* �r% )� metaclassc @ sj e Zd ZU dZdZdZdZe�de e d ej ej B �Z dddd d d d d d�Z de d< d\d]dd�Zd^d d �Zd_d d!�Zed`d"d#��Zejdad%d#��Zedbd&d'��Zedbd(d)��Zdbd*d+�Zdbd,d-�Zedcd/d0��Zddd2d3�Zded7d8�Zdfd;d<�Zdgd>d?�Z dgd@dA�Z dgdBdC�Z dgdDdE�Z dgdFdG�Z dhdIdJ�Z!dhdKdL�Z"didNdO�Z#djdRdS�Z$dkdldUdV�Z% dkdmdZd[�Z&dS )n� 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*Z compatibleZequalZ not_equalZless_than_equalZgreater_than_equalZ less_thanZ greater_thanZ arbitrary)�~=�==�!=z<=�>=�<�>�===r � _operators� N�specr' r6 r5 r r8 c C sL | j �|�}|std|����|�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* rZ r6 �matchr r r �__init__� s � zSpecifier.__init__r r c C sD | j dur| j d |kr| j d S t|�}|du rdS ||f| _ |S )zDOne element cache, as only one spec Version is needed per Specifier.Nr r )rP r )r* r Zversion_specifierr r r �_get_spec_version s zSpecifier._get_spec_versionr c C s | � |�}|dus 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 ===). N)rb )r* r � spec_versionr r r �_require_spec_version s z Specifier._require_spec_versionc C s\ | j d ur| j S | j\}}|dkr,|dkr |�d�r dS | �|�}|d u r'd S |jr,dS dS )NrS rR �.*FT)rN rO �endswithrb � is_prerelease)r* r[ Z version_strr r r r r6 % s zSpecifier.prereleasesr7 c C � || _ d S r �rN r9 r r r r6 B � c C � | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rO r) r r r r[ F � zSpecifier.operatorc C rk )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rl r) r r r r O rm zSpecifier.versionc C s8 | j dur d| 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=rY rU �(�)>)rN r6 � __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__�tuple[str, str]c C sF | j \}}|dks|�d�r||fS | �|�}t||dkd�}||fS )NrW re rQ �Zstrip_trailing_zero)rO rf rd r )r* r[ r rc Zcanonical_versionr r r �_canonical_spect s �zSpecifier._canonical_specr. c C � t | j�S r )�hashrw r) r r r r/ � � zSpecifier.__hash__r0 r1 r2 c C sP t |t�rz | �t|��}W n ty t Y S w t || j�s"tS | 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' rq r �NotImplementedrw r3 r r r r4 � s � zSpecifier.__eq__�op�CallableOperatorc C s t | d| j| � ��}|S )NZ _compare_)�getattrrX )r* r| �operator_callabler r r � _get_operator� s �zSpecifier._get_operator� prospectivec C sH t tt�tt|���d d� �}|d7 }| �d�||�o#| �d�||�S )N���re rT rR )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitr� )r* r� rZ �prefixr r r �_compare_compatible� s ��z Specifier._compare_compatiblec C s� |� d�r2tt|�dd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS | �|�} | js>t|�}|| kS )Nre Frv ���)rf r r r� � _pad_version�lenrd r ) r* r� rZ Znormalized_prospectiveZnormalized_specZ split_specZsplit_prospectiveZpadded_prospective�_Zshortened_prospectiverc r r r �_compare_equal� s � zSpecifier._compare_equalc C s | � ||� S r )r� �r* r� rZ r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |�| �|�kS r �r rd r� r r r �_compare_less_than_equal� � z"Specifier._compare_less_than_equalc C s t |�| �|�kS r r� r� r r r �_compare_greater_than_equal� r� z%Specifier._compare_greater_than_equal�spec_strc C s: | � |�}||k s dS |js|jrt|�t|�krdS dS �NFT)rd rg r �r* r� r� rZ r r r �_compare_less_than� s ��z Specifier._compare_less_thanc C sX | � |�}||ks dS |js|jrt|�t|�krdS |jd ur*t|�t|�kr*dS dS r� )rd Zis_postreleaser r r� r r r �_compare_greater_than s �� ��z Specifier._compare_greater_than� Version | strc C s t |��� t |��� kS r )r' �lowerr� r r r �_compare_arbitrary0 s z Specifier._compare_arbitraryr: � str | Versionc C � | � |�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 � zSpecifier.__contains__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 �r6 )r2 r� r@ r; r r r r< H s zSpecifier.containsr= r> r? c c s� � g }d}|dur |n| j }| �| j�}|D ]9}t|�}|du r0| jdkr/| �|| j�r/|V q||| j�rO|jr;|rAd}|V q|du rO| jdurO|�|� q|sb|du rd| jdurf|E dH dS dS dS 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'] FNrW T) r6 r� r[ r r� r rg rN �append) r* r= r6 Zprereleases_versionsZfound_non_prereleasesZinclude_prereleasesr r �parsed_versionr r r r@ c s: �� �� �� �zSpecifier.filter�rY N)rZ r' r6 r5 r r8 )r r' r r )r r' r r rD �r7 r5 r r8 rA )r ru rB rC )r| r' r r} )r� r rZ r' r r2 )r� r r� r' r r2 )r� r� rZ r' r r2 )r: r� r r2 r )r: r r6 r5 r r2 rE )'r! r" r# r$ rF Z_operator_regex_strZ_version_regex_str�re�compile�VERBOSE� IGNORECASEr\ rX �__annotations__ra rb rd rH r6 rK r[ r rs r, rw r/ r4 r� r� r� r� r� r� r� r� r� r� r< r@ r r r r rM v s` ^ �� ( " �rM z ([0-9]+)((?:a|b|c|rc)[0-9]+)r' � list[str]c C s^ g }| � d�\}}}|�|pd� |�d�D ]}t�|�}|r'|�|�� � 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_regexr] �extend�groups)r �result�epochr� �restr: r` r r r r� � s r� � componentsc 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� �segmentr2 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� �left�right�tuple[list[str], list[str]]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 r ��isdigit��xr r r �<lambda>� � z _pad_version.<locals>.<lambda>c S r� r r� r� r r r r� � r� r r r� ) r� r� r� r� r� �insert�max�chain� from_iterable)r� r� Z left_splitZ right_splitr r r r� � s ,,�r� c @ s� e Zd ZdZdZ d2d3d d �Zed4d d��Zejd5dd��Zd6dd�Z d6dd�Z d7dd�Z d8dd �Z d9d d �Z d7d!d"�Zd:d$d%�Zd;d(d)�Z d<d=d+d,�Z d>d?d0d1�ZdS )@� 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 �_specsrY N� specifiers�str | Iterable[Specifier]r6 r5 r r8 c C sD t |t�rdd� |�d�D �}ttt|��| _nt|�| _|| _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 )r_ �r� �sr r r � <listcomp> s z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r r' r� � frozenset�maprM r� rN )r* r� r6 Zsplit_specifiersr r r ra � s zSpecifierSet.__init__c C s6 | j d ur| j S | js d S tdd� | jD ��rdS d S )Nc s s � | ]}|j V qd S r r� r� r r r r� s � z+SpecifierSet.prereleases.<locals>.<genexpr>T)rN r� r� r) r r r r6 s zSpecifierSet.prereleasesr7 c C rh r ri r9 r r r r6 $ rj r' c C s. | j dur 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)> Nrn rY z<SpecifierSet(rp )rN r6 r' rr r r r rs ( 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 s � z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r) r r r r, = s zSpecifierSet.__str__r. c C rx r )ry r� r) r r r r/ J rz zSpecifierSet.__hash__r0 �SpecifierSet | strc C s� t |t�r t|�}nt |t�stS t� }t| j|jB �|_| jdu r-|jdur-|j|_|S | jdur7|jdu s=| j|jkrC| j|_|S td��)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* r0 Z specifierr r r �__and__M s � ��zSpecifierSet.__and__r1 r2 c C s6 t |ttf�rtt|��}nt |t�stS | 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� r3 r r r r4 l s zSpecifierSet.__eq__c C rx )z7Returns the number of specifiers in this specifier set.)r� r� r) r r r �__len__� rj zSpecifierSet.__len__�Iterator[Specifier]c C rx )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 r� )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� � r� zSpecifierSet.__contains__� installedc C sF t |�}|dur|r|jrd}|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 rg r2 r� r@ )r* r: r6 r� r Z check_itemr r r r< � s zSpecifierSet.containsr= r> r? c s� |du r | j dur | j }| jr+| jD ]}|j||du r dn|d�}q|dur*t|�S n|du r3t|�S |du r@� fdd�|D �S g }g }d}|D ]%}t|�}|du r]|�|� |�|� qH|jrf|�|� qH|�|� d}qHt|rt|�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'] NTr� Fc 3 s* � | ]}t |� � d u s� js|V qd S r )r rg )r� r: r r r r� s � ���z&SpecifierSet.filter.<locals>.<genexpr>)r6 r� r@ r� r r� rg ) r* r= r6 rZ Zfiltered_itemsZfound_prereleasesZfound_final_releaser: r� r r r r@ � s: ' �� � zSpecifierSet.filterr� )r� r� r6 r5 r r8 rD r� rA rB )r0 r� r r� rC )r r� )r: r r r2 )NN)r: r r6 r5 r� r5 r r2 r rE )r! r" r# r$ rF ra rH r6 rK rs r, r/ r� r4 r� r� r� r< r@ r r r r r� � s. �& �)�r� )r r r r )r r r r )r r' r r� )r� r� r r' )r� r' r r2 )r� r� r� r� r 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> s6 ? 0
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings