a0bi& S r SSKrSSKrSSKrSSKJrJrJrJrJ r J
r
J r J r J
r
SSKJr SSKJr \
\\4 r\ " S\S9r\\\/\4 rS \S
\4S jr " S S
\5 r " S S\R4 S9r " S S\5 r \R: " S5 r S \S
\\ 4S jr S\S
\4S jr S\\ S\\ S
\ \\ \\ 4 4S jr! " S S\5 r"g) z
.. testsetup::
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
from packaging.version import Version
N) CallableIterableIteratorListOptionalSetTupleTypeVarUnion )canonicalize_version)VersionUnparsedVersionVar)boundversionreturnc F [ U [ 5 ( d [ U 5 n U $ N)
isinstancer )r s ڠ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_vendor/packaging/specifiers.py_coerce_versionr " s gw ' ''" N c \ rS rSrSrSrg)InvalidSpecifier( z
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____firstlineno____doc____static_attributes__r r r r r ( s r r c \ rS rSr\R
S\4S j5 r\R
S\4S j5 r \R
S\
S\ 4S j5 r \
\R
S\\ 4S j5 5 r\R S\ SS 4S
j5 r\R
SS \S \\ S\ 4S
jj5 r\R
SS\\ S \\ S\\ 4S jj5 rSrg )
BaseSpecifier4 r c g)zv
Returns the str representation of this Specifier-like object. This
should be representative of the Specifier itself.
Nr selfs r __str__BaseSpecifier.__str__5 r c g)z6
Returns a hash value for this Specifier-like object.
Nr r' s r __hash__BaseSpecifier.__hash__< r+ r otherc g)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/ s r __eq__BaseSpecifier.__eq__B r+ r c g)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 prereleasesBaseSpecifier.prereleasesK r+ r valueNc g)zASetter for :attr:`prereleases`.
:param value: The value to set.
Nr r( r7 s r r5 r6 T r+ r itemr5 c g)zB
Determines if the given item is contained within this specifier.
Nr )r( r: r5 s r containsBaseSpecifier.contains[ r+ r iterablec g)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> r5 s r filterBaseSpecifier.filtera r+ r r r )r r r r abcabstractmethodstrr) intr- objectboolr2 propertyr r5 setterr< r r r r@ r" r r r r$ r$ 4 s7 #
F t Xd^ $ S x~
TX !34 CKD> $ % r r$ ) metaclassc \ rS rSrSrSrSr\R " S\- \- S- \R \R - 5 r SSS S
S S S
SS.r S2S\
S\\ SS4S jjr\S\4S j5 r\R& S\SS4S j5 r\S\
4S j5 r\S\
4S j5 rS\
4S jrS\
4S jr\S\\
\
4 4S j5 rS\4S jrS \ S\4S jr S \
S\ 4S! jr S"\ S\
S\4S# jr!S"\ S\
S\4S$ jr"S"\ S\
S\4S% jr#S"\ S\
S\4S& jr$S"\ S\
S\4S' jr%S"\ S(\
S\4S) jr&S"\ S(\
S\4S* jr'S"\ S\
S\4S+ jr(S,\)\
\ 4 S\4S- jr* S3S,\+S\\ S\4S. jjr, S3S/\-\. S\\ S\/\. 4S0 jjr0S1r1g)4 Specifierk a+ 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(~=|==|!=|<=|>=|<|>|===))
a
(?P
(?:
# 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.
(?=<>===Nspecr5 r c U R R U5 nU( d [ SU S35 eUR S5 R 5 UR S5 R 5 4U l X l g)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( r] r5 matchs r __init__Specifier.__init__ sm ""4("%9$q#AB B
KK
# ) ) + KK " ( ( *'
(r c U R b U R $ U R u pUS; a< US:X a UR S5 ( a US S n[ U5 R ( a gg)N)rW rY rX rV r\ rW .*TF)rf re endswithr
is_prerelease)r( r` r s r r5 Specifier.prereleases sn ($$ $
!JJ 6 6 4 G$4$4T$:$:!#2, w --r r7 c Xl g r rf r9 s r r5 ro !r c U R S $ )zHThe operator of this specifier.
>>> Specifier("==1.2.3").operator
'=='
r re r' s r r` Specifier.operator zz!} r c U R S $ )zIThe version of this specifier.
>>> Specifier("==1.2.3").version
'1.2.3'
r rt r' s r r Specifier.version% rv r c U R b SU R < 3OSnSU R R S[ U 5 < U S3$ )a A representation of the Specifier that shows all internal state.
>>> Specifier('>=1.0.0')
=1.0.0')>
>>> Specifier('>=1.0.0', prereleases=False)
=1.0.0', prereleases=False)>
>>> Specifier('>=1.0.0', prereleases=True)
=1.0.0', prereleases=True)>
, prereleases= rZ ()>)rf r5 __class__r rD r( pres r __repr__Specifier.__repr__. sU , T - - 0 1 4>>**+1SYM#bAAr c 4 SR " U R 6 $ )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{}{})formatre r' s r r) Specifier.__str__@ s }}djj))r c r [ U R S U R S S:g S9nU R S U4$ )Nr r rV strip_trailing_zero)r
re )r( canonical_versions r _canonical_specSpecifier._canonical_specJ s> 0 JJqM!%A $!6
zz!} ///r c , [ U R 5 $ r )hashr r' s r r- Specifier.__hash__R s D(())r r/ c [ U[ 5 ( a U R [ U5 5 nO [ XR 5 ( d [ $ U R
UR
:H $ ! [ a [ s $ f = f)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 rD r~ r NotImplementedr r1 s r r2 Specifier.__eq__U sm & eS ! !
& s5z2 E>>22! !##u'<'<<< $
&%%
&s A+ +A>=A>opc > [ U SU R U 35 nU$ )N _compare_)getattr
_operators)r( r operator_callables r
_get_operatorSpecifier._get_operatorr s+ .5 Idoob 1 23/
! r prospectivec
SR [ [ R " [ [ U5 5 5 S S 5 nUS-
nU R
S5 " X5 =( a U R
S5 " X5 $ )N.rk rY rW )joinlist itertools takewhile_is_not_suffix_version_splitr )r( r r] prefixs r _compare_compatible Specifier._compare_compatiblex sr $$^^D5IJ KCR P
$!!$' :
t?Q?QRV?W @
r c D UR S5 ( aV [ UR SS9n[ US S SS9n[ U5 n[ U5 n[ Xe5 u pxUS [ U5 n X:H $ [
U5 n
U
R ( d [
UR 5 nX:H $ )Nrk Fr rl )rm r
publicr _pad_versionlenr local) r( r r] normalized_prospectivenormalized_spec
split_specsplit_prospectivepadded_prospective_shortened_prospective spec_versions r _compare_equalSpecifier._compare_equal s == %9""& " 349RW XO (8J
!//E F %11B$O !
%77HZ $I !(6 6 #4=L
%% %k&8&8 9 . .r c . U R X5 ( + $ r )r r( r r] s r _compare_not_equal Specifier._compare_not_equal s &&{999r c D [ UR 5 [ U5 :* $ r r r r s r _compare_less_than_equal"Specifier._compare_less_than_equal
{))*gdm;;r c D [ UR 5 [ U5 : $ r r r s r _compare_greater_than_equal%Specifier._compare_greater_than_equal r r spec_strc [ U5 nX: d gUR ( d> UR ( a- [ UR 5 [ UR 5 :X a ggNFT)r rn base_versionr( r r r] s r _compare_less_than Specifier._compare_less_than sR x
! !!k&?&?{//0GD UR ( a- [ UR 5 [ UR 5 :X a gUR b- [ UR 5 [ UR 5 :X a ggr )r is_postreleaser r r s r _compare_greater_than Specifier._compare_greater_than s x
! ""{'A'A{//0GD>> "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: s r __contains__Specifier.__contains__ & }}T""r c Uc U R n[ U5 nUR ( a U( d gU R U R 5 nU" X0R
5 $ )a 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)r5 r rn r r` r )r( r: r5 normalized_itemr s r r< Specifier.contains sW 8 **K *$/
( ( /3.@.@ .O ,,??r r> c # @ # Sn/ nSUb UOS0nU Hj n[ U5 nU R " U40 UD6( d M( UR ( a+ U( d$ U R ( d UR U5 Md SnUv Ml U( d U( a U H nUv M ggg7f)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 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', ]
>>> 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']
Fr5 NT)r r< rn r5 append)r( r> r5 yieldedfound_prereleaseskwr parsed_versions r r@ Specifier.filterE s < K,C[
N G ,W 5N}}^2r22 "// 4#3#3%,,W5 #G!M ( ,,
- -ws 4B A$B )rf re r{ Nr )2r r r r r! _operator_regex_str_version_regex_strrecompileVERBOSE
IGNORECASEra r rD r rG rh rH r5 rI r` r r r) r r rE r- rF r2 CallableOperatorr r r r r r r r r r r r UnparsedVersionr< r r r r@ r" r r r rL rL k s \ | ZZ%%(::WD
R]]"F "
J(S (HTN (d (4 T . " "$ " " # B# B$* * 0sCx 0 0*# *=F =t =:! !(8 !
w
c
d
*'/' '/ '/ '/R:g :S :T :=g =S =T =#sG|!4 # #, DH,@#,@2:4.,@
,@^ UY; !34; CKD>; $ %; ; r rL z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c / nU R S5 HQ n[ R U5 nU( a! UR UR 5 5 M@ UR U5 MS U$ )Nr )split
_prefix_regexrb extendgroupsr )r resultr: rg s r r r sR F
c" $$T* MM%,,. ) MM$ # Mr segmentc 8 ^ [ U 4S jS 5 5 ( + $ )Nc 3 F ># U H nTR U5 v M g 7fr )
startswith).0r r s r !_is_not_suffix.. s# 1Pv6""1Ps !)devabrcpost)any)r s `r r r s" 1P r leftrightc / / p2UR [ [ R " S U 5 5 5 UR [ [ R " S U5 5 5 UR U [ US 5 S 5 UR U[ US 5 S 5 UR SS/[
S[ US 5 [ US 5 -
5 - 5 UR SS/[
S[ US 5 [ US 5 -
5 - 5 [ [ R " U6 5 [ [ R " U6 5 4$ )Nc " U R 5 $ r isdigitxs r _pad_version.. s
r c " U R 5 $ r r r s r r r s
!))+r r r 0)r r r r r insertmaxchain)r r
left_split right_splits r r r s " d9../DdKLMtI / /0Eu MNO d3z!}-/01uSQ 0 234 a#QKN(;c*Q->P(P!QQRq3%#aZ]);c+a.>Q)Q"RRS *- .Y__k5R0S TTr c p \ rS rSrSr SS\S\\ SS4S jjr\ S\\ 4S j5 r
\
R S \SS4S
j5 r
S\4S jr S\4S jr
S\4S
jrS\S \4 SS 4S jrS\S\4S jrS\4S jrS\\ 4S jrS\S\4S jr SS\S\\ S\\ S\4S jjr S S\\ S\\ S\\ 4S jjr Sr g) SpecifierSeti zThis 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.
N
specifiersr5 r c UR S5 Vs/ s H) o3R 5 ( d M UR 5 PM+ nn[ 5 nU H nUR [ U5 5 M [ U5 U l X l gs snf )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.
: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 rd setaddrL frozenset_specsrf )r( r r5 ssplit_specifiersparsed specifiers r rh SpecifierSet.__init__ st ( 0:/?/?/DR/D! IAGGI/DR "%)I JJy+ , * ' ( Ss
B
B
c U R b U R $ U R ( d g [ S U R 5 5 $ )Nc 3 8 # U H oR v M g 7fr r5 r r s r r +SpecifierSet.prereleases.. s 6+Q==+ )rf r r r' s r r5 SpecifierSet.prereleases s? ($$ $
{{ 6$++666r r7 c Xl g r rq r9 s r r5 r" rr r c d U R b SU R < 3OSnS[ U 5 < U S3$ )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')
=1.0.0')>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
=1.0.0', prereleases=False)>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
=1.0.0', prereleases=True)>
rz r{ z>> 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 8 # U H n[ U5 v M g 7fr )rD r s r r 'SpecifierSet.__str__.. s ;{!s1vv{r! )r sortedr r' s r r) SpecifierSet.__str__ s" xx ;t{{ ;;<>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
=1.0.0')>
>>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
=1.0.0')>
zFCannot combine SpecifierSets with True and False prerelease overrides.)r rD r r r r rf
ValueError)r( r/ r s r __and__SpecifierSet.__and__
s eS ! ! 'EE<00! ! N $T[[5<<%?@ $););)G%*%7%7I "
*u/A/A/I%)%6%6I "
%"4"4
4%)%6%6I "
r c [ U[ [ 45 ( a [ [ U5 5 nO[ U[ 5 ( d [ $ U R
UR
:H $ )a1 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 rD rL r r r r1 s r r2 SpecifierSet.__eq__- sJ & ec9 - . . U,EE<00! !{{ell**r c , [ U R 5 $ )z7Returns the number of specifiers in this specifier set.)r r r' s r __len__SpecifierSet.__len__G s 4;; r c , [ U R 5 $ )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)
[, =1.0.0')>]
)iterr r' s r __iter__SpecifierSet.__iter__K s DKK r r: c $ U R U5 $ )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 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 SpecifierSet.__contains__U r r installedc 0 ^^ [ T[ 5 ( d [ T5 mTc U R mT( d TR ( a gU( a& TR ( a [ TR 5 m[ UU4S jU R 5 5 $ )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 B ># U H oR TTS 9v M g7f)r Nr )r r r: r5 s r r (SpecifierSet.contains.. s Rk::d : c Uc U R nU R ( a7 U R H nUR U[ U5 S9nM [ U5 $ / n/ nU HS n[ U5 nUR ( a# U( d U( d UR U5 M@ MB UR U5 MU U( d U( a Uc [ U5 $ [ U5 $ )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', ]
>>> 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 )r5 r r@ rG r7 r rn r )r( r> r5 r] filteredr r: r s r r@ SpecifierSet.filter s X **K
;; ;;xT+=N;O $> !
24H:< !0!6 "// #)006 $ OOD) ! 1k6I -..> !r )rf r r )NNr ) r r r r r! rD r rG rh rH r5 rI r r) rE r- r r/ rF r2 r4 r rL r8 r r r< r r r@ r" r r r r r s{ CG!( !(19$ !(
!(F 7Xd^ 7 7 " "$ " "5# 5* = =!# ! U>3#6 7 N @+F +t +4 !(9- !# #T #0 '+$( 7S 7S d^7S D> 7S
7St UYM" !34M"CKD>M" $ %M" M"r r )#r! rB r r typingr r r r r r r r
r utilsr
r r rD r r rG r r r. r ABCMetar$ rL r r r r r r r r r rH s
( % 1 I WcND 01 _ z 4 ckk 4 nU
U p
<=
C DI C D UtCy Uc UuT#YS =Q7R U$G"= G"r