B .ufh@sHdZddlZddlZddlZddlmZmZmZmZm Z m Z m Z m Z ddl mZddlmZe eefZe dedZeeegefZeed d d ZGd d d eZGdddejdZGdddeZedZeeed ddZeeedddZeedddZ eeeee eeeefdddZ!Gdd d eZ"dS)!z .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version N)CallableIterableIteratorListOptionalTupleTypeVarUnion)canonicalize_version)VersionUnparsedVersionVar)bound)versionreturncCst|tst|}|S)N) isinstancer )rrV/home/ankuromar296_gmail_com/myenv/lib/python3.7/site-packages/packaging/specifiers.py_coerce_versions rc@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__rrrrrs rc@seZdZejedddZejedddZeje e dddZ e eje e dd d Zeje d d d d Zejdee e e dddZejdeee e eedddZd S) BaseSpecifier)rcCsdS)z Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr)selfrrr__str__+szBaseSpecifier.__str__cCsdS)zF Returns a hash value for this Specifier-like object. Nr)rrrr__hash__2szBaseSpecifier.__hash__)otherrcCsdS)z Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. Nr)rrrrr__eq__8szBaseSpecifier.__eq__cCsdS)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)rrrr prereleasesAszBaseSpecifier.prereleasesN)valuercCsdS)zQSetter for :attr:`prereleases`. :param value: The value to set. Nr)rr!rrrr Js)itemr rcCsdS)zR Determines if the given item is contained within this specifier. Nr)rr"r rrrcontainsQszBaseSpecifier.contains)iterabler rcCsdS)z Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. Nr)rr$r rrrfilterWszBaseSpecifier.filter)N)N)rrrabcabstractmethodstrrintrobjectboolrpropertyrr setterr#rr rr%rrrrr*s r) metaclassc @seZdZdZdZdZedeedejej BZ dddd d d d d dZ dFe e eddddZeedddZejeddddZee dddZee dddZe dddZe ddd Zeee e fdd!d"Zedd#d$Zeed%d&d'Ze ed(d)d*Zee ed+d,d-Z ee ed+d.d/Z!ee ed+d0d1Z"ee ed+d2d3Z#ee ed+d4d5Z$ee ed6d7d8Z%ee ed6d9d:Z&ee ed+d;d<Z'e(e efed=d>d?Z)dGe*e eed@dAdBZ+dHe,e-e ee.e-dCdDdEZ/dS)I 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(~=|==|!=|<=|>=|<|>|===)) 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. (?=<>z===N)specr rcCsH|j|}|s td|d|d|df|_||_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)_regexsearchrgroupstrip_spec _prereleases)rr;r matchrrr__init__s  zSpecifier.__init__)rcCsR|jdk r|jS|j\}}|dkrN|dkr@|dr@|dd}t|jrNdSdS)N)z==z>=z<=z~=z===z==z.*TF)rCrBendswithr is_prerelease)rr=rrrrr s    zSpecifier.prereleases)r!rcCs ||_dS)N)rC)rr!rrrr scCs |jdS)z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r)rB)rrrrr=szSpecifier.operatorcCs |jdS)zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r )rB)rrrrrszSpecifier.versioncCs8|jdk rd|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)> Nz, prereleases=r:r8(z)>)rCr __class__rr()rprerrr__repr__$s 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{}{})formatrB)rrrrr6szSpecifier.__str__cCs*t|jd|jddkd}|jd|fS)Nr rz~=)strip_trailing_zero)r rB)rZcanonical_versionrrr_canonical_spec@szSpecifier._canonical_speccCs t|jS)N)hashrO)rrrrrHszSpecifier.__hash__)rrcCsPt|tr4y|t|}WqDtk r0tSXnt||jsDtS|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(rJrNotImplementedrO)rrrrrrKs  zSpecifier.__eq__)oprcCst|d|j|}|S)N _compare_)getattr _operators)rrRoperator_callablerrr _get_operatorhszSpecifier._get_operator) prospectiver;rcCsHttttt|dd}|d7}|d||oF|d||S)Nz.*z>=z==) _version_joinlist itertools takewhile_is_not_suffix_version_splitrW)rrXr;prefixrrr_compare_compatiblens zSpecifier._compare_compatiblec Cs|drbt|jdd}t|dddd}t|}t|}t||\}}|dt|} | |kSt|} | jszt|j}|| kSdS)Nz.*F)rNrF)rGr publicr_ _pad_versionlenr local) rrXr;Znormalized_prospectiveZnormalized_spec split_specsplit_prospectivepadded_prospective_shortened_prospective spec_versionrrr_compare_equals   zSpecifier._compare_equalcCs||| S)N)rl)rrXr;rrr_compare_not_equalszSpecifier._compare_not_equalcCst|jt|kS)N)r rb)rrXr;rrr_compare_less_than_equalsz"Specifier._compare_less_than_equalcCst|jt|kS)N)r rb)rrXr;rrr_compare_greater_than_equalsz%Specifier._compare_greater_than_equal)rXspec_strrcCs<t|}||ksdS|js8|jr8t|jt|jkr8dSdS)NFT)r rH base_version)rrXrpr;rrr_compare_less_thans zSpecifier._compare_less_thancCs^t|}||ksdS|js8|jr8t|jt|jkr8dS|jdk rZt|jt|jkrZdSdS)NFT)r is_postreleaserqre)rrXrpr;rrr_compare_greater_thans  zSpecifier._compare_greater_thancCst|t|kS)N)r(lower)rrXr;rrr_compare_arbitraryszSpecifier._compare_arbitrary)r"rcCs ||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 )r#)rr"rrr __contains__szSpecifier.__contains__)r"r rcCs<|dkr|j}t|}|jr$|s$dS||j}|||jS)alReturn 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 NF)r rrHrWr=r)rr"r normalized_itemrVrrrr# s  zSpecifier.contains)r$r rccsd}g}d|dk r|ndi}xH|D]@}t|}|j|f|r"|jrX|sX|jsX||q"d}|Vq"W|s|rx|D] }|VqtWdS)aOFilter 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'] Fr NT)rr#rHr append)rr$r yieldedfound_prereleaseskwrparsed_versionrrrr%;s     zSpecifier.filter)r:N)N)N)0rrrrZ_operator_regex_strZ_version_regex_strrecompileVERBOSE IGNORECASEr>rUr(rr+rEr,r r-r=rrLrrrOr)rr*rCallableOperatorrWr rarlrmrnrorrrtrvr rwUnparsedVersionr#rr rr%rrrrr/asV] ) -r/z^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCsbg}|d\}}}||pdx:|dD],}t|}|rP||q.||q.W|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.) rpartitionrysplit _prefix_regexr?extendgroups)rresultepochrirestr"rDrrrr_|s r_) componentsrcCs|^}}|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)rrrrrrrZsrZ)segmentrcstfdddD S)Nc3s|]}|VqdS)N) startswith).0r`)rrr sz!_is_not_suffix..)devabrcpost)any)rr)rrr^sr^)leftrightrc Csgg}}|ttdd||ttdd|||t|dd||t|dd|ddgtdt|dt|d|ddgtdt|dt|dttj|ttj|fS)NcSs|S)N)isdigit)xrrrz_pad_version..cSs|S)N)r)rrrrrrrr r) ryr[r\r]rdinsertmaxchain from_iterable)rr left_split right_splitrrrrcs ,,rcc@seZdZdZd$eeeddddZeeeddd Z e j edd d d Z edd d Z edddZ e dddZedefddddZeedddZe dddZeedddZeedddZd%eeeeeeddd Zd&eeeeeed!d"d#ZdS)' 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. r:N) specifiersr rcCs.dd|dD}ttt||_||_dS)aNInitialize 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. cSsg|]}|r|qSr)rA)rsrrr sz)SpecifierSet.__init__..,N)r frozensetmapr/_specsrC)rrr split_specifiersrrrrEszSpecifierSet.__init__)rcCs.|jdk r|jS|jsdStdd|jDS)Ncss|] }|jVqdS)N)r )rrrrrrsz+SpecifierSet.prereleases..)rCrr)rrrrr s  zSpecifierSet.prereleases)r!rcCs ||_dS)N)rC)rr!rrrr scCs.|jdk rd|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)> Nz, prereleases=r:z)rCr r()rrKrrrrLszSpecifierSet.__repr__cCsdtdd|jDS)anA 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' rcss|]}t|VqdS)N)r()rrrrrrsz'SpecifierSet.__str__..)rsortedr)rrrrrs zSpecifierSet.__str__cCs t|jS)N)rPr)rrrrrszSpecifierSet.__hash__)rrcCst|trt|}nt|ts"tSt}t|j|jB|_|jdkrX|jdk rX|j|_n<|jdk rv|jdkrv|j|_n|j|jkr|j|_ntd|S)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(rrQrrrC ValueError)rr specifierrrr__and__s       zSpecifierSet.__and__cCs6t|ttfrtt|}nt|ts*tS|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(r/rrQr)rrrrrr6s  zSpecifierSet.__eq__cCs t|jS)z7Returns the number of specifiers in this specifier set.)rdr)rrrr__len__PszSpecifierSet.__len__cCs t|jS)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)rrrr__iter__TszSpecifierSet.__iter__)r"rcCs ||S)arReturn 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#)rr"rrrrw^szSpecifierSet.__contains__)r"r installedrcs\ttstdkr |js.jr.dS|rBjrBtjtfdd|jDS)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 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 NFc3s|]}|jdVqdS))r N)r#)rr)r"r rrrsz(SpecifierSet.contains..)rr r rHrqallr)rr"r rr)r"r rr#ss    zSpecifierSet.contains)r$r rcCs|dkr|j}|jr>x |jD]}|j|t|d}qWt|Sg}g}x8|D]0}t|}|jrr|sr|s|||qL||qLW|s|r|dkrt|St|SdS)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'] N)r )r rr%r+rrrHry)rr$r r;filteredr{r"r}rrrr%s",    zSpecifierSet.filter)r:N)NN)N)rrrrr(rr+rEr,r r-rLrr)rr rr*rrrr/rrrwr#rr r%rrrrrs(    5r)#rr&r\r~typingrrrrrrrr utilsr rr r(rr r+rrrrABCMetarr/rrr_rZr^rcrrrrr s.(     7  *