3 Pf\ @sZdZddlZddlZddlmZddddd d d d gZejeZGd d d e Z Gddde Z Gddde Z ejdZddZeZGddde ZddZGddde Zejddfejddfejddfejddfejd d!fejd"d!fejd#d$fejd%d&fejd'd(fejd)d*ff Zejd+dfejd,dfejd-d$fejd#d$fejd.dffZejd/Zd0d1Zd2d3Zejd4ejZd5d5d6d5d7ddd8Zd9d:ZGd;dde ZGdd?Z!d@dAZ"GdBd d e Z#GdCd d e Z$GdDdEdEe Z%e%eeee%eedFdGe%e"e$edHZ&e&dIe&dJ<dKd Z'dS)Lz~ Implementation of a flexible versioning scheme providing support for PEP-440, setuptools-compatible and semantic versioning. N) string_typesNormalizedVersionNormalizedMatcher LegacyVersion LegacyMatcherSemanticVersionSemanticMatcherUnsupportedVersionError get_schemec@seZdZdZdS)r zThis is an unsupported version.N)__name__ __module__ __qualname____doc__rr/usr/lib/python3.6/version.pyr sc@sxeZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZeddZdS)VersioncCs"|j|_}|j||_}dS)N)strip_stringparse_parts)selfspartsrrr__init__szVersion.__init__cCs tddS)Nzplease implement in a subclass)NotImplementedError)rrrrrr$sz Version.parsecCs$t|t|kr td||fdS)Nzcannot compare %r and %r)type TypeError)rotherrrr_check_compatible'szVersion._check_compatiblecCs|j||j|jkS)N)rr)rrrrr__eq__+s zVersion.__eq__cCs |j| S)N)r )rrrrr__ne__/szVersion.__ne__cCs|j||j|jkS)N)rr)rrrrr__lt__2s zVersion.__lt__cCs|j|p|j| S)N)r"r )rrrrr__gt__6szVersion.__gt__cCs|j|p|j|S)N)r"r )rrrrr__le__9szVersion.__le__cCs|j|p|j|S)N)r#r )rrrrr__ge__<szVersion.__ge__cCs t|jS)N)hashr)rrrr__hash__@szVersion.__hash__cCsd|jj|jfS)Nz%s('%s')) __class__r r)rrrr__repr__CszVersion.__repr__cCs|jS)N)r)rrrr__str__FszVersion.__str__cCs tddS)NzPlease implement in subclasses.)r)rrrr is_prereleaseIszVersion.is_prereleaseN)r r rrrrr r!r"r#r$r%r'r)r*propertyr+rrrrrsrc @seZdZdZejdZejdZejdZddddddd dd dd dd dd ddZ ddZ ddZ e ddZ ddZddZddZddZddZdd ZdS)!MatcherNz^(\w[\s\w'.-]*)(\((.*)\))?z'^(<=|>=|<|>|!=|={2,3}|~=)?\s*([^\s,]+)$z ^\d+(\.\d+)*$cCs||kS)Nr)vcprrrWszMatcher.cCs||kS)Nr)r.r/r0rrrr1XscCs||kp||kS)Nr)r.r/r0rrrr1YscCs||kp||kS)Nr)r.r/r0rrrr1ZscCs||kS)Nr)r.r/r0rrrr1[scCs||kS)Nr)r.r/r0rrrr1\scCs||kp||kS)Nr)r.r/r0rrrr1^scCs||kS)Nr)r.r/r0rrrr1_s)<>z<=z>=z==z===z~=z!=c CsJ|jdkrtd|j|_}|jj|}|snsz$Matcher.__init__..,zInvalid %r in %rz~=rz.*==!=z#'.*' not allowed for %r constraintsTF)r9r:) version_class ValueErrorrrdist_rematchgroupsnamelowerkeysplitcomp_reendswithnum_reappendtupler) rrmr@ZclistZ constraintsr/opZvnprefixrrrrbs:           zMatcher.__init__cCszt|tr|j|}x`|jD]V\}}}|jj|}t|trFt||}|sbd||jjf}t |||||sdSqWdS)z Check if the provided version matches the constraints. :param version: The version to match against this instance. :type version: String or :class:`Version` instance. z%r not implemented for %sFT) isinstancerr<r _operatorsgetgetattrr(r r)rversionoperator constraintrLfmsgrrrr?s      z Matcher.matchcCs6d}t|jdkr2|jdddkr2|jdd}|S)Nrr=====)rVrW)lenr)rresultrrr exact_versions zMatcher.exact_versioncCs0t|t|ks|j|jkr,td||fdS)Nzcannot compare %s and %s)rrAr)rrrrrrszMatcher._check_compatiblecCs"|j||j|jko |j|jkS)N)rrCr)rrrrrr s zMatcher.__eq__cCs |j| S)N)r )rrrrrr!szMatcher.__ne__cCst|jt|jS)N)r&rCr)rrrrr'szMatcher.__hash__cCsd|jj|jfS)Nz%s(%r))r(r r)rrrrr)szMatcher.__repr__cCs|jS)N)r)rrrrr*szMatcher.__str__)r r rr<recompiler>rErGrNrr?r,rZrr r!r'r)r*rrrrr-Ns*    % r-zk^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?(\.(post)(\d+))?(\.(dev)(\d+))?(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$c Cs|j}tj|}|s"td||j}tdd|djdD}x(t|dkrn|ddkrn|dd}qHW|ds~d}n t|d}|dd}|d d }|d d }|d }|dkrf}n|dt|df}|dkrf}n|dt|df}|dkr f}n|dt|df}|dkr.f}nLg} x>|jdD]0} | j rZdt| f} nd| f} | j | q>Wt| }|s| r|rd}nd}|sd}|sd}||||||fS)NzNot a valid version: %scss|]}t|VqdS)N)int)r6r.rrr sz_pep_440_key..r.r az_finalrk)NN)NN)NNrk)rgrk)rh)ri)rj) rPEP440_VERSION_REr?r r@rIrDrXr]isdigitrH) rrJr@ZnumsZepochpreZpostdevZlocalrpartrrr _pep_440_keysT         rqc@s6eZdZdZddZedddddgZed d Zd S) raIA rational version. Good: 1.2 # equivalent to "1.2.0" 1.2.0 1.2a1 1.2.3a2 1.2.3b1 1.2.3c1 1.2.3.4 TODO: fill this out Bad: 1 # minimum two numbers 1.2a # release level must have a release serial 1.2.3b cCs<t|}tj|}|j}tdd|djdD|_|S)Ncss|]}t|VqdS)N)r])r6r.rrrr^sz*NormalizedVersion.parse..rr_)_normalized_keyrlr?r@rIrD_release_clause)rrrYrJr@rrrrs  zNormalizedVersion.parsergbr/rcrocstfddjDS)Nc3s |]}|r|djkVqdS)rN) PREREL_TAGS)r6t)rrrr^sz2NormalizedVersion.is_prerelease..)anyr)rr)rrr+szNormalizedVersion.is_prereleaseN) r r rrrsetrvr,r+rrrrrs cCs>t|}t|}||krdS|j|s*dSt|}||dkS)NTFr_)str startswithrX)xynrrr _match_prefix"s rc @sneZdZeZddddddddd Zd d Zd d ZddZddZ ddZ ddZ ddZ ddZ ddZdS)r_match_compatible _match_lt _match_gt _match_le _match_ge _match_eq_match_arbitrary _match_ne)z~=r2r3z<=z>=z==z===z!=cCsV|rd|ko|jd}n|jd o,|jd}|rN|jjddd}|j|}||fS)N+rrrkrkrk)rrrDr<)rrQrSrLZ strip_localrrrr _adjust_local<s zNormalizedMatcher._adjust_localcCsD|j|||\}}||krdS|j}djdd|D}t|| S)NFr_cSsg|] }t|qSr)rz)r6irrrr7Osz/NormalizedMatcher._match_lt..)rrsjoinr)rrQrSrLrelease_clausepfxrrrrJs zNormalizedMatcher._match_ltcCsD|j|||\}}||krdS|j}djdd|D}t|| S)NFr_cSsg|] }t|qSr)rz)r6rrrrr7Wsz/NormalizedMatcher._match_gt..)rrsrr)rrQrSrLrrrrrrRs zNormalizedMatcher._match_gtcCs|j|||\}}||kS)N)r)rrQrSrLrrrrZszNormalizedMatcher._match_lecCs|j|||\}}||kS)N)r)rrQrSrLrrrr^szNormalizedMatcher._match_gecCs.|j|||\}}|s ||k}n t||}|S)N)rr)rrQrSrLrYrrrrbs   zNormalizedMatcher._match_eqcCst|t|kS)N)rz)rrQrSrLrrrrjsz"NormalizedMatcher._match_arbitrarycCs0|j|||\}}|s ||k}n t|| }|S)N)rr)rrQrSrLrYrrrrms   zNormalizedMatcher._match_necCsf|j|||\}}||krdS||kr*dS|j}t|dkrH|dd}djdd|D}t||S)NTFrr_cSsg|] }t|qSr)rz)r6rrrrr7sz7NormalizedMatcher._match_compatible..rk)rrsrXrr)rrQrSrLrrrrrrus  z#NormalizedMatcher._match_compatibleN)r r rrr<rNrrrrrrrrrrrrrr-s$z[.+-]$r4z^[.](\d)z0.\1z^[.-]z ^\((.*)\)$z\1z^v(ersion)?\s*(\d+)z\2z^r(ev)?\s*(\d+)z[.]{2,}r_z\b(alfa|apha)\balphaz\b(pre-alpha|prealpha)\bz pre.alphaz \(beta\)$betaz ^[:~._+-]+z [,*")([\]]z[~:+_ -]z\.$z (\d+(\.\d+)*)cCsZ|jj}xtD]\}}|j||}qW|s2d}tj|}|sJd}|}n|jdjd}dd|D}xt|dkr|j dqlWt|dkr||j d}n8dj dd|ddD||j d}|dd}dj d d|D}|j}|rxt D]\}}|j||}qW|s*|}nd |kr8d nd }|||}t |sVd}|S) z Try to suggest a semantic form for a version for which _suggest_normalized_version couldn't come up with anything. z0.0.0rr_cSsg|] }t|qSr)r])r6rrrrr7sz-_suggest_semantic_version..NcSsg|] }t|qSr)rz)r6rrrrr7scSsg|] }t|qSr)rz)r6rrrrr7sro-r)rrB _REPLACEMENTSsub_NUMERIC_PREFIXr?r@rDrXrHendr_SUFFIX_REPLACEMENTS is_semver)rrYZpatreplrJrLsuffixseprrr_suggest_semantic_versions:   ,   rcCsly t||Stk r YnX|j}xdBD]\}}|j||}q0Wtjdd|}tjdd|}tjdd|}tjdd|}tjdd|}|jdr|d d!}tjd"d|}tjd#d$|}tjd%d&|}tjd'd|}tjd(d)|}tjd*d)|}tjd+d |}tjd,d-|}tjd.d&|}tjd/d0|}tjd1d2|}y t|Wntk rfd!}YnX|S)CaSuggest a normalized version close to the given version string. If you have a version string that isn't rational (i.e. NormalizedVersion doesn't like it) then you might be able to get an equivalent (or close) rational version from this function. This does a number of simple normalizations to the given string, based on observation of versions currently in use on PyPI. Given a dump of those version during PyCon 2009, 4287 of them: - 2312 (53.93%) match NormalizedVersion without change with the automatic suggestion - 3474 (81.04%) match when using this suggestion method @param s {str} An irrational version string. @returns A rational version string, or None, if couldn't determine one. -alpharg-betartrrrur/-finalr4-pre-release.release-stablerr_ri .finalrjzpre$Zpre0zdev$Zdev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?z\1r.rNz\b0+(\d+)(?!\d)z (\d+[abc])$z\g<1>0z\.?(dev-r|dev\.r)\.?(\d+)$z.dev\2z-(a|b|c)(\d+)$z[\.\-](dev|devel)$z.dev0z(?![\.\-])dev$z(final|stable)$z\.?(r|-|-r)\.?(\d+)$z.post\2z\.?(dev|git|bzr)\.?(\d+)$z\.?(pre|preview|-c)(\d+)$zc\g<2>zp(\d+)$z.post\1rrgrrtrrgrrtrur/rr4rr/rr4rr4rr4rr_rir_rr4rr4rjr4)rrrrrrrrrrrrrrr)rrr rBreplacer[rr{)rZrsZorigrrrr_suggest_normalized_versionsH      rz([a-z]+|\d+|[\.-])r/zfinal-@)rnZpreviewrruror4r_cCs~dd}g}xh||D]\}|jdrh|dkrJx|rH|ddkrH|jq.Wx|rf|d dkrf|jqLW|j|qWt|S) NcSsxg}xdtj|jD]R}tj||}|rd|ddkoBdknrT|jd}nd|}|j|qW|jd|S)N0r9*z*final) _VERSION_PARTrDrB_VERSION_REPLACErOzfillrH)rrYr0rrr get_partsIs    z_legacy_key..get_partsrz*finalrz*final-Z00000000rkrk)r{poprHrI)rrrYr0rrr _legacy_keyHs    rc@s eZdZddZeddZdS)rcCst|S)N)r)rrrrrrcszLegacyVersion.parsecCs:d}x0|jD]&}t|tr |jdr |dkr d}Pq W|S)NFrz*finalT)rrMrr{)rrYr|rrrr+fs zLegacyVersion.is_prereleaseN)r r rrr,r+rrrrrbsc@s4eZdZeZeejZded<ej dZ ddZ dS)rrz~=z^(\d+(\.\d+)*)cCs`||kr dS|jjt|}|s2tjd||dS|jd}d|krV|jddd}t||S)NFzACannot compute compatible match for version %s and constraint %sTrr_r) numeric_rer?rzloggerZwarningr@rsplitr)rrQrSrLrJrrrrrys zLegacyMatcher._match_compatibleN) r r rrr<dictr-rNr[r\rrrrrrrqs   zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$cCs tj|S)N) _SEMVER_REr?)rrrrrsrc Csndd}t|}|st||j}dd|ddD\}}}||dd||dd}}|||f||fS) NcSs8|dkr|f}n$|ddjd}tdd|D}|S)Nrr_cSs"g|]}|jr|jdn|qS)r)rmr)r6r0rrrr7sz5_semantic_key..make_tuple..)rDrI)rZabsentrYrrrr make_tuples z!_semantic_key..make_tuplecSsg|] }t|qSr)r])r6rrrrr7sz!_semantic_key..r|r)rr r@) rrrJr@majorminorZpatchrnZbuildrrr _semantic_keys rc@s eZdZddZeddZdS)rcCst|S)N)r)rrrrrrszSemanticVersion.parsecCs|jdddkS)Nrrr)r)rrrrr+szSemanticVersion.is_prereleaseN)r r rrr,r+rrrrrsc@seZdZeZdS)r N)r r rrr<rrrrr sc@s6eZdZd ddZddZddZdd Zd d ZdS) VersionSchemeNcCs||_||_||_dS)N)rCmatcher suggester)rrCrrrrrrszVersionScheme.__init__c Cs2y|jj|d}Wntk r,d}YnX|S)NTF)rr<r )rrrYrrris_valid_versions   zVersionScheme.is_valid_versionc Cs0y|j|d}Wntk r*d}YnX|S)NTF)rr )rrrYrrris_valid_matchers   zVersionScheme.is_valid_matchercCs|jd|S)z: Used for processing some metadata fields zdummy_name (%s))r)rrrrris_valid_constraint_listsz&VersionScheme.is_valid_constraint_listcCs|jdkrd}n |j|}|S)N)r)rrrYrrrsuggests  zVersionScheme.suggest)N)r r rrrrrrrrrrrs  rcCs|S)Nr)rrrrrr1sr1) normalizedlegacyZsemanticrdefaultcCs|tkrtd|t|S)Nzunknown scheme name: %r)_SCHEMESr=)rArrrr s )(rZloggingr[compatr__all__Z getLoggerr rr=r objectrr-r\rlrqrrrrrrrrrrIrrrrrrrrrr rrr rrrr sz  1k =$ W             .r $