HEX

File: //opt/alt/python38/lib/python3.8/site-packages/pbr/__pycache__/version.cpython-38.pyc
U

�V�H�@sPdZddlZddlZddlZddlZdd�ZGdd�de�ZGdd�de�ZdS)	z9
Utilities for consuming the version from pkg_resources.
�NcCs*zt|�WdStk
r$YdSXdS)NTF)�int�
ValueError)�string�r�</opt/alt/python38/lib/python3.8/site-packages/pbr/version.py�_is_ints
rc@s�eZdZdZd.dd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
edd��Zdd�Zdd�Zdd�Zd/d!d"�Zd0d$d%�Zd&d'�Zd(d)�Zd*d+�Zd,d-�ZdS)1�SemanticVersionzvA pure semantic version independent of serialisation.

    See the pbr doc 'semver' for details on the semantics.
    rNcCs>||_||_||_||_||_|jr0|js0d|_|p6d|_dS)a
Create a SemanticVersion.

        :param major: Major component of the version.
        :param minor: Minor component of the version. Defaults to 0.
        :param patch: Patch level component. Defaults to 0.
        :param prerelease_type: What sort of prerelease version this is -
            one of a(alpha), b(beta) or rc(release candidate).
        :param prerelease: For prerelease versions, what number prerelease.
            Defaults to 0.
        :param dev_count: How many commits since the last release.
        rN)�_major�_minor�_patch�_prerelease_type�_prerelease�
_dev_count)�self�major�minor�patch�prerelease_type�
prerelease�	dev_countrrr�__init__*szSemanticVersion.__init__cCst|t�sdS|j|jkS)NF)�
isinstancer�__dict__�r�otherrrr�__eq__As
zSemanticVersion.__eq__cCsttt|j����S�N)�sum�map�hashr�values�rrrr�__hash__FszSemanticVersion.__hash__cCsLddddd�}|jr |js d}nd}|j|j|j|||j|j|jpHtjfS)z.Return a key for sorting SemanticVersion's on.�a�b�rc�z)r#r$r%Nr�)rrr	r
rr
�sys�maxsize)r�	rc_lookup�uq_devrrr�	_sort_keyIs
�zSemanticVersion._sort_keycCs"t|t�std��|��|��kS)z1Compare self and other, another Semantic Version.z,ordering to non-SemanticVersion is undefined)rr�	TypeErrorr,rrrr�__lt__`s
zSemanticVersion.__lt__cCs||kp||kSrrrrrr�__le__jszSemanticVersion.__le__cCs
||kSrrrrrr�__ge__mszSemanticVersion.__ge__cCs
||kSrrrrrr�__gt__pszSemanticVersion.__gt__cCs
||kSrrrrrr�__ne__sszSemanticVersion.__ne__cCsd|��S)Nzpbr.version.SemanticVersion(%s))�release_stringr!rrr�__repr__vszSemanticVersion.__repr__cCs�|dd���std|��|�d�}dd�|D�}t|�}|dkrRtd|��n�|dkr�|t|�kr�||d��r�||}d	�t�d
d�|��}|�|�||t|�d�g|||d�<|d7}|�dgd|�|�||d��t	|d�}t	|d�}d}	d}
d}d}dd
�}
t
|d��r8t	|d�}nd}dg|dd�<|dd�}d}z|�rtt	|d��rtd}Wntk
�r�YnX|�r�t	|d�}	n�|�r�|dddk�s�|dddk�r�|
|d�\}}|dd�}|�rV|d}|�d��rt	|dd��}	n2|�d��r6d}	t	|dd��}
ntd||f��|dd�}�q�t||||||	d�}|
�r�|	�r�td|f��|�
��|
�}|S)a�Create a SemanticVersion from a pip version string.

        This method will parse a version like 1.3.0 into a SemanticVersion.

        This method is responsible for accepting any version string that any
        older version of pbr ever created.

        Therefore: versions like 1.3.0a1 versions are handled, parsed into a
        canonical form and then output - resulting in 1.3.0.0a1.
        Pre pbr-semver dev versions like 0.10.1.3.g83bef74 will be parsed but
        output as 0.10.1.dev3.g83bef74.

        :raises ValueError: Never tagged versions sdisted by old pbr result in
            just the git hash, e.g. '1234567' which poses a substantial problem
            since they collide with the semver versions when all the digits are
            numerals. Such versions will result in a ValueError being thrown if
            any non-numeric digits are present. They are an exception to the
            general case of accepting anything we ever output, since they were
            never intended and would permanently mess up versions on PyPI if
            ever released - we're treating that as a critical bug that we ever
            made them and have stopped doing that.
        Nr'zInvalid version %r�.cSsg|]}|��r|�qSr��isdigit)�.0�crrr�
