o iu@s$dZddlmZddlZddlZddlZddlmZmZm Z m Z m Z m Z ddl mZddlmZmZe eefZe ded ZeeegefZd/ddZd0ddZd0ddZGdddeZGdddejdZGdddeZedZ d1dd Z!d2d"d#Z"d3d&d'Z#d4d+d,Z$Gd-d.d.eZ%dS)5z .. testsetup:: from pip._vendor.packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from pip._vendor.packaging.version import Version ) annotationsN)CallableFinalIterableIteratorTypeVarUnion)canonicalize_version)InvalidVersionVersionUnparsedVersionVar)boundversionUnparsedVersionreturnVersion | NonecCs2t|tszt|}W|StyYdSw|SN) isinstancer r rrZ/home/kim/smarthome/.venv/lib/python3.10/site-packages/pip/_vendor/packaging/specifiers.py_coerce_versions   rr cCs |jddS)N)localZ __replace__rrrr_public_version#s rcCs|jdddddS)N)prepostdevrrrrrr _base_version'src@seZdZdZdS)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__rrrrr +sr c@seZdZdZdZed!ddZejd!ddZ ejd"d d Z ejd#ddZ eejd$ddZ e j d%ddZ ejd&d'ddZej d&d(dd ZdS)) BaseSpecifierr)_strrstrcCst|S)z Internal property for match_argsr'selfrrrr&;szBaseSpecifier._strcCdS)z Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nrr)rrr__str__@zBaseSpecifier.__str__intcCr+)zF Returns a hash value for this Specifier-like object. Nrr)rrr__hash__Gr-zBaseSpecifier.__hash__otherobjectboolcCr+)z Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. Nrr*r0rrr__eq__Mr-zBaseSpecifier.__eq__ bool | NonecCr+)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. Nrr)rrr prereleasesVr-zBaseSpecifier.prereleasesvalueNonecCr+)zQSetter for :attr:`prereleases`. :param value: The value to set. Nrr*r7rrrr6_r-Nitemr6cCr+)zR Determines if the given item is contained within this specifier. Nrr*r:r6rrrcontainsfr-zBaseSpecifier.containsiterableIterable[UnparsedVersionVar]Iterator[UnparsedVersionVar]cCr+)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=r6rrrfilterlr-zBaseSpecifier.filterrr'rr.r0r1rr2rr5)r7r2rr8r)r:r'r6r5rr2r=r>r6r5rr?)r!r"r# __slots____match_args__propertyr&abcabstractmethodr,r/r4r6setterr<r@rrrrr%7s*     r%) metaclassc @sjeZdZUdZdZdZdZedeedej ej BZ dddd d d d d dZ de d<d\d]ddZd^ddZd_d d!Zed`d"d#Zejdad%d#Zedbd&d'Zedbd(d)Zdbd*d+Zdbd,d-Zedcd/d0Zddd2d3Zded7d8Zdfd;d<Zdgd>d?Zdgd@dAZdgdBdCZdgdDdEZdgdFdGZ dhdIdJZ!dhdKdLZ"didNdOZ#djdRdSZ$dkdldUdVZ% dkdmdZd[Z&dS)n 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). ) _prereleases_spec _spec_versionz8 (?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. (?=<>===r _operatorsNspecr'r6r5rr8cCsL|j|}|std||d|df|_||_d|_dS)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: operatorrN)_regex fullmatchr groupstriprOrNrP)r*rbr6matchrrr__init__s    zSpecifier.__init__rrcCsD|jdur|jd|kr|jdSt|}|durdS||f|_|S)zDOne element cache, as only one spec Version is needed per Specifier.Nrr )rPr)r*rZversion_specifierrrr_get_spec_versions  zSpecifier._get_spec_versionr cCs||}|dus J|S)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 ===). N)rj)r*r spec_versionrrr_require_spec_versions  zSpecifier._require_spec_versioncCs\|jdur|jS|j\}}|dkr,|dkr|drdS||}|dur'dS|jr,dSdS)Nr[rZ.*FT)rNrOendswithrj is_prerelease)r*rc version_strrrrrr6%s   zSpecifier.prereleasesr7cC ||_dSrrNr9rrrr6B cC |jdS)z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' rrOr)rrrrcF zSpecifier.operatorcCrt)zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rur)rrrrOrvzSpecifier.versioncCs8|jdur d|jnd}d|jjdt||dS)aTA 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)> N, prereleases=rar]()>)rNr6 __class__r!r'r*rrrr__repr__Xs zSpecifier.__repr__cCs dj|jS)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{}{})formatrOr)rrrr,js zSpecifier.__str__tuple[str, str]cCsF|j\}}|dks|dr||fS||}t||dkd}||fS)Nr_rmrYZstrip_trailing_zero)rOrnrlr )r*rcrrkZcanonical_versionrrr_canonical_spects  zSpecifier._canonical_specr.cC t|jSr)hashrr)rrrr/ zSpecifier.__hash__r0r1r2cCsPt|trz |t|}WntytYSwt||js"tS|j|jkS)a>Whether or not the two Specifier-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") True >>> (Specifier("==1.2.3", prereleases=False) == ... Specifier("==1.2.3", prereleases=True)) True >>> Specifier("==1.2.3") == "==1.2.3" True >>> Specifier("==1.2.3") == Specifier("==1.2.4") False >>> Specifier("==1.2.3") == Specifier("~=1.2.3") False )rr'rzr NotImplementedrr3rrrr4s    zSpecifier.__eq__opCallableOperatorcCst|d|j|}|S)N _compare_)getattrr`)r*roperator_callablerrr _get_operatorszSpecifier._get_operator prospectivecCsHttttt|dd}|d7}|d||o#|d||S)Nrmr\rZ) _version_joinlist itertools takewhile_is_not_suffix_version_splitr)r*rrbprefixrrr_compare_compatibles zSpecifier._compare_compatiblec Cs|dr2tt|dd}t|dddd}t|}t|}t||\}}|dt|} | |kS||} | js>t|}|| kS)NrmFr)rnr rr _pad_versionlenrlr) r*rrbZnormalized_prospectiveZnormalized_spec split_specsplit_prospectivepadded_prospective_shortened_prospectiverkrrr_compare_equals  zSpecifier._compare_equalcCs||| Sr)rr*rrbrrr_compare_not_equalszSpecifier._compare_not_equalcCst|||kSrrrlrrrr_compare_less_than_equalz"Specifier._compare_less_than_equalcCst|||kSrrrrrr_compare_greater_than_equalrz%Specifier._compare_greater_than_equalspec_strcCs:||}||ks dS|js|jrt|t|krdSdSNFT)rlrorr*rrrbrrr_compare_less_thans zSpecifier._compare_less_thancCsX||}||ks dS|js|jrt|t|krdS|jdur*t|t|kr*dSdSr)rlis_postreleaserrrrrr_compare_greater_thans  zSpecifier._compare_greater_than Version | strcCst|t|kSr)r'lowerrrrr_compare_arbitrary0szSpecifier._compare_arbitraryr: str | VersioncC ||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") True >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True r<r*r:rrr __contains__3 zSpecifier.__contains__rcCstt|j|g|dS)asReturn 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 r6)r2rr@r;rrrr<HszSpecifier.containsr=r>r?c csg}d}|dur |n|j}||j}|D]9}t|}|dur0|jdkr/|||jr/|Vq|||jrO|jr;|rAd}|Vq|durO|jdurO||q|sb|durd|jdurf|EdHdSdSdSdS)aFilter 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'] FNr_T) r6rrcrrrrorNappend) r*r=r6Zprereleases_versionsZfound_non_prereleasesZinclude_prereleasesrrparsed_versionrrrr@cs:     zSpecifier.filterraN)rbr'r6r5rr8)rr'rr)rr'rr rDr7r5rr8rA)rr~rBrC)rr'rr)rr rbr'rr2)rr rr'rr2)rrrbr'rr2)r:rrr2r)r:rr6r5rr2rE)'r!r"r#r$rFZ_operator_regex_strZ_version_regex_strrecompileVERBOSE IGNORECASErdr`__annotations__rirjrlrHr6rKrcrr|r,rr/r4rrrrrrrrrrr<r@rrrrrMvs`  ^               (     "  rMz([0-9]+)((?:a|b|c|rc)[0-9]+)r' list[str]cCs^g}|d\}}}||pd|dD]}t|}|r'||q||q|S)aSplit 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.) rpartitionrsplit _prefix_regexreextendgroups)rresultepochrrestr:rhrrrrs  r componentscCs|^}}|dd|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. rr)join)rrrrrrrsrsegmentr2cstfdddD S)Nc3s|]}|VqdSr) startswith).0rrrr s  z!_is_not_suffix..)rabrcr)anyrrrrrs  rleftrighttuple[list[str], list[str]]c Csgg}}|ttdd||ttdd|||t|dd||t|dd|ddgtdt|dt|d|ddgtdt|dt|dttj|ttj|fS)NcS|Srisdigitxrrrz_pad_version..cSrrrrrrrrrrr r) rrrrrinsertmaxchain from_iterable)rr left_split right_splitrrrrs ,,rc@seZdZdZdZ  d2d3d d Zed4d dZejd5ddZd6ddZ d6ddZ d7ddZ d8ddZ d9dd Z d7d!d"Zd:d$d%Zd;d(d)Z  dd?d0d1ZdS)@ 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. )rN_specsraN specifiersstr | Iterable[Specifier]r6r5rr8cCsDt|trdd|dD}ttt||_nt||_||_dS)aInitialize 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. cSsg|] }|r|qSr)rgrsrrr sz)SpecifierSet.__init__..,N)rr'r frozensetmaprMrrN)r*rr6split_specifiersrrrris   zSpecifierSet.__init__cCs6|jdur|jS|js dStdd|jDrdSdS)Ncss|]}|jVqdSrrrrrrrsz+SpecifierSet.prereleases..T)rNrrr)rrrr6s zSpecifierSet.prereleasesr7cCrqrrrr9rrrr6$rsr'cCs.|jdur d|jnd}dt||dS)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)> Nrwraz>> 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' rcss|]}t|VqdSrr(rrrrrHsz'SpecifierSet.__str__..)rsortedrr)rrrr,=s zSpecifierSet.__str__r.cCrr)rrr)rrrr/JrzSpecifierSet.__hash__r0SpecifierSet | strcCst|tr t|}nt|tstSt}t|j|jB|_|jdur-|jdur-|j|_|S|jdur7|jdus=|j|jkrC|j|_|Std)aReturn 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')> NzFCannot combine SpecifierSets with True and False prerelease overrides.)rr'rrrrrN ValueError)r*r0 specifierrrr__and__Ms    zSpecifierSet.__and__r1r2cCs6t|ttfrtt|}nt|tstS|j|jkS)aWhether 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 )rr'rMrrrr3rrrr4ls   zSpecifierSet.__eq__cCr)z7Returns the number of specifiers in this specifier set.)rrr)rrr__len__rszSpecifierSet.__len__Iterator[Specifier]cCr)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')>] )iterrr)rrr__iter__s zSpecifierSet.__iter__r:rcCr)aqReturn 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 rrrrrrrzSpecifierSet.__contains__ installedcCsFt|}|dur|r|jrd}|dur|n|}tt|j|g|dS)aReturn 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 NTr)rror2rr@)r*r:r6rrZ check_itemrrrr<s  zSpecifierSet.containsr=r>r?c s|dur |jdur |j}|jr+|jD]}|j||durdn|d}q|dur*t|Sn|dur3t|S|dur@fdd|DSg}g}d}|D]%}t|}|dur]||||qH|jrf||qH||d}qHt|rt|S|S)aFilter 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'] NTrFc3s*|]}t|dusjs|VqdSr)rro)rr:rrrrsz&SpecifierSet.filter..)r6rr@rrrro) r*r=r6rbZfiltered_itemsfound_prereleasesZfound_final_releaser:rrrrr@s:'       zSpecifierSet.filterr)rrr6r5rr8rDrrArB)r0rrrrC)rr)r:rrr2)NN)r:rr6r5rr5rr2rrE)r!r"r#r$rFrirHr6rKr|r,r/rr4rrrr<r@rrrrrs. &          )r)rrrr)rr rr )rr'rr)rrrr')rr'rr2)rrrrrr)&r$ __future__rrIrrtypingrrrrrrutilsr rr r r'rr r2rrrrrr ABCMetar%rMrrrrrrrrrrrs6        ? 0