3
Pf\ @ sZ d Z ddlZddlZddlmZ ddddd d
d d gZejeZG d
d d e Z
G dd de Z G dd de Z
ejdZdd ZeZG dd de Zdd ZG dd de
Zejddfejdd fejd dfejd d fejd d!fejd"d!fejd#d$fejd%d&fejd'd(fejd)d*ff
Zejd+dfejd,dfejd-d$fejd#d$fejd.dffZejd/Zd0d1 Zd2d3 Zejd4ejZd5d5d6d5d7ddd8Z d9d: Z G d;d de Z G dd? Z!d@dA Z"G dBd d e Z#G dCd
d
e
Z$G dDdE dEe Z%e%eeee%e e dFdG e%e"e$edHZ&e&dI e&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 @ s e Zd ZdZdS )r
z This is an unsupported version.N)__name__
__module__ __qualname____doc__ r r /usr/lib/python3.6/version.pyr
s c @ sx e Zd Zdd Zdd Zdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dd Z dd Z
dd Zedd ZdS ) Versionc C s@ |j | _}| j| | _}t|ts,tt|dks=|<|>|!=|={2,3}|~=)?\s*([^\s,]+)$z
^\d+(\.\d+)*$c C s | |k S )Nr )vcpr r r W s zMatcher.c C s | |kS )Nr )r2 r3 r4 r r r r5 X s c C s | |kp| |k S )Nr )r2 r3 r4 r r r r5 Y s c C s | |kp| |kS )Nr )r2 r3 r4 r r r r5 Z s c C s | |kS )Nr )r2 r3 r4 r r r r5 [ s c C s | |kS )Nr )r2 r3 r4 r r r r5 \ s c C s | |kp| |kS )Nr )r2 r3 r4 r r r r5 ^ s c C s | |kS )Nr )r2 r3 r4 r r r r5 _ s )<>z<=z>=z==z===z~=z!=c
C sJ | j d krtd|j | _}| jj|}|sn s z$Matcher.__init__..,zInvalid %r in %rz~=r z.*==!=z#'.*' not allowed for %r constraintsTF)r= r> )
version_class
ValueErrorr r dist_rematchgroupsnamelowerkeysplitcomp_reendswithnum_reappendr r )
r r mrD ZclistZ constraintsr3 opZvnprefixr r r r b s:
zMatcher.__init__c C sz t |tr| j|}x`| jD ]V\}}}| jj|}t |trFt| |}|sbd|| jjf }t |||||s dS q W dS )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)
r r r@ r
_operatorsgetgetattrr, r r )r versionoperator
constraintrO fmsgr r r rC s
z
Matcher.matchc C s6 d }t | jdkr2| jd d dkr2| jd d }|S )Nr r =====)rX rY )r r )r resultr r r
exact_version s zMatcher.exact_versionc C s0 t | t |ks | j|jkr,td| |f d S )Nzcannot compare %s and %s)r rE r! )r r" r r r r# s zMatcher._check_compatiblec C s" | j | | j|jko | j|jkS )N)r# rG r )r r" r r r r$ s
zMatcher.__eq__c C s | j | S )N)r$ )r r" r r r r% s zMatcher.__ne__c C s t | jt | j S )N)r* rG r )r r r r r+ s zMatcher.__hash__c C s d| j j| jf S )Nz%s(%r))r, r r )r r r r r- s zMatcher.__repr__c C s | j S )N)r )r r r r r. s zMatcher.__str__)r r
r r@ recompilerB rI rK rP r rC r0 r[ r# r$ r% r+ r- r. r r r r r1 N s*
% r1 zk^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?(\.(post)(\d+))?(\.(dev)(\d+))?(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$c C s | j } tj| }|s"td| |j }tdd |d jdD }x(t|dkrn|d dkrn|d d }qHW |d s~d}n t|d }|dd }|d d
}|d d }|d
}|dkrf }n|d t|d f}|dkrf }n|d t|d f}|dkr
f }n|d t|d f}|d kr.f }nLg } x>|jdD ]0}
|
j rZdt|
f}
nd|
f}
| j
|
q>W t| }|s| r|rd}nd}|sd}|sd}||||||fS ) NzNot a valid version: %sc s s | ]}t |V qd S )N)int)r: r2 r r r s z _pep_440_key..r .r
az_finalrl )NN)NN)NNrl )rh rl )ri )rj )rk ) r PEP440_VERSION_RErC r
rD r rH r r^ isdigitrL ) r rM rD ZnumsZepochpreZpostdevZlocalr partr r r _pep_440_key sT
rr c @ s6 e Zd ZdZdd ZedddddgZed d
Zd S ) r aI A 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
c C s< t |}tj|}|j }tdd |d jdD | _|S )Nc s s | ]}t |V qd S )N)r^ )r: r2 r r r r_ s z*NormalizedVersion.parse..r r` )_normalized_keyrm rC rD r rH _release_clause)r r rZ rM rD r r r r s
zNormalizedVersion.parserh br3 rcrp c s t fdd jD S )Nc 3 s | ]}|r|d j kV qdS )r N) PREREL_TAGS)r: t)r r r r_ s z2NormalizedVersion.is_prerelease..)anyr )r r )r r r/ s z NormalizedVersion.is_prereleaseN) r r
r r r setrw r0 r/ r r r r r s c C s> t | } t |}| |kr dS | j|s*dS t|}| | dkS )NTFr` )str
startswithr )xynr r r
_match_prefix" s
r c @ sn e Zd ZeZddddddddd Zd
d Zd d
Zdd Zdd Z dd Z
dd Z dd Z dd Z
dd Zd S ) r _match_compatible _match_lt _match_gt _match_le _match_ge _match_eq_match_arbitrary _match_ne)z~=r6 r7 z<=z>=z==z===z!=c C sV |rd|ko|j d }n|j d o,|j d }|rN|jjddd }| j|}||fS )N+r r rl rl rl )r r rH r@ )r rS rU rO Z strip_localr r r r
_adjust_local< s
z NormalizedMatcher._adjust_localc C sD | j |||\}}||kr dS |j}djdd |D }t|| S )NFr` c S s g | ] }t |qS r )r{ )r: ir r r r; O s z/NormalizedMatcher._match_lt..)r rt joinr )r rS rU rO release_clausepfxr r r r J s zNormalizedMatcher._match_ltc C sD | j |||\}}||kr dS |j}djdd |D }t|| S )NFr` c S s g | ] }t |qS r )r{ )r: r r r r r; W s z/NormalizedMatcher._match_gt..)r rt r r )r rS rU rO r r r r r r R s zNormalizedMatcher._match_gtc C s | j |||\}}||kS )N)r )r rS rU rO r r r r Z s zNormalizedMatcher._match_lec C s | j |||\}}||kS )N)r )r rS rU rO r r r r ^ s zNormalizedMatcher._match_gec C s. | j |||\}}|s ||k}n
t||}|S )N)r r )r rS rU rO rZ r r r r b s
zNormalizedMatcher._match_eqc C s t |t |kS )N)r{ )r rS rU rO r r r r j s z"NormalizedMatcher._match_arbitraryc C s0 | j |||\}}|s ||k}n t|| }|S )N)r r )r rS rU rO rZ r r r r m s
zNormalizedMatcher._match_nec C sf | j |||\}}||kr dS ||k r*dS |j}t|dkrH|d d }djdd |D }t||S )NTFr r` c S s g | ] }t |qS r )r{ )r: r r r r r; s z7NormalizedMatcher._match_compatible..rl )r rt r r r )r rS rU rO r r r r r r u s z#NormalizedMatcher._match_compatibleN)r r
r r r@ rP r r r r r r r r r r r r r r - s$ z[.+-]$r8 z^[.](\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+)*)c C sZ | j j }x tD ]\}}|j||}qW |s2d}tj|}|sJd}|}n|j d jd}dd |D }xt|dk r|j d qlW t|dkr||j
d }n8dj dd |dd D ||j
d }|dd }dj d d |D }|j }|r x t D ]\}}|j||}qW |s*|}n d
|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.0r r` c S s g | ] }t |qS r )r^ )r: r r r r r; s z-_suggest_semantic_version.. Nc S s g | ] }t |qS r )r{ )r: r r r r r; s c S s g | ] }t |qS r )r{ )r: r r r r r; s rp -r )r rF
_REPLACEMENTSsub_NUMERIC_PREFIXrC rD rH r rL endr _SUFFIX_REPLACEMENTS is_semver)r rZ ZpatreplrM rO suffixsepr r r _suggest_semantic_version s:
,
r c C sl y t | | S tk
r Y nX | j }x dBD ]\}}|j||}q0W tjdd|}tjdd|}tjdd|}tjdd |}tjd d |}|jd r|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 | W n tk
rf d!}Y nX |S )Ca Suggest 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.
-alpharh -betaru r r rv r3 -finalr8 -pre-release.release-stabler r` rj .finalrk zpre$Zpre0zdev$Zdev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?z\1r2 r Nz\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\1r rh r ru r rh r ru rv r3 r r8 r r3 r r8 r r8 r r8 r r` rj r` r r8 r r8 rk r8 )r r r r r r r r r r r r r r r )rs r
rF replacer\ r r| )r ZrsZorigr r r r _suggest_normalized_version sH
r z([a-z]+|\d+|[\.-])r3 zfinal-@)ro Zpreviewr rv rp r8 r` c C s~ dd }g }xh|| D ]\}|j drh|dk rJx |rH|d dkrH|j q.W x |rf|d dkrf|j qLW |j| qW t|S )
Nc S sx g }xdt j| j D ]R}tj||}|rd|d d koBdkn rT|jd}nd| }|j| qW |jd |S )N0r 9 *z*final)
_VERSION_PARTrH rF _VERSION_REPLACErQ zfillrL )r rZ r4 r r r get_partsI s
z _legacy_key..get_partsr z*finalr z*final-Z00000000rl rl )r| poprL r )r r rZ r4 r r r _legacy_keyH s
r c @ s e Zd Zdd Zedd ZdS )r c C s t |S )N)r )r r r r r r c s zLegacyVersion.parsec C s: d}x0| j D ]&}t|tr |jdr |dk r d}P q W |S )NFr z*finalT)r r r r| )r rZ r} r r r r/ f s zLegacyVersion.is_prereleaseN)r r
r r r0 r/ r r r r r b s c @ s4 e Zd ZeZeejZded< ej dZ
dd Z dS )r r z~=z^(\d+(\.\d+)*)c C s` ||k r dS | j jt|}|s2tjd|| dS |j d }d|krV|jddd }t||S )NFzACannot compute compatible match for version %s and constraint %sTr r` r )
numeric_rerC r{ loggerZwarningrD rsplitr )r rS rU rO rM r r r r r y s z LegacyMatcher._match_compatibleN) r r
r r r@ dictr1 rP r\ r] r r r r r r r q s
zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$c C s
t j| S )N)
_SEMVER_RErC )r r r r r s r c C sn dd }t | }|s t| |j }dd |d d D \}}}||d d||d d }}|||f||fS ) Nc S s8 | d kr|f}n$| dd j d}tdd |D }|S )Nr r` c S s" g | ]}|j r|jd n|qS )r )rn r )r: r4 r r r r; s z5_semantic_key..make_tuple..)rH r )r ZabsentrZ r r r r
make_tuple s
z!_semantic_key..make_tuplec S s g | ] }t |qS r )r^ )r: r r r r r; s z!_semantic_key..r | r )r r
rD ) r r rM rD majorminorZpatchro Zbuildr r r
_semantic_key s
r c @ s e Zd Zdd Zedd ZdS )r c C s t |S )N)r )r r r r r r s zSemanticVersion.parsec C s | j d d dkS )Nr r r )r )r r r r r/ s z SemanticVersion.is_prereleaseN)r r
r r r0 r/ r r r r r s c @ s e Zd ZeZdS )r N)r r
r r r@ r r r r r s c @ s6 e Zd Zd ddZdd Zdd Zdd Zd
d ZdS )
VersionSchemeNc C s || _ || _|| _d S )N)rG matcher suggester)r rG r r r r r r s zVersionScheme.__init__c C s2 y| j j| d}W n tk
r, d}Y nX |S )NTF)r r@ r
)r r rZ r r r is_valid_version s
z VersionScheme.is_valid_versionc C s0 y| j | d}W n tk
r* d}Y nX |S )NTF)r r
)r r rZ r r r is_valid_matcher s
z VersionScheme.is_valid_matcherc C s | j d| S )z:
Used for processing some metadata fields
zdummy_name (%s))r )r r r r r is_valid_constraint_list s z&VersionScheme.is_valid_constraint_listc C s | j d krd }n
| j |}|S )N)r )r r rZ r r r suggest s
zVersionScheme.suggest)N)r r
r r r r r r r r r r r s
r c C s |S )Nr )r r r r r r5 s r5 )
normalizedlegacyZsemanticr defaultc C s | t krtd| t | S )Nzunknown scheme name: %r)_SCHEMESrA )rE r r r r s )(r Zloggingr\ compatr __all__Z getLoggerr r rA r
objectr r1 r] rm rr rs r r r r r r r r Ir r r r r r r r r r r r r r r r r sz
1k
=$ W
.r $