<listcomp>�sz3SemanticVersion.from_pip_string.<locals>.<listcomp>r��cSs|��Srr6)�xrrr�<lambda>��z1SemanticVersion.from_pip_string.<locals>.<lambda>cSsTt�d�}d�t�||��}t�d�}d�t�||��}|t|�d�}|t|�fS)Nr7r<�isalpha)�operator�methodcaller�join�	itertools�	dropwhile�	takewhile�lenr)�segmentr7r@rrrrr�_parse_type�s

z4SemanticVersion.from_pip_string.<locals>._parse_type�FT�0)r#r$�r�dev�post�zUnknown remainder %r in %r)rrrz0Cannot combine postN and devN - no mapping in %r)r7r�splitrGrCrDrF�append�extendrr�
startswithr�	increment�to_dev)�klass�version_string�input_components�
components�	digit_len�mixed_component�last_componentrrr�
post_countrrrIr�	remainder�remainder_starts_with_int�	component�resultrrr�from_pip_stringys�
��
�������zSemanticVersion.from_pip_stringcCsd|j|j|jfS)�3Return the short version minus any alpha/beta tags.z%s.%s.%s)r	r
rr!rrr�brief_string�szSemanticVersion.brief_stringcCs
|�d�S)z�Return the version number to use when building a debian package.

        This translates the PEP440/semver precedence rules into Debian version
        sorting operators.
        �~��
