U ꥡc @sdZddlmZddlZddlZddlmZmZddlZddl Z ddl Z ddl Z e j ddkZ e j ddkZdZdZd Zd d gZd Zd ZdZeedsddZereefZeZeZddZddZn e efZe ZeZddZddZdXddZ!ddde"fddZ#e#dddd Z$d!d"Z%Gd#d$d$e&Z'e#d%dd&d'd(Z(d)d*Z)e#ddd+d,Z*e#ddd-d.Z+e#d/d0d&d1d2Z,e#d3d0d&d4d5Z-e#d6dd&dYd7d8Z.e#ddd9d:Z/e#ddd;d<Z0e#ddd=d>Z1e#dddZd@dAZ2e#ddd[dCdDZ3e#dddEdFZ4e#dddGdHZ5dIdJZ6dKdLZ7dMdNZ8dOdPZ9dQdRZ:dSdTZ;d\dUdVZZ>e>?dS)]z:Python helper for Semantic Versioning (http://semver.org/))print_functionN)wrapspartialz2.13.0zKostiantyn Rybnikovz k-bx@k-bx.comzSebastien Cellesz Tom Schraitlezs.celles@gmail.com) bump_build bump_major bump_minor bump_patchbump_prereleasecompare deprecatedfinalize_versionformat_versionmatchmax_vermin_verparseparse_version_inforeplacecmd_bump cmd_check cmd_compare createparsermainprocessSEMVER_SPEC_VERSION VersionInfoz2.0.0cmpcCs||k||kS)z6Return negative if ab.abrr*/tmp/pip-unpacked-wheel-wk009ffn/semver.pyr>scCs |dS)Nzlatin-1)encodesrrr#r"Hsr"cCs|SNrr%rrr#uKsr(cCs|Sr'rr%rrr#r"TscCst|dddS)Nz\\z\\\\Zunicode_escape)unicoderr%rrr#r(Xsutf-8strictcCsXt|ttfstdt|tr:t|tr:|||}ntrTt|trT|||}|S)z Coerce *s* to `str`. For Python 2: - `unicode` -> encoded to `str` - `str` -> `str` For Python 3: - `str` -> `str` - `bytes` -> decoded to `str` znot expecting type '%s') isinstance text_type binary_type TypeErrortypePY2r$PY3decode)r&encodingerrorsrrr# ensure_str\s  r6cs6dkrttdStfdd}|S)a Decorates a function to output a deprecation warning. :param func: the function to decorate (or None) :param str replace: the function to replace (use the full qualified name like ``semver.VersionInfo.bump_major``. :param str version: the first version when this function was deprecated. :param category: allow you to specify the deprecation warning class of your choice. By default, it's :class:`DeprecationWarning`, but you can choose :class:`PendingDeprecationWarning` or a custom class. N)rversioncategorycsdg}r|d|dr.|dn |dtdrHjnj}pT|}tj}d|}tj |j j ||dt |j |jd ~||S) Nz!Function '{m}.{f}' is deprecated.zDeprecated since version {v}. z*This function will be removed in semver 3.zUse {r!r} instead.z4Use the respective 'semver.VersionInfo.{r}' instead. __qualname__ )mfrv)r8filenamelineno)appendhasattrr9__name__inspect currentframef_backjoinwarnings warn_explicitformat __module__getfilef_codef_lineno)argskwargsmsgr<r=framer8funcrr7rr#wrappers&        zdeprecated..wrapper)rr r)rTrr7r8rUrrSr#r rs r 2.10.0r7cCst|S)aK Parse version to major, minor, patch, pre-release, build parts. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.parse` instead. :param version: version string :return: dictionary with the keys 'build', 'major', 'minor', 'patch', and 'prerelease'. The prerelease or build keys can be None if not provided :rtype: dict >>> ver = semver.parse('3.4.5-pre.2+build.4') >>> ver['major'] 3 >>> ver['minor'] 4 >>> ver['patch'] 5 >>> ver['prerelease'] 'pre.2' >>> ver['build'] 'build.4' )rrto_dictrWrrr#rsrcstfdd}|S)z4Wrap a VersionInfo binary op method in a type-check.cs8ttttttf}t||s.tdt||f||S)Nzother type %r must be in %r) rdicttuplelistr-r.r,r/r0)selfotherZcomparable_typesoperatorrr#rUs  zcomparator..wrapper)r)r_rUrr^r# comparatorsr`c@seZdZdZdZedZedejZ dVddZ e d d Z e j d d Z e d d Zej dd Ze ddZej ddZe ddZej ddZe ddZej ddZddZddZeddddd Zeje_ed!ddd"d#Zeje_d$d%Zed&d'Zd(d)Zd*d+Zd,d-ZdWd/d0ZdXd2d3Zd4d5ZdYd6d7Z e!d8d9Z"e!d:d;Z#e!dd?Z%e!d@dAZ&e!dBdCZ'dDdEZ(dFdGZ)dHdIZ*dJdKZ+dLdMZ,dNdOZ-e.dPdQZ/dRdSZ0e.dTdUZ1dS)Zra A semver compatible version class. :param int major: version when you make incompatible API changes. :param int minor: version when you add functionality in a backwards-compatible manner. :param int patch: version when you make backwards-compatible bug fixes. :param str prerelease: an optional prerelease string :param str build: an optional build string )_major_minor_patch _prerelease_buildz(?:[^\d]*(\d+)[^\d]*)+a ^ (?P0|[1-9]\d*) \. (?P0|[1-9]\d*) \. (?P0|[1-9]\d*) (?:-(?P (?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*) (?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))* ))? (?:\+(?P [0-9a-zA-Z-]+ (?:\.[0-9a-zA-Z-]+)* ))? $ rNc Cs|||d}|D].\}}t|}|||<|dkrtd|q|d|_|d|_|d|_|dkrndnt||_|dkrdnt||_ dS)Nmajorminorpatchrz1{!r} is negative. A version can only be positive.rgrhri) itemsint ValueErrorrJrarbrcstrrdre) r\rgrhri prereleasebuild version_partsnamevaluerrr#__init__s    zVersionInfo.__init__cCs|jS)z(The major part of a version (read-only).)rar\rrr#rg szVersionInfo.majorcCs tddS)Nzattribute 'major' is readonlyAttributeErrorr\rrrrr#rgscCs|jS)z(The minor part of a version (read-only).)rbrtrrr#rhszVersionInfo.minorcCs tddS)Nzattribute 'minor' is readonlyrurwrrr#rhscCs|jS)z(The patch part of a version (read-only).)rcrtrrr#riszVersionInfo.patchcCs tddS)Nzattribute 'patch' is readonlyrurwrrr#ri"scCs|jS)z-The prerelease part of a version (read-only).)rdrtrrr#rn&szVersionInfo.prereleasecCs tddS)Nz"attribute 'prerelease' is readonlyrurwrrr#rn+scCs|jS)z(The build part of a version (read-only).)rertrrr#ro/szVersionInfo.buildcCs tddS)Nzattribute 'build' is readonlyrurwrrr#ro4scCs|j|j|j|j|jfS)ay Convert the VersionInfo object to a tuple. .. versionadded:: 2.10.0 Renamed ``VersionInfo._astuple`` to ``VersionInfo.to_tuple`` to make this function available in the public API. :return: a tuple with all the parts :rtype: tuple >>> semver.VersionInfo(5, 3, 1).to_tuple() (5, 3, 1, None, None) rgrhrirnrortrrr#to_tuple8szVersionInfo.to_tuplecCs2td|jfd|jfd|jfd|jfd|jffS)a: Convert the VersionInfo object to an OrderedDict. .. versionadded:: 2.10.0 Renamed ``VersionInfo._asdict`` to ``VersionInfo.to_dict`` to make this function available in the public API. :return: an OrderedDict with the keys in the order ``major``, ``minor``, ``patch``, ``prerelease``, and ``build``. :rtype: :class:`collections.OrderedDict` >>> semver.VersionInfo(3, 2, 1).to_dict() OrderedDict([('major', 3), ('minor', 2), ('patch', 1), ('prerelease', None), ('build', None)]) rgrhrirnro) collections OrderedDictrgrhrirnrortrrr#rXHszVersionInfo.to_dictzsemver.VersionInfo.to_tuplerVrr7cCs|Sr'ryrtrrr#_astuplecszVersionInfo._astuplezsemver.VersionInfo.to_dictcCs|Sr')rXrtrrr#_asdictiszVersionInfo._asdictccs|D] }|VqdS)zImplement iter(self).Nr})r\r>rrr#__iter__os zVersionInfo.__iter__cCsbtj|}|r^tt|dd}|d\}}|dt|t|||||d}|S)a Look for the last sequence of number(s) in a string and increment. :param str string: the string to search for. :return: the incremented string Source: http://code.activestate.com/recipes/442460-increment-numbers-in-a-string/#c1 N) r _LAST_NUMBERsearchrmrkgroupspanmaxlen)stringrZnext_startendrrr#_increment_stringus *zVersionInfo._increment_stringcCst|}||jdS)ag Raise the major part of the version, return a new object but leave self untouched. :return: new object with the raised major part :rtype: :class:`VersionInfo` >>> ver = semver.VersionInfo.parse("3.4.5") >>> ver.bump_major() VersionInfo(major=4, minor=0, patch=0, prerelease=None, build=None) r)r0rar\clsrrr#rs zVersionInfo.bump_majorcCst|}||j|jdS)ag Raise the minor part of the version, return a new object but leave self untouched. :return: new object with the raised minor part :rtype: :class:`VersionInfo` >>> ver = semver.VersionInfo.parse("3.4.5") >>> ver.bump_minor() VersionInfo(major=3, minor=5, patch=0, prerelease=None, build=None) r)r0rarbrrrr#r s zVersionInfo.bump_minorcCst|}||j|j|jdS)ag Raise the patch part of the version, return a new object but leave self untouched. :return: new object with the raised patch part :rtype: :class:`VersionInfo` >>> ver = semver.VersionInfo.parse("3.4.5") >>> ver.bump_patch() VersionInfo(major=3, minor=4, patch=6, prerelease=None, build=None) r)r0rarbrcrrrr#r s zVersionInfo.bump_patchrccCs4t|}||jp|pdd}||j|j|j|S)a Raise the prerelease part of the version, return a new object but leave self untouched. :param token: defaults to 'rc' :return: new object with the raised prerelease part :rtype: :class:`VersionInfo` >>> ver = semver.VersionInfo.parse("3.4.5-rc.1") >>> ver.bump_prerelease() VersionInfo(major=3, minor=4, patch=5, prerelease='rc.2', build=None) r.0)r0rrdrarbrc)r\tokenrrnrrr#r szVersionInfo.bump_prereleaserocCs8t|}||jp|pdd}||j|j|j|j|S)a Raise the build part of the version, return a new object but leave self untouched. :param token: defaults to 'build' :return: new object with the raised build part :rtype: :class:`VersionInfo` >>> ver = semver.VersionInfo.parse("3.4.5-rc.1+build.9") >>> ver.bump_build() VersionInfo(major=3, minor=4, patch=5, prerelease='rc.1', build='build.10') ror)r0rrerarbrcrd)r\rrrorrr#rszVersionInfo.bump_buildc Cst|}t|tr||}nNt|tr4|f|}n8t|ttfrL||}n t||sltd|j t|| dd}| dd}t ||}|r|S|j |j }}t ||}|sdS|sdS|sdS|S)aw Compare self with other. :param other: the second version (can be string, a dict, tuple/list, or a VersionInfo instance) :return: The return value is negative if ver1 < ver2, zero if ver1 == ver2 and strictly positive if ver1 > ver2 :rtype: int >>> semver.VersionInfo.parse("1.0.0").compare("2.0.0") -1 >>> semver.VersionInfo.parse("2.0.0").compare("1.0.0") 1 >>> semver.VersionInfo.parse("2.0.0").compare("2.0.0") 0 >>> semver.VersionInfo.parse("2.0.0").compare(dict(major=2, minor=0, patch=0)) 0 z'Expected str or {} instance, but got {}Nrrr)r0r, string_typesrrYrZr[r/rJrCryrrn_nat_cmp) r\r]rv1Zv2xZrc1Zrc2Zrccmprrr#r s8        zVersionInfo.comparecCsddddh}||kr&tdj||d|}|js6|jr|dkst|dkrP|jdkst|dkr|j|jkrpdkrnn|jddd S|d krt|d |S|js|}| |S) a Determines next version, preserving natural order. .. versionadded:: 2.10.0 This function is taking prereleases into account. The "major", "minor", and "patch" raises the respective parts like the ``bump_*`` functions. The real difference is using the "preprelease" part. It gives you the next patch version of the prerelease, for example: >>> str(semver.VersionInfo.parse("0.1.4").next_version("prerelease")) '0.1.5-rc.1' :param part: One of "major", "minor", "patch", or "prerelease" :param prerelease_token: prefix string of prerelease, defaults to 'rc' :return: new object with the appropriate part raised :rtype: :class:`VersionInfo` rgrhrirnz self[index] Implement getitem. If the part requested is undefined, or a part of the range requested is undefined, it will throw an index error. Negative indices are not supported :param Union[int, slice] index: a positive integer indicating the offset or a :func:`slice` object :raises: IndexError, if index is beyond the range or a part is None :return: the requested part of the version at position index >>> ver = semver.VersionInfo.parse("3.4.5") >>> ver[0], ver[1], ver[2] (3, 4, 5) rNrz Version index cannot be negativecSs|dk Sr'r)prrr#nz)VersionInfo.__getitem__..zVersion part undefined) r,rkslicerstop IndexErrorrZfilterryr)r\indexrrrr# __getitem__Ss&   zVersionInfo.__getitem__cCs.ddd|D}dt|j|fS)N, css|]\}}d||fVqdS)z%s=%rNr).0keyvalrrr# wsz'VersionInfo.__repr__..z%s(%s))rGrXrjr0rC)r\r&rrr#__repr__vszVersionInfo.__repr__cCs@d|j|j|jf}|jr(|d|j7}|jr<|d|j7}|S)z str(self)z%d.%d.%dz-%sz+%srx)r\r7rrr#__str__zs zVersionInfo.__str__cCst|ddS)N)hashryrtrrr#__hash__szVersionInfo.__hash__cCst|}||j|j|jS)a Remove any prerelease and build metadata from the version. :return: a new instance with the finalized version string :rtype: :class:`VersionInfo` >>> str(semver.VersionInfo.parse('1.2.3-rc.5').finalize_version()) '1.2.3' )r0rgrhrirrrr#rs zVersionInfo.finalize_versioncCs|dd}|dkr"|dd}n2|rH|ddkrH|d}|dd}n td|dd d d d d d}||}||}||kS)aB Compare self to match a match expression. :param str match_expr: operator and version; valid operators are < smaller than > greater than >= greator or equal than <= smaller or equal than == equal != not equal :return: True if the expression matches the version, otherwise False :rtype: bool >>> semver.VersionInfo.parse("2.0.0").match(">=1.0.0") True >>> semver.VersionInfo.parse("1.0.0").match(">1.0.0") False Nr)>=<===!=r)>, where is one of ['<', '>', '==', '<=', '>=', '!=']. You provided: %r)r)r)r)rr)rr)rr)rrrrrr)rlr )r\ match_exprprefixZ match_versionZpossibilities_dict possibilitiescmp_resrrr#rs*   zVersionInfo.matchcCsf|jt|}|dkr$td||}t|d|d<t|d|d<t|d|d<|f|S)a Parse version string to a VersionInfo instance. :param version: version string :return: a :class:`VersionInfo` instance :raises: :class:`ValueError` :rtype: :class:`VersionInfo` .. versionchanged:: 2.11.0 Changed method from static to classmethod to allow subclasses. >>> semver.VersionInfo.parse('3.4.5-pre.2+build.4') VersionInfo(major=3, minor=4, patch=5, prerelease='pre.2', build='build.4') Nz%s is not valid SemVer stringrgrhri)_REGEXrr6rl groupdictrk)rr7rrprrr#rs zVersionInfo.parsecKsj|}||z tf|WStk rdt|t|}dt|d|f}t|YnXdS)a Replace one or more parts of a version and return a new :class:`VersionInfo` object, but leave self untouched .. versionadded:: 2.9.0 Added :func:`VersionInfo.replace` :param dict parts: the parts to be updated. Valid keys are: ``major``, ``minor``, ``patch``, ``prerelease``, or ``build`` :return: the new :class:`VersionInfo` object with the changed parts :raises: :class:`TypeError`, if ``parts`` contains invalid keys z3replace() got %d unexpected keyword argument(s): %srN)rXupdaterr/setrrG)r\partsr7Z unknownkeyserrorrrr#rs  zVersionInfo.replacecCs,z||WdStk r&YdSXdS)a Check if the string is a valid semver version. .. versionadded:: 2.9.1 :param str version: the version string to check :return: True if the version string is a valid semver version, False otherwise. :rtype: bool TFN)rrl)rr7rrr#isvalids  zVersionInfo.isvalid)rrNN)r)ro)r)2rCrKr9__doc__ __slots__recompilerVERBOSErrspropertyrgsetterrhrirnroryrXr r~rr staticmethodrrr r r rr rr`rrrrrrrrrrrr classmethodrrrrrrr#rs                    3 0      #  / rzsemver.VersionInfo.parser|cCs t|S)aH Parse version string to a VersionInfo instance. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.parse` instead. .. versionadded:: 2.7.2 Added :func:`semver.parse_version_info` :param version: version string :return: a :class:`VersionInfo` instance :rtype: :class:`VersionInfo` >>> version_info = semver.VersionInfo.parse("3.4.5-pre.2+build.4") >>> version_info.major 3 >>> version_info.minor 4 >>> version_info.patch 5 >>> version_info.prerelease 'pre.2' >>> version_info.build 'build.4' )rrrWrrr#r src sddfdd}dd}|p"d|p(d}}||||}}t||D]"\}}|||}|dkrJ|SqJtt|t|S) NcSstd|rt|S|S)Nz^[0-9]+$)rrrk)textrrr#convert,sz_nat_cmp..convertcsfdd|dDS)Ncsg|] }|qSrr)rcrrr# 0sz/_nat_cmp..split_key...)split)rrrr# split_key/sz_nat_cmp..split_keycSsHt|trt|trt||St|tr,dSt|tr:dSt||SdS)Nrr)r,rkrr rrr#cmp_prerelease_tag2s   z$_nat_cmp..cmp_prerelease_tagr)ziprr) r!r"rrZa_partsZb_partsZsub_aZsub_bZ cmp_resultrrr#r+s    rcCst|}||S)a Compare two versions strings. :param ver1: version string 1 :param ver2: version string 2 :return: The return value is negative if ver1 < ver2, zero if ver1 == ver2 and strictly positive if ver1 > ver2 :rtype: int >>> semver.compare("1.0.0", "2.0.0") -1 >>> semver.compare("2.0.0", "1.0.0") 1 >>> semver.compare("2.0.0", "2.0.0") 0 )rrr )ver1ver2rrrr#r Fs r cCst|}||S)a Compare two versions strings through a comparison. :param str version: a version string :param str match_expr: operator and version; valid operators are < smaller than > greater than >= greator or equal than <= smaller or equal than == equal != not equal :return: True if the expression matches the version, otherwise False :rtype: bool >>> semver.match("2.0.0", ">=1.0.0") True >>> semver.match("1.0.0", ">1.0.0") False )rrr)r7rverrrr#r\s rrz2.10.2cCsHt|trt|}nt|ts&t||}|dkr@t|S|SdS)a Returns the greater version of two versions strings. :param ver1: version string 1 :param ver2: version string 2 :return: the greater version of the two :rtype: :class:`VersionInfo` >>> semver.max_ver("1.0.0", "2.0.0") '2.0.0' rN)r,rrrr/r rmrrrrrr#rus    rmincCs,t|}||}|dkr$t|S|SdS)a Returns the smaller version of two versions strings. :param ver1: version string 1 :param ver2: version string 2 :return: the smaller version of the two :rtype: :class:`VersionInfo` >>> semver.min_ver("1.0.0", "2.0.0") '1.0.0' rN)rrr rmrrrr#rs  rzstr(versionobject)cCstt|||||S)a\ Format a version string according to the Semantic Versioning specification. .. deprecated:: 2.10.0 Use ``str(VersionInfo(VERSION)`` instead. :param int major: the required major part of a version :param int minor: the required minor part of a version :param int patch: the required patch part of a version :param str prerelease: the optional prerelease part of a version :param str build: the optional build part of a version :return: the formatted string :rtype: str >>> semver.format_version(3, 4, 5, 'pre.2', 'build.4') '3.4.5-pre.2+build.4' )rmrrxrrr#rsrcCstt|S)a Raise the major part of the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.bump_major` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_major("3.4.5") '4.0.0' )rmrrrrWrrr#rsrcCstt|S)a Raise the minor part of the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.bump_minor` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_minor("3.4.5") '3.5.0' )rmrrr rWrrr#r sr cCstt|S)a Raise the patch part of the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.bump_patch` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_patch("3.4.5") '3.4.6' )rmrrr rWrrr#r sr rcCstt||S)aU Raise the prerelease part of the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.bump_prerelease` instead. :param version: version string :param token: defaults to 'rc' :return: the raised version string :rtype: str >>> semver.bump_prerelease('3.4.5', 'dev') '3.4.5-dev.1' )rmrrr r7rrrr#r sr rocCstt||S)aW Raise the build part of the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.bump_build` instead. :param version: version string :param token: defaults to 'build' :return: the raised version string :rtype: str >>> semver.bump_build('3.4.5-rc.1+build.9') '3.4.5-rc.1+build.10' )rmrrrrrrr#rsrcCst|}t|S)a Remove any prerelease and build metadata from the version string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.finalize_version` instead. .. versionadded:: 2.7.9 Added :func:`finalize_version` :param version: version string :return: the finalized version string :rtype: str >>> semver.finalize_version('1.2.3-rc.5') '1.2.3' )rrrmr)r7Zverinforrr#rs rcKstt|jf|S)a^ Replace one or more parts of a version and return the new string. .. deprecated:: 2.10.0 Use :func:`semver.VersionInfo.replace` instead. .. versionadded:: 2.9.0 Added :func:`replace` :param str version: the version string to replace :param dict parts: the parts to be updated. Valid keys are: ``major``, ``minor``, ``patch``, ``prerelease``, or ``build`` :return: the replaced version string :raises: TypeError, if ``parts`` contains invalid keys :rtype: str >>> import semver >>> semver.replace("1.2.3", major=2, patch=10) '2.2.10' )rmrrr)r7rrrr#r*srcCsPdddddd}|jdkr*|jdd gt|j}t|||j}t|S) z Subcommand: Bumps a version. Synopsis: bump can be major, minor, patch, prerelease, or build :param args: The parsed arguments :type args: :class:`argparse.Namespace` :return: the new, bumped version rr r r rrxNbumpz-h)rparser parse_argsrrr7rrm)rOZmaptablerrTrrr#rDs   rcCs"t|jrdStd|jdS)z Subcommand: Checks if a string is a valid semver version. Synopsis: check :param args: The parsed arguments :type args: :class:`argparse.Namespace` NzInvalid version %r)rrr7rlrOrrr#ras rcCstt|j|jS)z Subcommand: Compare two versions Synopsis: compare :param args: The parsed arguments :type args: :class:`argparse.Namespace` )rmr version1version2rrrr#ros rcCst|j}t||jS)z Subcommand: Determines the next version, taking prereleases into account. Synopsis: nextver :param args: The parsed arguments :type args: :class:`argparse.Namespace` )rrr7rmrr)rOr7rrr# cmd_nextver{s rcCs>tjttd}|jdddtd|}|jddd}|jt d |jd d d|jd d d|jddd}|jt d |jddd}|jddd|jddd|jddd|jddd|jdddfD]}|jdddq|jddd}|jt d |jddd|jd d!d}|jt d |jddd|jd"d#d|S)$z Create an :class:`argparse.ArgumentParser` instance. :return: parser instance :rtype: :class:`argparse.ArgumentParser` )prog descriptionz --versionr7z %(prog)s )actionr7r zCompare two versions)help)rTrz First versionrzSecond versionrzBumps a versionz Bump commands)titledestrgz"Bump the major part of the versionrhz"Bump the minor part of the versionriz"Bump the patch part of the versionrnz'Bump the prerelease part of the versionroz"Bump the build part of the versionzVersion to raisecheckz,Checks if a string is a valid semver versionzVersion to checkZnextverz=Determines the next version, taking prereleases into account.rz1One of 'major', 'minor', 'patch', or 'prerelease') argparseArgumentParser __package__r add_argument __version__add_subparsers add_parser set_defaultsrrrr)rr&Zparser_compareZ parser_bumpZsbrZ parser_checkZparser_nextverrrr#rsL         rcCs$t|ds|jt||S)a Process the input from the CLI. :param args: The parsed arguments :type args: :class:`argparse.Namespace` :param parser: the parser instance :type parser: :class:`argparse.ArgumentParser` :return: result of the selected action :rtype: str rT)rBr print_help SystemExitrTrrrr#rs  rc Csxz6t}|j|d}||_t|}|dk r2t|WdSttfk rr}ztd|tjdWYdSd}~XYnXdS)z Entry point for the application script. :param list cliargs: Arguments to parse or None (=use :class:`sys.argv`) :return: error code :rtype: int rNrERROR)filer) rrrrprintrlr/sysstderr)ZcliargsrrOresulterrrrr#rs r__main__)r*r+)NN)r)ro)N)@r __future__rrrz functoolsrrrDrrrH version_infor1r2r __author____author_email__Z__maintainer__Z__maintainer_email____all__rrB __builtins__rrmbytesrr-r.r"r(r)r6DeprecationWarningr rr`objectrrrr rrrrrr r r rrrrrrrrrrrCdoctesttestmodrrrr#s !   2 A                   6