⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.144
Server IP:
157.245.143.252
Server:
Linux www 6.11.0-9-generic #9-Ubuntu SMP PREEMPT_DYNAMIC Mon Oct 14 13:19:59 UTC 2024 x86_64
Server Software:
nginx/1.26.0
PHP Version:
8.3.11
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
lib
/
python3
/
dist-packages
/
packaging
/
__pycache__
/
View File Name :
specifiers.cpython-312.pyc
%;f" N d Z ddlmZ ddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZ e eef Z e de Zeeegef Zdd Z G d d e Z G d dej0 Z G d de Z ej6 d Z ddZ ddZ d dZ d dZ G d de Z!y) z .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version ) annotationsN)CallableIterableIteratorTypeVarUnion )canonicalize_version)VersionUnparsedVersionVar)boundc < t | t s t | } | S N) isinstancer )versions 6/usr/lib/python3/dist-packages/packaging/specifiers.py_coerce_versionr s gw ''" N 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 0 e Zd Zej d d Zej d d Zej d d Zeej d d Z e j d d Z ej ddd Z ej d dd Z y) BaseSpecifierc y)z Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr selfs r __str__zBaseSpecifier.__str__- r c y)zF Returns a hash value for this Specifier-like object. Nr r s r __hash__zBaseSpecifier.__hash__4 r" 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 r others r __eq__zBaseSpecifier.__eq__: r" r c y)zWhether 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.prereleasesC r" r c y)zQSetter for :attr:`prereleases`. :param value: The value to set. Nr r values r r* zBaseSpecifier.prereleasesL r" r Nc y)zR Determines if the given item is contained within this specifier. Nr )r itemr* s r containszBaseSpecifier.containsS r" 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 )r iterabler* s r filterzBaseSpecifier.filterY r" r returnstrr5 intr' objectr5 boolr5 bool | Noner- r; r5 Noner )r/ r6 r* r= r5 r; r2 z Iterable[UnparsedVersionVar]r* r= r5 z Iterator[UnparsedVersionVar]) r r r abcabstractmethodr! r$ r( propertyr* setterr0 r3 r r r r r , s QU 4 CN % r r ) metaclassc e Zd ZdZdZdZ ej dez ez dz ej ej z Z dddd d d d d dZ d&d'dZ e d(d Zej d)d Ze d*d Ze d*d Zd*dZd*dZe d+d Zd,dZd-dZd.dZd/dZd/d Zd/d Zd/d Zd/d Z d0d Z d0d!Z d/d"Z d1d#Z d2d3d$Z! d2 d4d%Z"y)5 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*$ compatibleequal not_equalless_than_equalgreater_than_equal less_than greater_than arbitrary)~===z!=<=>=<>===Nc | j j | }|st d| d |j d j |j d j f| _ || _ 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)_regexsearchr groupstrip_spec _prereleases)r specr* matchs r __init__zSpecifier.__init__ so ""4("%9$q#AB B KK # ) ) + KK " ( ( *' (r c | j | j S | j \ }}|dv r1|dk( r|j d r|d d }t | j ryy)N)rQ rS rR rP rV rQ .*TF)r_ r^ endswithr is_prerelease)r rY r s r r* zSpecifier.prereleases sm ($$ $ !JJ' 6 6 4 G$4$4T$:!#2, w --r c || _ y r r_ r, s r r* zSpecifier.prereleases !r c | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r r^ r s r rY zSpecifier.operator zz!} r c | j d S )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rl r s r r zSpecifier.version rm r c | j d| j nd}d| j j dt | | dS )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= rT ()>)r_ r* __class__r r6 r pres r __repr__zSpecifier.__repr__& sU , T - - 0 1 4>>**+1SYM#bAAr c 4 dj | j S )zA 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 r! zSpecifier.__str__8 s v}}djj))r c x t | j d | j d dk7 }| j d |fS )Nr r rP strip_trailing_zero)r r^ )r canonical_versions r _canonical_speczSpecifier._canonical_specB s> 0 JJqM!%A $!6 zz!} ///r c , t | j S r )hashr~ r s r r$ zSpecifier.__hash__J 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 r6 rt r NotImplementedr~ r& s r r( zSpecifier.__eq__M si & eS ! & s5z2 E4>>2! !##u'<'<<< $ &%% &s A" "A43A4c > t | d| j | }|S )N _compare_)getattr _operators)r opoperator_callables r _get_operatorzSpecifier._get_operatorj s+ .5 Idoob 1 23/ ! r c t t t j t t | d d }|dz } | j d || xr | j d || S )Nrd rS rQ ) _version_joinlist itertools takewhile_is_not_suffix_version_splitr )r prospectiver` prefixs r _compare_compatiblez Specifier._compare_compatiblep sw $$^^D5IJ KCR P $'t!!$' T: ?Wt?Q?QRV?W @ r c D |j d r_t |j d }t |d d d }t | }t | }t || \ }}|d t | } | |k( S t | } | j st |j }|| k( S )Nrd Fr{ re )rf r publicr _pad_versionlenr local) r r r` normalized_prospectivenormalized_spec split_specsplit_prospectivepadded_prospective_shortened_prospective spec_versions r _compare_equalzSpecifier._compare_equal s == %9""& " 349RW XO (8J !//E F %11BJ$O ! %77HZ $I !(J6 6 #4=L %% %k&8&8 9 ,. .r c ( | j || S r )r r r r` s r _compare_not_equalz Specifier._compare_not_equal s &&{D999r c D t |j t | k S r r r r s r _compare_less_than_equalz"Specifier._compare_less_than_equal {))*gdm;;r c D t |j t | k\ S r r r s r _compare_greater_than_equalz%Specifier._compare_greater_than_equal r r c t | }||k sy|j s8|j r,t |j t |j k( ryyNFT)r rg base_versionr r spec_strr` s r _compare_less_thanz Specifier._compare_less_than sT x T! !!k&?&?{//0GD<M<M4NN r c t | }||kD sy|j s8|j r,t |j t |j k( ry|j ,t |j t |j k( ryyr )r is_postreleaser r r s r _compare_greater_thanz Specifier._compare_greater_than s x T! ""{'A'A{//0GD<M<M4NN ({//0GD<M<M4NN r c h t | j t | j k( S r )r6 lowerr s r _compare_arbitraryz Specifier._compare_arbitrary s& ; %%'3t9??+<<<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") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True r0 r r/ s r __contains__zSpecifier.__contains__ & }}T""r c | | j }t | }|j r|sy| j | 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 F)r* r rg r rY r )r r/ r* normalized_itemr s r r0 zSpecifier.contains sY 4 **K *$/ ( ( /3.@.@ .O $,,??r c # K d}g }d||ndi}|D ]S }t | } | j |fi |s"|j r |s | j s|j | Nd}| U |s|r |D ] }| yyyw)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 r0 rg r* append)r r2 r* yieldedfound_prereleaseskwr parsed_versions r r3 zSpecifier.filter5 s < K,C[ N G ,W 5N t}}^2r2 "// 4#3#3%,,W5 #G!M ( ,, - -ws 0A9AA9rq N)r` r6 r* r= r5 r? )r5 r; r> r4 )r5 ztuple[str, str]r7 r9 )r r6 r5 CallableOperator)r r r` r6 r5 r; )r r r r6 r5 r; )r/ z str | Versionr5 r; r )r/ UnparsedVersionr* r= r5 r; r@ )#r r r r _operator_regex_str_version_regex_strrecompileVERBOSE IGNORECASErZ r rb rC r* rD rY r rw r! r~ r$ r( r r r r r r r r r r r0 r3 r r r rG rG c sR \ | RZZ%%(::WD R]]"F " J(4 . " " B$* 0 0*=:! (&/P:< < 0 <=#**@Z RV; 4; CN; %; r rG 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_regexr[ extendgroups)r resultepochr restr/ ra s r r r v sy F '',NE1d MM%,3 3 $$T* MM%,,. ) MM$ Mr c 6 | ^}}| ddj | S )zJoin 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' LEDWAchhtn% &&r c . t fddD S )Nc 3 @ K | ] }j | y wr ) startswith).0r segments r <genexpr>z!_is_not_suffix.<locals>.<genexpr> s! 1Pv6"1Ps )devabrcpost)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 isdigitxs 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 insertmaxchain from_iterable)leftright left_split right_splits r r r s5 " J d9../DdKLMtI / /0Eu MNO d3z!}-/01uSQ 0 234 a#QKN(;c*Q->P(P!QQRq3%#aZ]);c+a.>Q)Q"RRS Y__ * *: 67 Y__ * *; 78 r c e Zd ZdZdddZedd Zej dd ZddZddZ ddZ dd Z dd Z dd Z dd Zdd Z d ddZ d d dZy) SpecifierSetzThis 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. Nc |j d D cg c]# }|j s|j % }}t t t | | _ || _ yc c}w )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. ,N)r r] frozensetmaprG _specsr_ )r specifiersr* ssplit_specifierss r rb zSpecifierSet.__init__ sZ $ 0:/?/?/DR/D! AGGI/DR I/? @A ( Ss A$A$c | j | j S | j sy t d | j D S )Nc 3 4 K | ] }|j y wr r* r r s r r z+SpecifierSet.prereleases.<locals>.<genexpr> s 6+Q1==+s )r_ r r r s r r* zSpecifierSet.prereleases s? ($$ $ {{ 6$++666r c || _ y r ri r, s r r* zSpecifierSet.prereleases rj r c ^ | j d| j nd}dt | | dS )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)> rp rq z<SpecifierSet(rs )r_ r* r6 ru s r rw zSpecifierSet.__repr__ sD , T - - 0 1 D }SE44r 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 )r6 r s r r z'SpecifierSet.__str__.<locals>.<genexpr> s ;{!s1v{s )r sortedr r s r r! zSpecifierSet.__str__ s" xx ;t{{ ;;<<r c , t | j S r )r r r s r r$ zSpecifierSet.__hash__ s DKK r c t |t r t | }nt |t st S t }t | j |j z |_ | j |j |j |_ |S | j |j | j |_ |S | 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 r6 r r r r r_ ValueError)r r' specifiers r __and__zSpecifierSet.__and__ s eS ! 'EE<0! ! N $T[[5<<%?@ $););)G%*%7%7I " *u/A/A/I%)%6%6I " %"4"4 4%)%6%6I " 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 r6 rG r r r r& s r r( zSpecifierSet.__eq__. sD & ec9 - . U,EE<0! !{{ell**r c , t | j S )z7Returns the number of specifiers in this specifier set.)r r r s r __len__zSpecifierSet.__len__H 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__L s DKK r c $ | j | 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 s r r zSpecifierSet.__contains__V r r c t t s t | j s j ry|r!j rt j t fd| j 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 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 Fc 3 D K | ] }|j yw)r Nr )r r r/ r* s r r z(SpecifierSet.contains.<locals>.<genexpr> s Rk1::d :<ks )r r r* rg r allr )r r/ r* installeds `` r r0 zSpecifierSet.containsk sm < $(4=D **K t 1 1 ++4,,-D RdkkRRRr c r | | j }| j r8| j D ] }|j |t | } t | S g }g }|D ]A }t | }|j r|s|r |j | 1|j | C |s|r | t | 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'] r )r* r r3 r; r r rg r )r r2 r* r` filteredr r/ r s r r3 zSpecifierSet.filter s X **K ;; ;;xT+=N;O $> ! 24H:< !0!6 "// #)006 OOD) ! 1k6I -..> !r r )r r6 r* r= r5 r? r< r> r4 r7 )r' zSpecifierSet | strr5 r r9 )r5 zIterator[Specifier])r/ r r5 r; )NN)r/ r r* r= r r= r5 r; r r@ )r r r r rb rC r* rD rw r! r$ r r( r r r r0 r3 r r r r r s (6 7 7 " "5* =! @+4 !#0 $(!% 7S 7S !7S 7S 7St RVM"4M"CNM" %M"r r )r r r5 r )r r6 r5 list[str])r r r5 r6 )r r6 r5 r; )r r r r r5 ztuple[list[str], list[str]])"r __future__r rA r r typingr r r r r utilsr r r r6 r r r; r r r r ABCMetar rG r r r r r r r r r r <module>r# s # ? ? ' % 1 I WcND 01 z 4 ckk 4 nM M ` <= ,' *"= "r