_long_versionr!rrr�
debian_string�szSemanticVersion.debian_stringcCs`|jr|jd}|j}|j}n6d}|jr:|jd}|j}nd}|jrP|jd}nd}t|||�S)a�Return a decremented SemanticVersion.

        Decrementing versions doesn't make a lot of sense - this method only
        exists to support rendering of pre-release versions strings into
        serialisations (such as rpm) with no sort-before operator.

        The 9999 magic version component is from the spec on this - pbr-semver.

        :return: A new SemanticVersion object.
        r'i'r)rr
r	r)r�	new_patch�	new_minor�	new_majorrrr�	decrement�s"

�zSemanticVersion.decrementFcCs�|jr|j}|jd}|j}nd}d}|jd}|rL|jd}d}d}d}n|j}|rr|jd}d}d}d}d}n|j}t|||||�S)a~Return an incremented SemanticVersion.

        The default behaviour is to perform a patch level increment. When
        incrementing a prerelease version, the patch level is not changed
        - the prerelease serial is changed (e.g. beta 0 -> beta 1).

        Incrementing non-pre-release versions will not introduce pre-release
        versions - except when doing a patch incremental to a pre-release
        version the new version will only consist of major/minor/patch.

        :param minor: Increment the minor version.
        :param major: Increment the major version.
        :return: A new SemanticVersion object.
        r'Nr)rr
rr
r	r)rrr�new_prerelease_type�new_prereleaserirjrkrrrrT
s6



�zSemanticVersion.incrementr<cCs�|js|jr(|dkr(|����g}d}n
|��g}|jrR|�d|||j|jf�|jr�|jsj|�|�n
|�d�|�d�|�|j�d�dd�|D��S)a1Construct a long string version of this semver.

        :param pre_separator: What separator to use between components
            that sort before rather than after. If None, use . and lower the
            version number of the component to preserve sorting. (Used for
            rpm support)
        Nr5z%s%s%s%srMr<css|]}t|�VqdSr)�str)r8�srrr�	<genexpr>Psz0SemanticVersion._long_version.<locals>.<genexpr>)rrrlrdrQr
rC)r�
pre_separator�	rc_marker�segmentsrrrrg7s&�

��

zSemanticVersion._long_versioncCs|�dd�S)�hReturn the full version of the package.

        This including suffixes indicating VCS status.
        r5rKrfr!rrrr3RszSemanticVersion.release_stringcCs
|�d�S)aSReturn the version number to use when building an RPM package.

        This translates the PEP440/semver precedence rules into RPM version
        sorting operators. Because RPM has no sort-before operator (such as the
        ~ operator in dpkg),  we show all prerelease versions as being versions
        of the release before.
        Nrfr!rrr�
rpm_stringYszSemanticVersion.rpm_stringcCst|j|j|j|j|j|d�S)z~Return a development version of this semver.

        :param dev_count: The number of commits since the last release.
        )r)rr	r
rrr
)rrrrrrUcs�zSemanticVersion.to_devcCs�|j|j|jg}|jrVddddddd�}|�||jt|j�f�|�|jpP|j�n6|jrx|�d�|�|jd	�n|�d
�|�d�t|�S)a�Present the version as a version_info tuple.

        For documentation on version_info tuples see the Python
        documentation for sys.version_info.

        Since semver and PEP-440 represent overlapping but not subsets of
        versions, we have to have some heuristic / mapping rules, and have
        extended the releaselevel field to have alphadev, betadev and
        candidatedev values. When they are present the dev count is used
        to provide the serial.
         - a/b/rc take precedence.
         - if there is no pre-release version the dev version is used.
         - serial is taken from the dev/a/b/c component.
         - final non-dev versions never get serials.
        �alpha�beta�	candidate�alphadev�betadev�candidatedev))r#F)r$F)r%F)r#T)r$T)r%TrMr'�finalr)	r	r
rrrQ�boolrr
�tuple)rrt�type_maprrr�
version_tuplels&��


zSemanticVersion.version_tuple)rrNNN)FF)r<)�__name__�
__module__�__qualname__�__doc__rrr"r,r.r/r0r1r2r4�classmethodrbrdrhrlrTrgr3rvrUr�rrrrr$s6�


j
*

	rc@sVeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	e	Z
eZddd�ZdS)�VersionInfocCs||_d|_d|_d|_dS)z�Object that understands versioning for a package

        :param package: name of the python package, such as glance, or
                        python-glanceclient
        N)�package�version�_cached_version�	_semantic)rr�rrrr�szVersionInfo.__init__cCs|��S)z1Make the VersionInfo object behave like a string.)rWr!rrr�__str__�szVersionInfo.__str__cCsd|j|��fS)zInclude the name.zpbr.version.VersionInfo(%s:%s))r�rWr!rrrr4�s�zVersionInfo.__repr__cCs\z"tj�|j�}t�|�}|j}Wn.tjk
rPddlm}|�	|j�}YnXt
�|�S)aObtain a version from pkg_resources or setup-time logic if missing.

        This will try to get the version of the package from the pkg_resources
        record associated with the package, and if there is no such record
        falls back to the logic sdist would use.
        r)�	packaging)�
pkg_resources�Requirement�parser��get_providerr��DistributionNotFound�pbrr��get_versionrrb)r�requirement�provider�
result_stringr�rrr�_get_version_from_pkg_resources�s

z+VersionInfo._get_version_from_pkg_resourcescCs|����S)ru)�semantic_versionr3r!rrrr3�szVersionInfo.release_stringcCs|jdkr|��|_|jS)z3Return the SemanticVersion object for this version.N)r�r�r!rrrr��s

zVersionInfo.semantic_versioncCs|����S)rc)r�rdr!rrrrW�szVersionInfo.version_stringr<cCs|jsd||��f|_|jS)z�Return a cached version string.

        This will return a cached version string if one is already cached,
        irrespective of prefix. If none is cached, one will be created with
        prefix and then cached and returned.
        z%s%s)r�rW)r�prefixrrr�cached_version_string�s
�z!VersionInfo.cached_version_stringN)r<)
r�r�r�rr�r4r�r3r�rW�canonical_version_string�version_string_with_vcsr�rrrrr��sr�)	r�rDrAr(r�r�objectrr�rrrr�<module>so