B
9 @ sf d Z ddlZddlZddlmZ ddlmZ dddd d
d d d
gZee Z
G dd d e Z G dd de
ZG dd de
ZedZdd ZeZG dd deZdd ZG dd deZeddfed d fed dfed d fed!d"fed#d"fed$d%fed&d'fed(d)fed*d+ff
Zed,dfed-dfed.d%fed$d%fed/dffZed0Zd1d2 Zd3d4 Zed5ej Z d6d6d7d6d8ddd9Z d:d; Z G dej Z"d?d@ Z#dAdB Z$G dCd
d
eZ%G dDd d eZ&G dEdF dFe
Z'e'eeee'e e!dGdH e'e$e&edIZ(e(dJ e(dK< dLd
Z)dS )Mz~
Implementation of a flexible versioning scheme providing support for PEP-440,
setuptools-compatible and semantic versioning.
N ) string_types)parse_requirementNormalizedVersionNormalizedMatcher
LegacyVersion
LegacyMatcherSemanticVersionSemanticMatcherUnsupportedVersionError
get_schemec @ s e Zd ZdZdS )r z This is an unsupported version.N)__name__
__module__ __qualname____doc__ r r @/opt/alt/python37/lib/python3.7/site-packages/distlib/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@ | | _}| | | _}t|ts,tt|dksT zMatcher.c C s | |kS )Nr )r3 r4 r5 r r r r6 U r7 c C s | |kp| |k S )Nr )r3 r4 r5 r r r r6 V r7 c C s | |kp| |kS )Nr )r3 r4 r5 r r r r6 W r7 c C s | |kS )Nr )r3 r4 r5 r r r r6 X r7 c C s | |kS )Nr )r3 r4 r5 r r r r6 Y r7 c C s | |kp| |kS )Nr )r3 r4 r5 r r r r6 [ r7 c C s | |kS )Nr )r3 r4 r5 r r r r6 \ r7 )<>z<=z>=z==z===z~=z!=c C s t |S )N)r )r r r r r r a s zMatcher.parse_requirementc C s | j d krtd| | _}| |}|s:td| |j| _| j | _g }|jrxn|jD ]d\}}| dr|dkrtd| |d d d }}| | n| |d }}|
|||f q`W t || _ d S ) Nz Please specify a version classz
Not valid: %rz.*)z==z!=z#'.*' not allowed for %r constraintsTF)
version_class
ValueErrorr r r namelowerkeyZ constraintsendswithappendr r )r r rZclistopZvnprefixr r r r d s(
zMatcher.__init__c C sz t |tr| |}x`| jD ]V\}}}| j|}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
constraintrD fmsgr r r match s
z
Matcher.matchc C s6 d }t | jdkr2| jd d dkr2| jd d }|S )Nr r )z==z===)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! r= r" )r r# r r r r$ s zMatcher._check_compatiblec C s" | | | j|jko | j|jkS )N)r$ r? r )r r# r r r r% s
zMatcher.__eq__c C s | | S )N)r% )r r# r r r r& s zMatcher.__ne__c C s t | jt | j S )N)r+ r? 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; rE r r rM r1 rO r$ r% r& r, r. r/ r r r r r2 O s& r2 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 | } t| }|s"td| | }tdd |d dD }x(t|dkrn|d dkrn|d d }qHW |d s~d}nt|d d d }|dd }|d
d }|d d
}|d }|dkrd}n|d t|d f}|dkrd}n|d t|d f}|dkrd}n|d t|d f}|d kr6d}nLg } x>|dD ]0}
|
rbdt|
f}
nd|
f}
|
|
qFW t| }|s|s|rd}nd}|sd}|sd}||||||fS )NzNot a valid version: %sc s s | ]}t |V qd S )N)int).0r3 r r r s z _pep_440_key..r .r
)NNr )arT )z)_)final) r PEP440_VERSION_RErM r groupsr splitr rP isdigitrA ) r mra ZnumsZepochpreZpostdevlocalr partr r r _pep_440_key sT
ri 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 |}t|}| }tdd |d dD | _|S )Nc s s | ]}t |V qd S )N)rP )rQ r3 r r r rR s z*NormalizedVersion.parse..r rS )_normalized_keyr` rM ra r rb _release_clause)r r rN rd ra r r r r
s
zNormalizedVersion.parser\ br4 rcrf c s t fdd jD S )Nc 3 s | ]}|r|d j kV qdS )r N) PREREL_TAGS)rQ t)r r r rR s z2NormalizedVersion.is_prerelease..)anyr )r r )r r r0 s z NormalizedVersion.is_prereleaseN) r
r r r r setrn r1 r0 r r r r r s c C s> t | } t |}| |kr dS | |s*dS t|}| | dkS )NTFrS )str
startswithr )xynr r r
_match_prefix s
rw 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~=r8 r9 z<=z>=z==z===z!=c C sV |rd|ko|j d }n|j d o,|j d }|rN|jddd }| |}||fS )N+rT r r )r r rb r; )r rH rJ rD Z strip_localr r r r
_adjust_local6 s
z NormalizedMatcher._adjust_localc C sD | |||\}}||kr dS |j}ddd |D }t|| S )NFrS c S s g | ] }t |qS r )rr )rQ ir r r
I s z/NormalizedMatcher._match_lt..)r rk joinrw )r rH rJ rD release_clausepfxr r r ry D s zNormalizedMatcher._match_ltc C sD | |||\}}||kr dS |j}ddd |D }t|| S )NFrS c S s g | ] }t |qS r )rr )rQ r r r r r Q s z/NormalizedMatcher._match_gt..)r rk r rw )r rH rJ rD r r r r r rz L s zNormalizedMatcher._match_gtc C s | |||\}}||kS )N)r )r rH rJ rD r r r r{ T s zNormalizedMatcher._match_lec C s | |||\}}||kS )N)r )r rH rJ rD r r r r| X s zNormalizedMatcher._match_gec C s. | |||\}}|s ||k}n
t||}|S )N)r rw )r rH rJ rD rN r r r r} \ s
zNormalizedMatcher._match_eqc C s t |t |kS )N)rr )r rH rJ rD r r r r~ d s z"NormalizedMatcher._match_arbitraryc C s0 | |||\}}|s ||k}n t|| }|S )N)r rw )r rH rJ rD rN r r r r g s
zNormalizedMatcher._match_nec C sf | |||\}}||kr dS ||k r*dS |j}t|dkrH|d d }ddd |D }t||S )NTFr rT rS c S s g | ] }t |qS r )rr )rQ r r r r r z s z7NormalizedMatcher._match_compatible..)r rk r r rw )r rH rJ rD r r r r r rx o s z#NormalizedMatcher._match_compatibleN)r
r r r r; rE r ry rz r{ r| r} r~ r rx r r r r r ' s$ z[.+-]$ z^[.](\d)z0.\1z^[.-]z
^\((.*)\)$z\1z^v(ersion)?\s*(\d+)z\2z^r(ev)?\s*(\d+)z[.]{2,}rS z\b(alfa|apha)\balphaz\b(pre-alpha|prealpha)\bz pre.alphaz \(beta\)$betaz
^[:~._+-]+z
[,*")([\]]z[~:+_ -]z\.$z
(\d+(\.\d+)*)c C sZ | }x tD ]\}}|||}qW |s2d}t|}|sJd}|}n| d d}dd |D }xt|dk r| d qlW t|dkr||
d }n8d dd |dd D ||
d }|dd }d d d |D }| }|r x t D ]\}}|||}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 rS c S s g | ] }t |qS r )rP )rQ r r r r r s z-_suggest_semantic_version.. Nc S s g | ] }t |qS r )rr )rQ r r r r r s c S s g | ] }t |qS r )rr )rQ r r r r r s rf -r )r r>
_REPLACEMENTSsub_NUMERIC_PREFIXrM ra rb r rA endr _SUFFIX_REPLACEMENTS is_semver)r rN patreplrd rD suffixsepr r r _suggest_semantic_version s:
,
r c C sj y t | | S tk
r Y nX | }x dD ]\}}|||}q0W tdd|}tdd|}tdd|}tdd |}td
d |}|d r|d
d }tdd |}tdd|}tdd|}tdd|}tdd|}tdd|}tdd|}tdd|}td d|}td d |}td d |}y t | W n tk
rd d}Y nX |S )!a 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.
))z-alphar\ )z-betarl )r r\ )r rl )rm r4 )z-finalr )z-prer4 )z-releaser )z.releaser )z-stabler )r rS )r^ rS ) r )z.finalr )r_ r zpre$Zpre0zdev$Zdev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?z\1r3 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)$r z\.?(r|-|-r)\.?(\d+)$z.post\2z\.?(dev|git|bzr)\.?(\d+)$z\.?(pre|preview|-c)(\d+)$zc\g<2>zp(\d+)$z.post\1)rj r r> replacerer rs )r ZrsZorigr r r r _suggest_normalized_version s>
r z([a-z]+|\d+|[\.-])r4 zfinal-@)re Zpreviewr rm rf r rS c C s~ dd }g }xh|| D ]\}| drh|dk rJx |rH|d dkrH| q.W x |rf|d dkrf| qLW || qW t|S )Nc S sx g }xdt | D ]R}t||}|rd|d d krDdkrTn n |d}nd| }|| qW |d |S )N0r 9 *z*final)
_VERSION_PARTrb r> _VERSION_REPLACErF zfillrA )r rN r5 r r r get_partsC s
z _legacy_key..get_partsr z*finalrT z*final-Z00000000)rs poprA r )r r rN r5 r r r _legacy_keyB s
r c @ s e Zd Zdd Zedd ZdS )r c C s t |S )N)r )r r r r r r ] s zLegacyVersion.parsec C s: d}x0| j D ]&}t|tr |dr |dk r d}P q W |S )NFr z*finalT)r r r rs )r rN rt r r r r0 ` s zLegacyVersion.is_prereleaseN)r
r r r r1 r0 r r r r r \ s c @ s4 e Zd ZeZeejZded< e dZ
dd Z dS )r rx z~=z^(\d+(\.\d+)*)c C s` ||k r dS | j t|}|s2td|| dS | d }d|krV|ddd }t||S )NFzACannot compute compatible match for version %s and constraint %sTr rS r )
numeric_rerM rr loggerwarningra rsplitrw )r rH rJ rD rd r r r r rx s s z LegacyMatcher._match_compatibleN) r
r r r r; dictr2 rE r compiler rx r r r r r k s
zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$c C s
t | S )N)
_SEMVER_RErM )r r r r r s r c C sn dd }t | }|s t| | }dd |d d D \}}}||d d||d d }}|||f||fS ) Nc S s8 | d kr|f}n$| dd d}tdd |D }|S )Nr rS c S s" g | ]}| r|d n|qS )r )rc r )rQ r5 r r r r s z5_semantic_key..make_tuple..)rb r )r ZabsentrN r r r r
make_tuple s
z!_semantic_key..make_tuplec S s g | ] }t |qS r )rP )rQ r r r r r s z!_semantic_key..r | r )r r ra ) r r rd ra majorminorZpatchre buildr 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 r0 s z SemanticVersion.is_prereleaseN)r
r r r r1 r0 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)r? matcher suggester)r r? r r r r r r s zVersionScheme.__init__c C s2 y| j | d}W n tk
r, d}Y nX |S )NTF)r r; r )r r rN r r r is_valid_version s
z VersionScheme.is_valid_versionc C s0 y| | d}W n tk
r* d}Y nX |S )NTF)r r )r r rN r r r is_valid_matcher s
z VersionScheme.is_valid_matcherc C s$ | dr|dd }| d| S )z:
Used for processing some metadata fields
,NrT zdummy_name (%s))r@ r )r r r r r is_valid_constraint_list s
z&VersionScheme.is_valid_constraint_listc C s | j d krd }n
| |}|S )N)r )r r rN 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 r6 r7 r6 )
normalizedZlegacyZsemanticr defaultc C s | t krtd| t | S )Nzunknown scheme name: %r)_SCHEMESr< )r= r r r r s )*r loggingr compatr utilr __all__ getLoggerr
r r< r objectr r2 r r` ri rj r rw r r r r r r Ir r r r r r r r r r
r r r r r r r s|
1d
=$ W
.r '