/opt/support/venv/lib/python3.13/site-packages/packaging/__pycache__
Edit: /opt/support/venv/lib/python3.13/site-packages/packaging/__pycache__/specifiers.cpython-313.pyc (39460B)
i] h S r SSKJr SSKrSSKrSSKrSSKJrJrJ r J
r
J r J r SSK
Jr SSKJrJr \ \\4 r\ " S\S 9r\\\/\4 rSS
jrS S jrS S jr " S
S\5 r " S S\R8 S9r " S S\ 5 r \R> " S5 r S S jr!S S jr"S S jr#S S jr$ " S S\ 5 r%g)!z
.. testsetup::
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
from packaging.version import Version
) annotationsN)CallableFinalIterableIteratorTypeVarUnion )canonicalize_version)InvalidVersionVersionUnparsedVersionVar)boundc l [ U [ 5 ( d [ U 5 n U $ U $ ! [ a g f = fN)
isinstancer
r versions F/opt/support/venv/lib/python3.13/site-packages/packaging/specifiers.py_coerce_versionr s= gw ' ' g&G N7N s &
33c U R S S9$ )N)local __replace__r s r _public_versionr # s T ** c & U R S S S S S9$ )N)prepostdevr r r s r
_base_versionr! ' s 4dD IIr 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 f \ rS rSrSrSr\S
S j5 r\R S
S j5 r
\R SS j5 r \R SS j5 r \\R SS j5 5 r
\
R SS j5 r
\R SSS jj5 r\R S SS jj5 rSrg
)
BaseSpecifier7 r% )_strc [ U 5 $ )z Internal property for match_argsstrselfs r r/ BaseSpecifier._str; s 4yr c g)zv
Returns the str representation of this Specifier-like object. This
should be representative of the Specifier itself.
Nr% r3 s r __str__BaseSpecifier.__str__@ r c g)z6
Returns a hash value for this Specifier-like object.
Nr% r3 s r __hash__BaseSpecifier.__hash__G r9 r c 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% r4 others r __eq__BaseSpecifier.__eq__M r9 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% r3 s r prereleasesBaseSpecifier.prereleasesV r9 r c g)zASetter for :attr:`prereleases`.
:param value: The value to set.
Nr% r4 values r rC rD _ r9 r Nc g)zB
Determines if the given item is contained within this specifier.
Nr% r4 itemrC s r containsBaseSpecifier.containsf r9 r c 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% )r4 iterablerC s r filterBaseSpecifier.filterl r9 r returnr2 rR intr? objectrR boolrR bool | None)rG rW rR Noner )rJ r2 rC rY rR rW rN z Iterable[UnparsedVersionVar]rC rY rR z Iterator[UnparsedVersionVar])r& r' r( r) __slots____match_args__propertyr/ abcabstractmethodr7 r; r@ rC setterrK rO r+ r% r r r- r- 7 s I N
QU 4 CN % r r- ) metaclassc \ rS rSr% SrSrSrSr\R " S\- \- S- \R \R - 5 r SSS S
S S S
SS.r
S\S' S+S,S jjrS-S jrS.S jr\S/S j5 r\R( S0S j5 r\S1S j5 r\S1S j5 rS1S jrS1S jr\S2S j5 rS3S jrS4S jrS5S jr S6S jr S6S! jr S6S" jr S6S# jr S6S$ jr!S7S% jr"S7S& jr#S8S' jr$S9S( jr%S:S;S) jjr& S: S
(~=|==|!=|<=|>=|<|>|===))
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.
(?=<>===r
_operatorsNc U R R U5 nU( d [ SU< 35 eUR S5 R 5 UR S5 R 5 4U l X l SU 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)_regex fullmatchr# groupstriprg rf rh )r4 specrC matchs r __init__Specifier.__init__ su %%d+"%8#AB B
KK
# ) ) + KK " ( ( *'
( :>r c U R b" U R S U:X a U R S $ [ U5 nUc gX4U l U$ )zDOne element cache, as only one spec Version is needed per Specifier.Nr r
)rh r )r4 r version_specifiers r _get_spec_versionSpecifier._get_spec_version sV )d.@.@.Cw.N%%a( ( +G 4 $ % 9 r c 2 U R U5 nUc eU$ )zGet 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 ===).
)r )r4 r spec_versions r _require_spec_version Specifier._require_spec_version s& --g6 '''r c U R b U R $ U R u pUS:w aD US:X a UR S5 ( a gU R U5 nUc g UR ( a gg)Nrs rr .*FT)rf rg endswithr
is_prerelease)r4 rz version_strr s r rC Specifier.prereleases% sz ($$ $ !%
t 4 K$8$8$>$> ,,[9G $$r c Xl g r rf rF s r rC r B !r c U R S $ )zHThe operator of this specifier.
>>> Specifier("==1.2.3").operator
'=='
r rg r3 s r rz Specifier.operatorF zz!} r c U R S $ )zIThe version of this specifier.
>>> Specifier("==1.2.3").version
'1.2.3'
r
r r3 s r r Specifier.versionO r 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= ru ()>)rf rC __class__r& r2 r4 r s r __repr__Specifier.__repr__X 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{}{})formatrg r3 s r r7 Specifier.__str__j s }}djj))r c U R u pUS:X d UR S5 ( a X4$ U R U5 n[ X1S:g S9nX4$ )Nrw r rq strip_trailing_zero)rg r r r )r4 rz r r canonical_versions r _canonical_specSpecifier._canonical_spect s] JJ u 0 0 6 6$ $11': 0 4/?
**r c , [ U R 5 $ r )hashr r3 s r r; Specifier.__hash__ s D(())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 r2 r r# NotImplementedr r> s r r@ Specifier.__eq__ sm & eS ! !
& s5z2 E>>22! !##u'<'<<< $
&%%
&s A+ +A>=A>c > [ U SU R U 35 nU$ )N _compare_)getattrrx )r4 opoperator_callables r
_get_operatorSpecifier._get_operator s+ .5 Idoob 1 23/
! r c
[ [ [ R " [ [ U5 5 5 S S 5 nUS-
nU R
S5 " X5 =( a U R
S5 " X5 $ )Nr rt rr )
_version_joinlist itertools takewhile_is_not_suffix_version_splitr )r4 prospectiver prefixs r _compare_compatible Specifier._compare_compatible sn $$^^D5IJ KCR P
$!!$' :
t?Q?QRV?W @
r c : UR S5 ( aU [ [ U5 SS9n[ US S SS9n[ U5 n[ U5 n[ Xe5 u pxUS [ U5 n X:H $ U R
U5 n
U
R ( d [ U5 nX:H $ )Nr Fr )r r r r _pad_versionlenr r ) r4 r r normalized_prospectivenormalized_spec
split_specsplit_prospectivepadded_prospective_shortened_prospectiver s r _compare_equalSpecifier._compare_equal s == %9 ,%& " 349RW XO (8J
!//E F %11B$O !
%77HZ $I !(6 6 55d;L
%% -k : . .r c . U R X5 ( + $ r )r r4 r r s r _compare_not_equal Specifier._compare_not_equal s &&{999r c < [ U5 U R U5 :* $ r r r r s r _compare_less_than_equal"Specifier._compare_less_than_equal {+t/I/I$/OOOr c < [ U5 U R U5 : $ r r r s r _compare_greater_than_equal%Specifier._compare_greater_than_equal r r c U R U5 nX: d gUR ( d* UR ( a [ U5 [ U5 :X a ggNFT)r r r! r4 r spec_strr s r _compare_less_than Specifier._compare_less_than sM ))(3
! "")) k*mD.AA
r c U R U5 nX: d gUR ( d* UR ( a [ U5 [ U5 :X a gUR b [ U5 [ U5 :X a ggr )r is_postreleaser! r r s r _compare_greater_than Specifier._compare_greater_than sw ))(3
! ##** k*mD.AA (] .
4
.!
r c h [ U5 R 5 [ U5 R 5 :H $ r )r2 lowerr s r _compare_arbitrary Specifier._compare_arbitrary0 s& ; %%'3t9??+<<>> "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
rK r4 rJ s r __contains__Specifier.__contains__3 & }}T""r c H [ [ U R U/US95 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 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
rC )rW r rO rI s r rK Specifier.containsH s# 2 DdVEFGGr c # # / nSnUb UO U R nU R U R 5 nU H n[ U5 nUc: U R S:X a( U R XpR
5 ( a Uv MG MI MK U" XR
5 ( d Md UR ( a U( a SnUv M Ub M U R SLd M UR U5 M U( d Uc U R SLa U Sh vN gggg N7f)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', ]
>>> 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) rC r rz r r r r rf append) r4 rN rC prereleases_versionsfound_non_prereleasesinclude_prereleasesr r parsed_versions r rO Specifier.filterc s 0 " % '2K8H8H
! . .t}} = G ,W 5N %==E)d.E.E\\/ / "M/) #><<@@%337J,0)!M (T->->e-K(//8 ( &#!!.+ + + / $ &
,s$ BD
!D
>
D
3D
D D
r N)r r2 rC rY rR rZ )r r2 rR Version | None)r r2 rR r
rX rG rY rR rZ rQ )rR ztuple[str, str]rS rU )r r2 rR CallableOperator)r r
r r2 rR rW )r r
r r2 rR rW )r z
Version | strr r2 rR rW )rJ z
str | VersionrR rW r )rJ UnparsedVersionrC rY rR rW r[ ))r& r' r( r) r* r\ _operator_regex_str_version_regex_strrecompileVERBOSE
IGNORECASEr{ rx __annotations__r r r r^ rC ra rz r r r7 r r; r@ r r r r r r r r r r rK rO r+ r% r r rd rd v so ;I \ | ZZ$$'99FB
R]]"F "
J >8
! 8 " " B$* + +*=:!
(&/P:P P 6 D=#*H8 RV<,4<,CN<, %<, <,r rd z ([0-9]+)((?:a|b|c|rc)[0-9]+)c 2 / nU R S5 u p#nUR U=( d S5 UR S5 HQ n[ R U5 nU( a! UR UR
5 5 M@ UR U5 MS U$ )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 restrJ r s r r r sw F '',NEd
MM%,3
3 ''- MM%,,. ) MM$ Mr c 4 U tpU SSR U5 3$ )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% LEWAchhtn% &&r c 8 ^ [ U 4S jS 5 5 ( + $ )Nc 3 F ># U H nTR U5 v M g 7fr )
startswith).0r segments r !_is_not_suffix.. s# 1Pv6""1Ps !)r abrcr )any)r s `r r r s" 1P r c / / 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 R U5 5 [ [ R R U5 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
r
) r r r r r insertmaxchain
from_iterable)leftright
left_split right_splits r r r s3 " 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 \ rS rSrSrSr S SS jjr\SS j5 r\R SS j5 rSS jr
SS jr SS
jr SS jr
SS jrSS
jrSS jrSS jr S S S jjr S S S jjrSrg) 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.
)rf _specsNc , [ U[ 5 ( ad UR S5 Vs/ s H) o3R 5 ( d M UR 5 PM+ nn[ [ [ U5 5 U l O[ U5 U l X l gs snf )aL 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.
,N) r r2 r
r~ frozensetmaprd r5 rf )r4
specifiersrC ssplit_specifierss r r SpecifierSet.__init__ su , j# & & 4>3C3CC3H V3HaGGI 3H V $C 3C$DEDK $J/DK ( Ws BBc U R b U R $ U R ( d g [ S U R 5 5 ( a gg )Nc 3 8 # U H oR v M g 7fr r r r; s r r +SpecifierSet.prereleases.. s 2k}}k T)rf r5 r! r3 s r rC SpecifierSet.prereleases sE ($$ $
{{ 2dkk2 2 2r c Xl g r r rF s r rC rC $ r 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)>
r 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'
r7 c 3 8 # U H n[ U5 v M g 7fr r1 r@ s r r 'SpecifierSet.__str__..H s ;{!s1vv{rB )r sortedr5 r3 s r r7 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 r2 r4 r r8 r5 rf
ValueError)r4 r? specifiers r __and__SpecifierSet.__and__M s eS ! ! 'EE<00! ! N $T[[5<<%?@ $););)G%*%7%7I "
)e.@.@.H
%"4"4
4%)%6%6I " X
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 r2 rd r4 r r5 r> s r r@ SpecifierSet.__eq__l sJ & ec9 - . . U,EE<00! !{{ell**r c , [ U R 5 $ )z7Returns the number of specifiers in this specifier set.)r r5 r3 s r __len__SpecifierSet.__len__ 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')>]
)iterr5 r3 s r __iter__SpecifierSet.__iter__ s DKK 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")
True
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)
True
r r s r r SpecifierSet.__contains__ r r c [ U5 nUb U( a UR ( a SnUc UOUn[ [ U R U/US95 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 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
Tr )r r rW r rO )r4 rJ rC installedr
check_items r rK SpecifierSet.contains sN @ "$' 91F1F K $_T'
Dj\{KLMMr c , ^ Uc U R b U R nU R ( a6 U R H nUR Xc SOUS9nM Ub [ U5 $ O!USL a [ U5 $ USL a U 4S jU 5 $ / n/ nSnU Hl n[ U5 nUc$ UR U5 UR U5 M5 UR ( a UR U5 MY UR U5 SnMn [ U( a 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 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', ]
>>> 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']
Tr Fc 3 j ># U H( n[ U5 =mb TR ( a M$ Uv M* g 7fr )r r )r rJ r s r r &SpecifierSet.filter.. s3 (#24#88A"00 D (s #3 3)rC r5 rO rY r r r )
r4 rN rC r filtered_itemsfound_prereleasesfound_final_releaserJ r r s
@r rO SpecifierSet.filter s. N 4#3#3#? **K
;; ;; 2E$; ' $
& H~% ' d"H~%e# ( 4668 # D ,T 2N % %%d+!((. --!((. %%d+&*# &9NQQ?PQQr r )r: zstr | Iterable[Specifier]rC rY rR rZ rX r rQ rS )r? zSpecifierSet | strrR r4 rU )rR zIterator[Specifier])rJ r rR rW )NN)rJ r rC rY r_ rY rR rW r r[ )r& r' r( r) r* r\ r r^ rC ra r r7 r; rQ r@ rV rZ r rK rO r+ r% r r r4 r4 s +I 13#'$(-$( !$(
$(L & " "5* =! >+4 !#0 $(!% &N &N !&N &N
&NR RV[R4[RCN[R %[R [Rr r4 )r r rR r )r r
rR r
)r r2 rR list[str])r ri rR r2 )r r2 rR rW )r/ ri r0 ri rR ztuple[list[str], list[str]])&r*
__future__r r_ r r typingr r r r r r utilsr r r r
r2 r r rW r r r r! rO r# ABCMetar- rd r r r r r r r4 r% r r rn s #
F F ' , % 1 I WcND 01 +J z < ckk < ~i,
i,X
:;
,' *KR= KRr