+ )O|j>a0t$Rt^RIHt^RIt^RIt^RIt^RIHtHtH t H t H t H t ^RI HtHtHtHtHtHtHtHtHt^RIHt^RIHt]'d9^RIt^RIHtHtHt]P@R)8d^RIH!t!M^RI"H!t!^R I#H$t$^R I H%t%.R*Ot&RRlt'RRlt(RRlt)] !R4t*] ]]+3,t,] !R],R7t-R]P\R]P^R]P`R]Pb/t2R]3R&RRlt4!R R ]54t6!R!R ]PnR"7t8!R#R ]84t9R$R%lt:!R&R]84t;R'R(lt=<===!=z-dict[str, Callable[[Version, Version], bool]]_DIRECT_COMPARE_OPSc$V^8dQhRRRRRR/#)r specifierrparsedrr bool | Noner!)r"s"r#r$r$]s!9g+r%cVPwr#VPR4'gVPeR#\P V4pVeV!WP V44#VR9dkVP V4pVP VP 8wg.\VP4\VP48wdVR8XdW8#W8#R#R#)aMatch ``parsed`` against ``specifier`` without building a range. Handles ``>=``, ``<=``, ``==``, ``!=``, ``<``, ``>`` when the spec is not a wildcard and ``parsed`` has no local. Returns ``None`` when the range path must be used. Pre-release policy is left to the caller. .*N<)rF>) _specendswithlocalr?get_require_spec_versionepochrrelease)rArBop_strver_strdirect_comparespec_vs&& r# _fast_matchrS]s ooOF!9(,,V4N!f&E&Eg&NOO 009 <<6<< '<+G< NNL , '-m6? H H r%c]tRt^ztRtRtR#)rz 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' r!N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r!r%r#rrzsr%c]tRt^tRtRtRt]RRl4t] PRRl4t ] PRRl4t ] PRR l4t ]] PR R l44t]PR R l4t] PRRRll4t]P$RRRll4t]P$RRRll4t] PRRRll4tRtR#)rzG Abstract base class for :class:`Specifier` and :class:`SpecifierSet`. cV^8dQhRR/#rr r1r!)r"s"r#r$BaseSpecifier.__annotate__scr%c \V4#)z Internal property for match_argsr1selfs&r#_strBaseSpecifier._strs4yr%cV^8dQhRR/#r]r!)r"s"r#r$r^s   r%c R#)zv Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr!ras&r#__str__BaseSpecifier.__str__r%cV^8dQhRR/#rr intr!)r"s"r#r$r^s  # r%c R#)z6 Returns a hash value for this Specifier-like object. Nr!ras&r#__hash__BaseSpecifier.__hash__rir%c V^8dQhRRRR/#rotherr,r r6r!)r"s"r#r$r^s  F t r%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!rbrrs&&r#__eq__BaseSpecifier.__eq__rir%cV^8dQhRR/#rr rCr!)r"s"r#r$r^s  [ r%c R#)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!ras&r# prereleasesBaseSpecifier.prereleasesrir%c V^8dQhRRRR/#)rvaluer6r Noner!)r"s"r#r$r^s   $ r%c R#)zASetter for :attr:`prereleases`. :param value: The value to set. Nr!rbr}s&&r#rzr{rir%Nc$V^8dQhRRRRRR/#)ritemr1rzrCr r6r!)r"s"r#r$r^s!  S { d r%c R#)zB Determines if the given item is contained within this specifier. Nr!)rbrrzs&&&r#containsBaseSpecifier.containsrir%c(V^8dQhRRRRRRRR/# riterablezIterable[UnparsedVersionVar]rzrCkeyr~r zIterator[UnparsedVersionVar]r!)r"s"r#r$r^2++.+!+ + & +r%c R#r'r!rbrrzrs&&&&r#filterBaseSpecifier.filter (+r%c(V^8dQhRRRRRRRR/# rrz Iterable[T]rzrCrzCallable[[T], UnparsedVersion]r z Iterator[T]r!)r"s"r#r$r^2!,   r%c R#r'r!rs&&&&r#rr r%c(V^8dQhRRRRRRRR/# rr Iterable[Any]rzrCr'Callable[[Any], UnparsedVersion] | Noner Iterator[Any]r!)r"s"r#r$r^s2     !  5    r%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!rs&&&&r#rrrir%r!)rcr'N.NN)rUrVrWrXrY __slots____match_args__propertyrcabcabstractmethodrgrnrurzsetterrtypingoverloadrrZr!r%r#rrsIN                  __++ __     r%) metaclasscP]tRt^t$RtR?tRt]P!R],R,]P]P,4t RRRRRR R R R R RRRRRR/t R] R&R@RRlltRRltRRltRRlt]RR l4t]P(R!R"l4tR#R$ltR%R&lt]R'R(l4t]R)R*l4tR+R,ltR-R.lt]R/R0l4tR1R2ltR3R4ltR5R6ltRAR7R8llt] PBRBR9R:ll4t"] PBRBR;R<ll4t"RCR=R>llt"R?t#R#)DraThis 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). Instances are safe to serialize with :mod:`pickle`. They use a stable format so the same pickle can be loaded in future packaging releases. .. versionchanged:: 26.2 Added a stable pickle format. Pickles created with packaging 26.2+ can be unpickled with future releases. Backward compatibility with pickles from packaging < 26.2 is supported but may be removed in a future release. a  (?: (?: # 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 .* | (?a: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?a: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?a:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?a:\+[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. (?:<=|>=|<|>) \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?a: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?a: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?a:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) z\s*~= compatibler=equalr> not_equalr<less_than_equalr;greater_than_equalrF less_thanrG greater_than=== arbitraryr _operatorsNc$V^8dQhRRRRRR/#)rr+r1rzrCr r~r!)r"s"r#r$Specifier.__annotate__cs!!7!7S!7K!74!7r%c VPPV4'g\RV: 24hVP4pVP R4'd!VR,VR,P4rCMVVP R 4'd!VR,VR,P4rCMVR,VR,P4rCW43VnW nR VnR VnR #) aInitialize 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: r:NN:rNN:NrN:rNN:NNrNNN)rr=r>r<r;) _regex fullmatchrstrip startswithrH _prereleases _spec_version_ranges)rbr+rzoperatorversions&&& r#__init__Specifier.__init__cs{{$$T**"%8#AB Bzz| ??5 ! ! $R$r(..*:g __; < < $R$r(..*:g $R$r(..*:g'/&9 (:>37 r%c V^8dQhRRRR/#)rrr1r zVersion | Noner!)r"s"r#r$rs ! ! ! !r%c VPe,VP^,V8XdVP^,#\V4pVfR#W3VnV#)zDOne element cache, as only one spec Version is needed per Specifier.N)rr )rbrversion_specifiers&& r#_get_spec_versionSpecifier._get_spec_versionsV    )d.@.@.Cw.N%%a( (*73  $%9  r%c V^8dQhRRRR/#)rrr1r rr!)r"s"r#r$rsSWr%c 4VPV4pVfQhV#)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)rbr spec_versions&& r#rLSpecifier._require_spec_versions& --g6 '''r%cV^8dQhRR/#rr zSequence[Interval]r!)r"s"r#r$rs.r%c VPe VP#VPpVPpVR8Xd\pM,VP VP R44p\ WV4pW0nV#)zConvert this specifier to sorted, non-overlapping version ranges. Each standard operator maps to one or two ranges. ``===`` is modeled as full range (actual check done separately). Cached. rrE)rrrr rL removesuffixr )rboprPresultrs& r# _to_rangesSpecifier._to_rangessg << #<<  ]],, ;)3F001E1Ed1KLG$R':F  r%cV^8dQhRR/#rxr!)r"s"r#r$rs%%[%r%c VPe VP#VPwrVR8XdR#VR8XdVPR4'dR#VPV4pVfR#VP#)Nr>Fr=rE)rrHrIr is_prerelease)rbr version_strrs& r#rzSpecifier.prereleasessz    ($$ $!%  t  t  4 4T : :((5 ?$$$r%c V^8dQhRRRR/#rr}rCr r~r!)r"s"r#r$rs""""r%c WnR#r')rrs&&r#rzrs!r%cV^8dQhRR/#)rr z#tuple[tuple[str, str], bool | None]r!)r"s"r#r$rs//A/r%c 2VPVP3#r')rHrras&r# __getstate__Specifier.__getstate__s D--..r%c V^8dQhRRRR/#rstater,r r~r!)r"s"r#r$rsDD&DTDr%c RVnRVn\V\4'd\ V4^8Xd5Vwr#\ V4'd \ V4'dW nW0nR#\ V4^8Xdu\V^,\4'dXVwrEVPR4pVPRR4p\ V4'd \ V4'dW nW0nR#\V\4'dTVPR4pVPRR4p\ V4'd \ V4'dW nW0nR#\RV: 24h)NrHrinvalidzCannot restore Specifier from ) rrr.r/r0r2r7rHrdictrK TypeError)rbrr+rz_ slot_dicts&& r# __setstate__Specifier.__setstate__s! eU # #5zQ$)!!$''M+,F,F!%J(3%5zQ:eAh#=#=$  }}W-'mmNIF !$''M+,F,F!%J(3% eT " "99W%D))NI>Kd## k(B(B! $/!8 BCCr%cV^8dQhRR/#r]r!)r"s"r#r$rs#r%c (VP^,#)zHThe operator of this specifier. >>> Specifier("==1.2.3").operator '==' rHras&r#rSpecifier.operatorzz!}r%cV^8dQhRR/#r]r!)r"s"r#r$rsr%c (VP^,#)zIThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' rras&r#rSpecifier.versionrr%cV^8dQhRR/#r]r!)r"s"r#r$r sBB#Br%c VPeRVP: 2MRpRVPP R\ V4: V R2#)aA 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=rF()>rrz __class__rUr1rbr4s& r#__repr__Specifier.__repr__ sU  ,T--0 1 4>>**+1SYM#bAAr%cV^8dQhRR/#r]r!)r"s"r#r$rs***r%c 6RP!VP!#)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{}{})r"rHras&r#rgSpecifier.__str__s}}djj))r%cV^8dQhRR/#)rr ztuple[str, str]r!)r"s"r#r$r's + + +r%c VPwrVR8XgVPR4'dW3#VPV4p\W1R8gR7pW3#)rrEr)strip_trailing_zero)rHrIrLr)rbrrrcanonical_versions& r#_canonical_specSpecifier._canonical_spec&s] JJ u  0 0 6 6$ $11': 0 4/? **r%cV^8dQhRR/#rkr!)r"s"r#r$r4s**#*r%c ,\VP4#r')hashrras&r#rnSpecifier.__hash__4sD(())r%c V^8dQhRRRR/#rqr!)r"s"r#r$r7s==F=t=r%c \V\4'dVP\V44pM!\WP4'g\#VP VP 8H# \d \u#i;i)aWhether 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.r1rrNotImplementedrrts&&r#ruSpecifier.__eq__7sm& eS ! ! &s5z2E>>22! !##u'<'<<< $ &%% &sA--BBc V^8dQhRRRR/#)rrz str | Versionr r6r!)r"s"r#r$rTs###4#r%c $VPV4#)aReturn 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 rrbrs&&r# __contains__Specifier.__contains__T&}}T""r%c$V^8dQhRRRRRR/#)rrUnparsedVersionrzrCr r6r!)r"s"r#r$ris"6>6>_6>;6>RV6>r%c  rVP^,R8Xd'\\VPV.VR744#\ V4pVfR#Vf!\ VP VP4pVRJdVP'dR#\W4pVeV#\VP4V4#)aWReturn 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:`~packaging.version.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 .. versionchanged:: 26.0 With ``prereleases=None``, a prerelease now matches. A single version has no alternatives, so the :pep:`440` rule to accept prereleases when nothing else satisfies the specifier applies. Earlier versions rejected it. An unparsable version now returns ``False`` instead of raising :exc:`~packaging.version.InvalidVersion`. rrzF) rHr6listrr rrrzrrSrr)rbrrzrBmatchs&&& r#rSpecifier.containsisD ::a=E !T[[$[[IJK K% >  -d.?.?AQAQRK % F$8$8$8D)  L"4??#4f==r%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$rrr%c R#r'r!rs&&&&r#rSpecifier.filterrr%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$rrr%c R#r'r!rs&&&&r#rrrr%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$rs84O4O4O!4O5 4O  4Or%c aaVf!\VPVP4pVPR8Xd5VPP 4oVV3RlV4p\ VSV4#\VP4VSV4#)aFilter items in the given iterable, that match the specifier. :param iterable: An iterable that can contain version strings and :class:`~packaging.version.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. :param key: A callable that takes a single argument (an item from the iterable) and returns a version string or :class:`~packaging.version.Version` instance to be used for filtering. >>> 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'] >>> list(Specifier(">=1.2.3").filter( ... [{"ver": "1.2"}, {"ver": "1.3"}], ... key=lambda x: x["ver"])) [{'ver': '1.3'}] .. versionchanged:: 26.1 Added the ``key`` parameter. rc3<"TF3p\SfTMS!V44P4S8XgK/VxK5 R#5ir')r1lower).0rr spec_lowers& r# #Specifier.filter..s:$Ds{tD :@@BjP$s,> >) rrrzrrr%_apply_prereleases_filterr r)rbrrzrmatchesr's&&&f @r#rrszP  -d.?.?AQAQRK ==E !++-J$G -Wc;G G 18S+NNr%)rrrHrrNr'rr)$rUrVrWrXrYr_specifier_regex_strrecompileVERBOSE IGNORECASErr__annotations__rrrLrrrzrrrrrrrgrrnrurrrrrrZr!r%r#rrsf&IZ xZZ%%. R]]0JF l g k  " [ ^ { J !7F !*%%6""/ DBB$* + +*=:#*6>p __++ __4O4Or%c(V^8dQhRRRRRRRR/#) rr+rrrrzrCr rr!)r"s"r#r$r$s0  0 r%cfaaVf \VS4#V'd \V4#VV3RlV4#)zApply ``prereleases=`` handling to an already-matched iterable. ``None`` means PEP 440 default (buffer pre-releases until a final appears); ``True`` yields everything; ``False`` drops pre-releases. c3<"TF6p\SfTMS!V44;oeSP'dK2VxK8 R#5ir')r r)r&rrrBs& r#r(,_apply_prereleases_filter..s= D$S[Tc$iH HF Q## s /A A)_pep440_filter_prereleasesiter)r+rrzrBs&f&@r#r*r*s7)'377G}  r%c]tRtRtRtR8tR9RRlltRRlt]RR l4t ] PR R l4t R R lt RRlt RRlt RRltRRltRRltRRltRRltRRltRRltR R!ltR"R#ltR$R%ltR&R'ltR(R)ltR*R+ltR,R-ltR.R/ltR:R0R1llt]P>R;R2R3ll4t ]P>R;R4R5ll4t R:R6R7llt R8t!R#)=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. Instances are safe to serialize with :mod:`pickle`. They use a stable format so the same pickle can be loaded in future packaging releases. .. versionchanged:: 26.2 Added a stable pickle format. Pickles created with packaging 26.2+ can be unpickled with future releases. Backward compatibility with pickles from packaging < 26.2 is supported but may be removed in a future release. Nc$V^8dQhRRRRRR/#)r specifierszstr | Iterable[Specifier]rzrCr r~r!)r"s"r#r$SpecifierSet.__annotate__s(*(*(-*(!*(  *(r%c 4\V\4'doVPR4Uu.uF*q3P4'gKVP4NK, pp\ \ \ V44VnRV9VnM]\ V4Vn\;QJd&RVP4F 'gK RM RM!RVP44Vn\VP4^8*Vn RVn RVn W nR#uupi)aLInitialize 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. ,rc3>"TFpR\V49xK R#5irNr`r&ss& r#r((SpecifierSet.__init__..<s%K{!es1vo{TFN)r.r1splitrr/mapr_specs_has_arbitraryanyr0_canonicalized_is_unsatisfiablerr)rbr;rzrBsplit_specifierss&&& r#rSpecifierSet.__init__s, j# & &4>3C3CC3HV3HaGGI  3H V16s9FV7W1XDK"':"5D  +DK#&#%Kt{{%K###%Kt{{%K"KD !$++.!3.226 (# Ws DDcV^8dQhRR/#)rr ztuple[Specifier, ...]r!)r"s"r#r$r<Fs"7r%c  VP'gD\\P\ VP \ R744VnRVnVP #)zBDeduplicate, sort, and cache specs for order-sensitive operations.rT)rJr/rfromkeyssortedrGr1ras&r#_canonical_specsSpecifierSet._canonical_specsFs@""" fT[[c.J KLDK"&D {{r%cV^8dQhRR/#rxr!)r"s"r#r$r<Ns[r%c VPe VP#VP'gR#\;QJd&RVP4F 'gK RM RM!RVP44'dR#R#)Nc38"TFqPxK R#5ir'rrAs& r#r(+SpecifierSet.prereleases..\s2k}}kTF)rrGrIras&r#rzSpecifierSet.prereleasesMs[    ($$ $ {{{ 32dkk23332dkk2 2 2r%c V^8dQhRRRR/#rr!)r"s"r#r$r<bs&&&&r%c WnRVnR#r')rrKrs&&r#rzrZas!!%r%cV^8dQhRR/#)rr z)tuple[tuple[Specifier, ...], bool | None]r!)r"s"r#r$r<fs00G0r%c 2VPVP3#r')rGrras&r#rSpecifierSet.__getstate__fs T..//r%c V^8dQhRRRR/#rr!)r"s"r#r$r<ls7G7G&7GT7Gr%c LRVnRVn\V\4'Ed/\ V4^8XdVwr#\V\4'd\ ;QJdRV4F 'dK RM RM !RV44'dl\ V4'd[W nW0n\ V4^8*Vn \;QJdRV4F 'gK RM RM !RV44Vn R#\ V4^8XEdO\V^,\4'Ed1VwrEVPRR 4pVPR4p\V\4'd\\V\ R74p\V\4'd\ ;QJdRV4F 'dK RM RM !RV44'd\ V4'dyW nW0n\ VP4^8*Vn \;QJd&R VP4F 'gK RM RM!R VP44Vn R#\V\4'Ed-VPRR 4pVPR4p\V\4'd\\V\ R74p\V\4'd\ ;QJdR V4F 'dK RM RM !R V44'd\ V4'dyW nW0n\ VP4^8*Vn \;QJd&R VP4F 'gK RM RM!R VP44Vn R#\#R V: 24h)Nc3B"TFp\V\4xK R#5ir'r.rrAs& r#r(,SpecifierSet.__setstate__..wDeJq)44eFTc3>"TFpR\V49xK R#5ir@r`rAs& r#r(rd}s-Mu!es1vourDrGrrPc3B"TFp\V\4xK R#5ir'rcrAs& r#r(rdrerfc3>"TFpR\V49xK R#5ir@r`rAs& r#r(rds-S{!es1vo{rDc3B"TFp\V\4xK R#5ir'rcrAs& r#r(rds@%Q 1i00%rfc3>"TFpR\V49xK R#5ir@r`rAs& r#r(rds)O;a%3q6/;rDz!Cannot restore SpecifierSet from r!)rrKr.r/r0allr7rGrrJrIrHrrK frozensetrRr1r)rbrspecsrzrrs&& r#rSpecifierSet.__setstate__lsu !% eU # #5zQ%*"ue,,DeDDeDDD%k22"'K(3%*-e*/D'*-#-Mu-M###-Mu-M*MD'5zQ:eAh#=#=$ ! h3'mmN; eY//!&C"89Eue,,DeDDeDDD%k22"'K(3%*-dkk*:a*?D'*-#-St{{-S###-St{{-S*SD' eT " "IIh+E))N3K%++fU455%((C@%@CCC@%@@@!+..# $/!&)$++&6!&;#&)c)O4;;)Occc)O4;;)O&O#;E9EFFr%cV^8dQhRR/#r]r!)r"s"r#r$r<sBB#Br%c VPeRVP: 2MRpRVPP R\ V4: V R2#)aA 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)> rrrFrrrrs& r#rSpecifierSet.__repr__sU  ,T--0 1 4>>**+1SYM#bAAr%cV^8dQhRR/#r]r!)r"s"r#r$r<s A A Ar%c NRPRVP444#)a6A 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>c38"TFp\V4xK R#5ir'r`rAs& r#r('SpecifierSet.__str__..s@(?1A(?rY)joinrSras&r#rgSpecifierSet.__str__s"xx@(=(=(?@@@r%cV^8dQhRR/#rkr!)r"s"r#r$r<s--#-r%c 4\VP44#r')r rSras&r#rnSpecifierSet.__hash__sD))+,,r%c V^8dQhRRRR/#)rrrzSpecifierSet | strr rr!)r"s"r#r$r<s/Lr%c *\V\4'd \V4pM\V\4'g\#\4pVPVP,Vn\ VP4^8*VnVP;'g VPVnVPeVPVP8XdVPVnV#VPfVPVnV#\R4h)aRReturn 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' =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.r1rr rGr0rJrHr ValueError)rbrrrAs&& r#__and__SpecifierSet.__and__s eS ! ! 'EE<00! ! N ;;5 #&y'7'7#8A#=  #'#6#6#N#N%:N:N      $(9(9U=O=O(O%*%7%7I "   '%)%6%6I "  X r%c V^8dQhRRRR/#rqr!)r"s"r#r$r<sCCFCtCr%c \V\\34'd\\V44pM\V\4'g\#VP 4VP 48H#)a1Whether 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.r1rrr rSrts&&r#ruSpecifierSet.__eq__sT& ec9- . . U,EE<00! !$$&%*@*@*BBBr%cV^8dQhRR/#rkr!)r"s"r#r$r<s   r%c ,\VP4#)z7Returns the number of specifiers in this specifier set.)r0rGras&r#__len__SpecifierSet.__len__s4;;r%cV^8dQhRR/#)rr zIterator[Specifier]r!)r"s"r#r$r<s!!-!r%c ,\VP4#)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')>] )r8rGras&r#__iter__SpecifierSet.__iter__sDKK  r%cV^8dQhRR/#rr!)r"s"r#r$r<s  / r%c VPe VP#\RVP44VnVP#)zIntersect all specifiers into a single sequence of version ranges. Empty when unsatisfiable. Callers must ensure ``self._specs`` is non-empty. c3@"TFqP4xK R#5ir')rrAs& r#r(+SpecifierSet._get_ranges..s1V+Q,,..+s)rr rGras&r# _get_rangesSpecifierSet._get_rangess8 << #<< 11V$++1VV ||r%cV^8dQhRR/#rr r6r!)r"s"r#r$r<s!!$!r%c (VPpVeV#VP'g RVnR#VP4'*pV'gVP4pV'g*VPRJd\ VP44pW nV#)anCheck whether this specifier set can never be satisfied. Returns True if no version can satisfy all specifiers simultaneously. >>> SpecifierSet(">=2.0,<1.0").is_unsatisfiable() True >>> SpecifierSet(">=1.0,<2.0").is_unsatisfiable() False >>> SpecifierSet("").is_unsatisfiable() False >>> SpecifierSet("==1.0,!=1.0").is_unsatisfiable() True .. versionadded:: 26.1 F)rKrGr_check_arbitrary_unsatisfiablerzr)rbcachedrs& r#is_unsatisfiableSpecifierSet.is_unsatisfiables~ ''  M{{{%*D "%%''88:F$**e3/0@0@0BCF!' r%cV^8dQhRR/#rr!)r"s"r#r$r<As%@%@%@r%c aaVPUu.uFqPR8XgKVNK ppV'gR#V^,PP4o\;QJd&V3RlVR,4F 'gK RM RM!V3RlVR,44'dR#\ V^,P4oVP RJdSeSP'dR#VPUu.uFqPR8wgKVNK ppV'gR#SfR#\;QJd)V3RlV4F'dK R'*# R'*#!V3RlV44'*#uupiuupi)zCheck === (arbitrary equality) specs for unsatisfiability. === uses case-insensitive string comparison, so the only candidate that can match ``===V`` is the literal string V. This method checks whether that candidate is excluded by other specifiers. rFc3\<"TF!qPP4S8gxK# R#5ir')rr%)r&rBfirsts& r#r(>SpecifierSet._check_arbitrary_unsatisfiable..NsA=ayy E)=s),rTc3D<"TFqPS4xK R#5ir'r)r&rB candidates& r#r(rfs?hzz),,hs ) rGrrr%rIr rzrrl)rbrBrstandardrrs& @@r#r+SpecifierSet._check_arbitrary_unsatisfiableAs!% C 1zzU/BQQ C! $$**, 3A9R=A333A9R=A A A#9Q<#7#78    %%'''#{{B{!jjE.AAA{B  3?h?33??3??3?h????=D,CsE5E5=E:E:cV^8dQhRR/#)rr zranges.VersionRanger!)r"s"r#r$r<hs 6 6- 6r%c 0^RIHpVPV4#)a3Return the :class:`~packaging.ranges.VersionRange` this set accepts. An empty set yields the full range; an unsatisfiable set yields the empty range. ``===`` specifiers contribute literal-string admission. >>> SpecifierSet(">=1.0,<2.0").to_range() .. versionadded:: 26.3 ) VersionRange)rr_from_specifier_set)rbrs& r#to_rangeSpecifierSet.to_rangehs )//55r%c V^8dQhRRRR/#)rrrr,r r~r!)r"s"r#r$r<wsLLVLLr%c \V\4'g \R4hVP'gVP'd \ R4hR#)zexpected a SpecifierSetz+set relations do not support === specifiersN)r.rrrHr~rts&&r#_check_relation_operand$SpecifierSet._check_relation_operandwsC%..56 6    %"6"6"6JK K#7r%c V^8dQhRRRR/#rrrrr r6r!)r"s"r#r$r<}s;;|;;r%c ~VPV4VP4PVP44#)aReturn whether every version matching this set also matches other. :raises ValueError: If either set uses ``===`` specifiers, or the two sets were given different ``prereleases`` arguments (unset on one side counts as different). :raises TypeError: If other is not a :class:`SpecifierSet`. >>> SpecifierSet(">=3.12,<3.13").is_subset(SpecifierSet(">=3.12")) True >>> SpecifierSet(">=3.12").is_subset(SpecifierSet(">=3.12,<3.13")) False .. versionadded:: 26.3 )rr is_subsetrts&&r#rSpecifierSet.is_subset}s0" $$U+}}(()9::r%c V^8dQhRRRR/#rr!)r"s"r#r$r<s===$=r%c ~VPV4VP4PVP44#)aReturn whether every version matching other also matches this set. :raises ValueError: If either set uses ``===`` specifiers, or the two sets were given different ``prereleases`` arguments (unset on one side counts as different). :raises TypeError: If other is not a :class:`SpecifierSet`. >>> SpecifierSet(">=3.12").is_superset(SpecifierSet(">=3.12,<3.13")) True .. versionadded:: 26.3 )rr is_supersetrts&&r#rSpecifierSet.is_supersets0 $$U+}}**5>>+;<>> SpecifierSet("<3.12").is_disjoint(SpecifierSet(">=3.12")) True >>> SpecifierSet("<3.12").is_disjoint(SpecifierSet(">=3.11")) False .. versionadded:: 26.3 )rr is_disjointrts&&r#rSpecifierSet.is_disjoints0" $$U+}}**5>>+;<>> "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 rrs&&r#rSpecifierSet.__contains__rr%c(V^8dQhRRRRRRRR/#)rrrrzrC installedr r6r!)r"s"r#r$r<s>VNVNVN!VN VN  VNr%c  \V4pVeV'dVP'dRpVe)VP'd\V\4'gTpMTpVeVP'gVP fVP 'dVP'dVRJgVfVPRJdR#VPpVfHVP Fp\Wt4pVfMV'dKR# R#VP4;q`n\Wd4#\\VPV.VR744#)aTReturn 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:`~packaging.version.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 .. versionchanged:: 26.0 With ``prereleases=None``, a prerelease now matches. A single version has no alternatives, so the :pep:`440` rule to accept prereleases when nothing else satisfies the specifiers applies. Earlier versions rejected it. An unparsable version now returns ``False`` instead of raising :exc:`~packaging.version.InvalidVersion`. TFr)r rrHr.rrJrGrrrSrrr6rr) rbrrzrr check_itemboundsr+rs &&&& r#rSpecifierSet.containssP!&  91F1F1FK ?t222:dG;T;TJ J  ''' % $$$u$'D,=,=,F\\F~ !KKD'6E} 5$ ( (,(8(8(::&v7 7Dj\{KLMMr%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$r<%rr%c R#r'r!rs&&&&r#rSpecifierSet.filter$rr%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$r<-rr%c R#r'r!rs&&&&r#rr,rr%c(V^8dQhRRRRRRRR/#rr!)r"s"r#r$r<4s>SESESE!SE5 SE  SEr%c JaaVfVPe VPpVP'dfVP'd'VPoVV3RlV4p\VSV4#VPpVfVP 4p\ WQSV4#\VSV4#)aGFilter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`~packaging.version.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. :param key: A callable that takes a single argument (an item from the iterable) and returns a version string or :class:`~packaging.version.Version` instance to be used for filtering. >>> 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'] >>> list(SpecifierSet(">=1.2.3").filter( ... [{"ver": "1.2"}, {"ver": "1.3"}], ... key=lambda x: x["ver"])) [{'ver': '1.3'}] 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'] .. versionchanged:: 26.0 Prerelease filtering now follows the PEP 440 recommendation of yielding prereleases only when no final release is present. .. versionchanged:: 26.1 Added the ``key`` parameter. c3<a"TFKo\;QJd VV3RlS4F 'dK RM RM!VV3RlS44'gKGSxKM R#5i)c3b<"TF$pTPSfSMS!S4RR7xK& R#5i)NTrr)r&rBrrs& r#r(0SpecifierSet.filter...zs3!&A 3;4CISW XX!&s,/FTN)rl)r&rrrns&@r#r(&SpecifierSet.filter..wsD (s!&sss!&D (sAAA A)rzrGrHr*rrr )rbrrzrr+rrns&&&f @r#rr4sx  4#3#3#?**K ;;;"""  (1#{KK\\F~))+#Fc;G G)3 DDr%)rJrHrKrrrGr,rr)"rUrVrWrXrYrrrSrrzrrrrrgrnrrurrrrrrrrrrrrrrrrZr!r%r#rrs$I*(X&&&0 7GrB* A-@C4 ! !F%@N 6L ;(=$=(#*VNp __++ __SESEr%c$V^8dQhRRRRRR/#)rrrrrr rr!)r"s"r#r$r$s$' ' ' "I' ' r%c#".p.pRpVFp\VfTMV!V44pVf2V'dVxM"VPV4VPV4KOVP'gV'g TRjxL RpVxK{V'dKVPV4K V'g TRjxL R#R#LAL 5i)z?Filter per PEP 440: exclude prereleases unless no finals exist.FNT)r appendr)rr all_nonfinalarbitrary_strings found_finalrrBs&& r#r7r7s!L#%K TC > !((.##D) ###,,," J {    %16  - s@.B?:B?,B?4B?9B;:B?B?-B?2B=3 B?=B?)r )rrrr)=__conditional_annotations__rY __future__rrr.rrrrrrrrr r r r r rrrrutilsrrrsyscollections.abcrrr version_infortyping_extensionsrrrr(r)r2r7r8r1rr9__ge____le__ru__ne__r?r2rSr~rABCMetarrr*rr7)rs@r#rs$#    (<< 7"$/! 0 CL %1I '..'..'..'.. FB: z S ckkS lIO IOX,I E=I EX' r%