B d@s8dZddlZddlZddlZddlmZmZmZmZm Z m Z m Z m Z m Z ddlmZddlmZe eefZe dedZeeegefZeed d d ZGd d d eZGdddejdZGdddeZedZeeed ddZeedddZ eeeee eeeefdddZ!GdddeZ"dS)z .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version N) CallableIterableIteratorListOptionalSetTupleTypeVarUnion)canonicalize_version)VersionUnparsedVersionVar)bound)versionreturncCst|tst|}|S)N) isinstancer )rrY/var/www/html/venv/lib/python3.7/site-packages/setuptools/_vendor/packaging/specifiers.py_coerce_version"s 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__rrrrr(s 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__5szBaseSpecifier.__str__cCsdS)zF Returns a hash value for this Specifier-like object. Nr)rrrr__hash__<szBaseSpecifier.__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__BszBaseSpecifier.__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 prereleasesKszBaseSpecifier.prereleasesN)valuercCsdS)zQSetter for :attr:`prereleases`. :param value: The value to set. Nr)rr"rrrr!Ts)itemr!rcCsdS)zR Determines if the given item is contained within this specifier. Nr)rr#r!rrrcontains[szBaseSpecifier.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!rrrfilteraszBaseSpecifier.filter)N)N)rrrabcabstractmethodstrrintrobjectboolr propertyrr!setterr$rrrr&rrrrr4s 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)rDrCendswithr is_prerelease)rr>rrrrr!s    zSpecifier.prereleases)r"rcCs ||_dS)N)rD)rr"rrrr!scCs |jdS)z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r)rC)rrrrr>szSpecifier.operatorcCs |jdS)zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r )rC)rrrrr$szSpecifier.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;r9(z)>)rDr! __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{}{})formatrC)rrrrr?szSpecifier.__str__cCs*t|jd|jddkd}|jd|fS)Nr rz~=)strip_trailing_zero)r rC)rZcanonical_versionrrr_canonical_specIszSpecifier._canonical_speccCs t|jS)N)hashrP)rrrrrQszSpecifier.__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)rKrNotImplementedrP)rrrrrr Ts  zSpecifier.__eq__)oprcCst|d|j|}|S)N _compare_)getattr _operators)rrSoperator_callablerrr _get_operatorqszSpecifier._get_operator) prospectiver<rcCsJdtttt|dd}|d7}|d||oH|d||S)N.z.*z>=z==)joinlist itertools takewhile_is_not_suffix_version_splitrX)rrYr<prefixrrr_compare_compatiblews zSpecifier._compare_compatiblec Cs|dr^t|j}t|dddd}t|}t|}t||\}}|dt|} | |kSt|} | jsvt|j}|| kSdS)Nz.*rGF)rO)rHr publicra _pad_versionlenr local) rrYr<Znormalized_prospectiveZnormalized_spec split_specsplit_prospectivepadded_prospective_shortened_prospective spec_versionrrr_compare_equals   zSpecifier._compare_equalcCs||| S)N)rn)rrYr<rrr_compare_not_equalszSpecifier._compare_not_equalcCst|jt|kS)N)r rd)rrYr<rrr_compare_less_than_equalsz"Specifier._compare_less_than_equalcCst|jt|kS)N)r rd)rrYr<rrr_compare_greater_than_equalsz%Specifier._compare_greater_than_equal)rYspec_strrcCs<t|}||ksdS|js8|jr8t|jt|jkr8dSdS)NFT)r rI base_version)rrYrrr<rrr_compare_less_thans zSpecifier._compare_less_thancCs^t|}||ksdS|js8|jr8t|jt|jkr8dS|jdk rZt|jt|jkrZdSdS)NFT)r is_postreleasersrg)rrYrrr<rrr_compare_greater_thans  zSpecifier._compare_greater_thancCst|t|kS)N)r)lower)rrYr<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!rrIrXr>r)rr#r!normalized_itemrWrrrr$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$rIr!append)rr%r!yieldedfound_prereleaseskwrparsed_versionrrrr&Bs     zSpecifier.filter)r;N)N)N)0rrrrZ_operator_regex_strZ_version_regex_strrecompileVERBOSE IGNORECASEr?rVr)rr,rFr-r!r.r>rrMrrrPr*rr+r CallableOperatorrXr rcrnrorprqrtrvrxr ryUnparsedVersionr$rrrr&rrrrr0ksV] ' -r0z^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCsDg}x:|dD],}t|}|r2||q||qW|S)NrZ)split _prefix_regexr@extendgroupsr{)rresultr#rErrrras ra)segmentrcstfdddD S)Nc3s|]}|VqdS)N) startswith).0rb)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 0)r{r]r^r_rfinsertmaxchain)rr left_split right_splitrrrres ,,rec@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!rcCsJdd|dD}t}x|D]}|t|q Wt||_||_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)rB)rsrrr sz)SpecifierSet.__init__..,N)rsetaddr0 frozenset_specsrD)rrr!split_specifiersparsed specifierrrrrFs   zSpecifierSet.__init__)rcCs.|jdk r|jS|jsdStdd|jDS)Ncss|] }|jVqdS)N)r!)rrrrrrsz+SpecifierSet.prereleases..)rDrr)rrrrr!s  zSpecifierSet.prereleases)r"rcCs ||_dS)N)rD)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)rDr!r))rrLrrrrMszSpecifierSet.__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__..)r\sortedr)rrrrrs zSpecifierSet.__str__cCs t|jS)N)rQr)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)rrRrrrD ValueError)rrrrrr__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)r0rrRr)rrrrrr *s  zSpecifierSet.__eq__cCs t|jS)z7Returns the number of specifiers in this specifier set.)rfr)rrrr__len__DszSpecifierSet.__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__HszSpecifierSet.__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#rrrryRszSpecifierSet.__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!rIrsallr)rr#r!rr)r#r!rr$gs    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,rrrIr{)rr%r!r<filteredr}r#rrrrr&s",    zSpecifierSet.filter)r;N)NN)N)rrrrr)rr,rFr-r!r.rMrr*rr rr+r rrr0rrryr$rrr&rrrrrs( !   5r)#rr'r^rtypingrrrrrrrr r utilsr rr r)rrr,rrrrABCMetarr0rrrar`rerrrrr s,,     7  *