File manager - Edit - /usr/local/CyberPanel/lib/python3.10/site-packages/packaging/__pycache__/specifiers.cpython-310.pyc
Back
o �hw� � @ s d Z ddlmZ ddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZ e eef Ze ded �Zeeegef Zd*dd�ZG dd� de�ZG dd� dejd�ZG dd� de�Ze�d�Z d+dd�Z d,d d �Z d-d!d"�Z 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�Iterable�Iterator�TypeVar�Union� )�canonicalize_version)�Version�UnparsedVersionVar)�bound�version�UnparsedVersion�returnr c C s t | t�s t| �} | S �N)� isinstancer )r � r �J/usr/local/CyberPanel/lib/python3.10/site-packages/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 Zejd dd��Zejd dd��Zejd d d ��Zeejd dd���Z e j d!dd��Z ejd"d#dd��Z ej d"d$dd ��Z dS )%� BaseSpecifierr �strc C � dS )z� Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr ��selfr r r �__str__- � zBaseSpecifier.__str__�intc C r )zF Returns a hash value for this Specifier-like object. Nr r r r r �__hash__4 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 r# r r r �__eq__: 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 � prereleasesC r zBaseSpecifier.prereleases�value�Nonec C r )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r r* r r r r) L r N�itemr) c C r )zR Determines if the given item is contained within this specifier. Nr )r r- r) r r r �containsS 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/ r) r r r �filterY r zBaseSpecifier.filter�r r �r r! �r# r$ r r% �r r( �r* r% r r+ r )r- r r) r( r r% �r/ r0 r) r( r r1 ) r r r �abc�abstractmethodr r" r' �propertyr) �setterr. r2 r r r r r , s" �r )� metaclassc @ sH e Zd ZdZdZdZe�de e d ejej B �Z dddd d d d d d�Z dSdTdd�Z e dUdd��ZejdVd d��Ze dWd d ��Ze dWd d!��ZdWd"d#�ZdWd$d%�Ze dXd'd(��ZdYd*d+�ZdZd.d/�Zd[d2d3�Zd\d6d7�Zd\d8d9�Zd\d:d;�Zd\d<d=�Zd\d>d?�Z d]dAdB�Z d]dCdD�Z d\dEdF�Z d^dIdJ�Z d_d`dLdM�Z! d_dadQdR�Z"dS )b� 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) r( r r+ c C sF | j �|�}|std|����|�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 rO r) �matchr r r �__init__� s � zSpecifier.__init__r% c C sR | j d ur| j S | j\}}|dv r'|dkr |�d�r |d d� }t|�jr'dS dS )N)rH rJ rI rG rM rL rK rH �.*���TF)rV rU �endswithr � is_prerelease)r rP r r r r r) � s zSpecifier.prereleasesr* c C � || _ d S r �rV r, r r r r) � c C � | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rU r r r r rP � zSpecifier.operatorc C r` )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r ra r r r r r rb 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=rN rK �(�)>)rV r) � __class__r r �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{}{})�formatrU r r r r r 8 s zSpecifier.__str__�tuple[str, str]c C s* t | jd | jd dkd�}| jd |fS )Nr r rG ��strip_trailing_zero)r rU )r �canonical_versionr r r �_canonical_specB s �zSpecifier._canonical_specr! c C � t | j�S r )�hashro r r r r r" J � zSpecifier.__hash__r# r$ 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 rf r �NotImplementedro r& r r r r' M s � zSpecifier.__eq__�op�CallableOperatorc C s t | d| j| � ��}|S )N� _compare_)�getattr� _operators)r rt �operator_callabler r r � _get_operatorj s �zSpecifier._get_operator� prospectiver c C sH t tt�tt|���d d� �}|d7 }| �d�||�o#| �d�||�S )N���rY rJ rH )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitrz )r r{ rO �prefixr r r �_compare_compatiblep s ��z Specifier._compare_compatiblec C s� |� d�r1t|jdd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS t|�} | js=t|j�}|| kS )NrY Frl rZ )r[ r �publicr� � _pad_version�lenr �local) r r{ rO �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 r{ rO r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |j�t |�kS r �r r� r� r r r �_compare_less_than_equal� � z"Specifier._compare_less_than_equalc C s t |j�t |�kS r r� r� r r r �_compare_greater_than_equal� r� z%Specifier._compare_greater_than_equal�spec_strc C s< t |�}||k s dS |js |jr t |j�t |j�kr dS dS �NFT)r r\ � base_version�r r{ r� rO r r r �_compare_less_than� s z Specifier._compare_less_thanc C s^ t |�}||ks dS |js |jr t |j�t |j�kr dS |jd ur-t |j�t |j�kr-dS 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 )r �lowerr� r r r �_compare_arbitrary� 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") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True �r. �r r- r r r � __contains__� � zSpecifier.__contains__r c C s< |du r| j }t|�}|jr|sdS | �| 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 r\ rz rP r )r r- r) �normalized_itemry r r r r. s zSpecifier.containsr/ r0 r1 c c s� � d}g }d|dur |ndi}|D ]"}t |�}| j|fi |��r3|jr.|s.| js.|�|� qd}|V q|s@|rB|D ] }|V q:dS dS dS )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. r\ r) �append)r r/ r) �yielded�found_prereleases�kwr �parsed_versionr r r r2 5 s* � �� ��zSpecifier.filter�rN N)rO r r) r( r r+ )r r% r7 r3 )r rk r4 r5 )rt r r ru )r{ r rO r r r% )r{ r r� r r r% )r- r� r r% r )r- r r) r( r r% r8 )#r r r r �_operator_regex_str�_version_regex_str�re�compile�VERBOSE� IGNORECASErQ rx rX r; r) r< rP r ri r ro r" r' rz r� r� r� r� r� r� r� r� r� r. r2 r r r r r> c sZ ^ �� ( -�r> 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_regexrR �extend�groups)r �result�epochr� �restr- rW r r r r� v 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} �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>)�dev�a�b�rc�post)�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� � left_split� right_splitr r r r� � s ,,�r� c @ s� e Zd ZdZ d1d2d d �Zed3d d ��Zejd4dd ��Zd5dd�Zd5dd�Z d6dd�Z d7dd �Z d8d d �Z d6d d!�Z d9d#d$�Zd:d'd(�Z d;d<d*d+�Z d=d>d/d0�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 N� specifiers�str | Iterable[Specifier]r) r( r r+ 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 )rT �r� �sr r r � <listcomp>� s z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r r r� � frozenset�mapr> �_specsrV )r r� r) �split_specifiersr r r rX � s zSpecifierSet.__init__c C s. | j d ur| j S | js d S tdd� | jD ��S )Nc s s � | ]}|j V qd S r �r) r� r r r r� � s � z+SpecifierSet.prereleases.<locals>.<genexpr>)rV r� r� r r r r r) � s zSpecifierSet.prereleasesr* r% c C r] r r^ r, r r r r) � r_ 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)> Nrc rN z<SpecifierSet(re )rV r) r rg r r r ri � 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� s � z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r r r r r s zSpecifierSet.__str__r! c C rp r )rq r� r r r r r" rr zSpecifierSet.__hash__r# �SpecifierSet | strc C s� t |t�r t|�}nt |t�stS t� }t| j|jB �|_| jdu r-|jdur-|j|_|S | jdur=|jdu r=| j|_|S | j|jkrI| 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� rs r� r� rV � ValueError)r r# � specifierr r r �__and__ s$ � ���zSpecifierSet.__and__r$ 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 r> r� rs r� r& r r r r' 8 s zSpecifierSet.__eq__c C rp )z7Returns the number of specifiers in this specifier set.)r� r� r r r r �__len__R r_ zSpecifierSet.__len__�Iterator[Specifier]c C rp )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__V s zSpecifierSet.__iter__r- r c C r� )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� ` r� zSpecifierSet.__contains__� installedc s\ t � t�s t� �� �du r| j��s� jrdS |r!� jr!t� 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) r\ r� �allr� )r r- r) r� r r� r r. u s zSpecifierSet.containsr/ r0 r1 c C s� |du r| j }| jr | jD ] }|j|t|�d�}q t|�S g }g }|D ]}t|�}|jr6|s6|s5|�|� q#|�|� q#|sH|rH|du rHt|�S t|�S )a. Filter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) ['1.3', <Version('1.4')>] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) [] >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet("").filter(["1.5a1"])) ['1.5a1'] >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] Nr� )r) r� r2 r% r� r r\ r� )r r/ r) rO �filteredr� r- r� r r r r2 � s$ , � zSpecifierSet.filterr� )r� r� r) r( r r+ r6 r7 r3 r4 )r# r� r r� r5 )r r� )r- r r r% )NN)r- r r) r( r� r( r r% r r8 )r r r r rX r; r) r< ri r r" r� r' r� r� r� r. r2 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� r� r r� )"r � __future__r r9 r r� �typingr r r r r �utilsr r r r r r r% ru r r� r �ABCMetar r> r� r� r� r} r� r� r� r r r r �<module> s2 7
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.02 |
proxy
|
phpinfo
|
Settings