ji ,<SrSSKrSSKrSSKJrJr SSKJr SSKJ r J r J r J r SSK Jr SSKJr SS KJrJr S4SSS\S .S \ \S \ \S \ \S\ \S\ \S\4 Sjjjr\"SS\S9S\S\S\4Sj5r\"SS9S5r\"SSS9S5r\"SS9S5r\"SS S9S!5r\"S"S S9S#5r\"S$SS9S5S%j5r \"SS9S&5r!\"SS9S'5r"\"SS9S(5r#\"SS9S6S)j5r$\"SS9S7S*j5r%\"SS9S+5r&\"SS9S,5r'\"\RPS-SS9r(\"\RRS.SS9r)\"\RTS/SS9r*\"\RVS0SS9r+\"\RXS1SS9r,\"\RZS2SS9r-\"\R\S3SS9r.g)8zA Contains all deprecated functions. .. autofunction: deprecated N)partialwraps) FrameType)TypeCallableOptionalcast)cli)Version) DecoratorFreplaceversionremovecategoryfuncrrrrreturnc^^^^^Tc[[TTTTS9$[T5S[S[44UUUUU4Sjj5nU$)a& Decorates a function to output a deprecation warning. :param func: the function to decorate :param replace: the function to replace (use the full qualified name like ``semver.version.Version.bump_major``. :param 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. :return: decorated function which is marked as deprecated rr.c>S/nT (aURS5 T (dURS5 OUR[T 55 T (aURS5 OURS5 [[T5RnT =(d Un[[ [[ [ R"55R5nSRU5n[R"URX4T S9T[ R"UR5URS9 AT"U0UD6$) Nz$Function 'semver.{f}' is deprecated.zDeprecated since version {v}. z*This function will be removed in semver 3.zUse {r!r} instead.z0Use the respective 'semver.Version.{r}' instead. )frv)rfilenamelineno)appendstrr r __qualname__rinspect currentframef_backjoinwarnings warn_explicitformatgetfilef_codef_lineno) argskwargsmsg_listrrframemsgrrrrrs 2lib/python3.13/site-packages/semver/_deprecated.pywrapperdeprecated..wrapper0s:;  OO< = OOH I OOCK (  OO0 1 OON O DM & & LqYY0D0D0F G N NOhhx  JJ7J +__U\\2>>   T$V$$)r deprecatedrrr)rrrrrr1s````` r0r4r4s[* |     4[ %HS!V$4 % % %D Nr3z3.0.0z$Still under investigation, see #258.)rrrver1ver2cL[R"U5RU5$)a Compare two versions strings. .. deprecated:: 3.0.0 The situation of this function is unclear and it might disappear in the future. If possible, use :meth:`semver.version.Version.compare`. See :gh:`258` for details. :param ver1: first version string :param ver2: second version string :return: The return value is negative if ver1 < ver2, zero if ver1 == ver2 and strictly positive if ver1 > ver2 >>> 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 )r parsecomparer5r6s r0r9r9Vs6 ==  & &t ,,r3z2.10.0rcJ[R"U5R5$)a Parse version to major, minor, patch, pre-release, build parts. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.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' )r r8to_dictr;s r0r8r8ts4 == ! ) ) ++r3zsemver.version.Version.parse)rrc.[R"U5$)a Parse version string to a Version instance. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.parse` instead. .. versionadded:: 2.7.2 Added :func:`semver.parse_version_info` :param version: version string :return: a :class:`VersionInfo` instance >>> version_info = semver.Version.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' )r r8r;s r0parse_version_infor?s2 == !!r3cP[R"U5nURU5$)a" Compare two versions strings through a comparison. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.match` instead. :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 )r r8match)r match_exprvers r0rArAs!0 -- C 99Z  r3maxz2.10.2cD[[X[RS95$)a Returns the greater version of two versions strings. .. deprecated:: 2.10.2 Use :func:`max` instead. :param ver1: version string 1 :param ver2: version string 2 :return: the greater version of the two :rtype: :class:`Version` >>> semver.max_ver("1.0.0", "2.0.0") '2.0.0' key)rrDr r8r:s r0max_verrH s47==1 22r3mincD[[X[RS95$)a Returns the smaller version of two versions strings. .. deprecated:: 2.10.2 Use Use :func:`min` instead. :param ver1: version string 1 :param ver2: version string 2 :return: the smaller version of the two :rtype: :class:`Version` >>> semver.min_ver("1.0.0", "2.0.0") '1.0.0' rF)rrJr r8r:s r0min_verrLrIr3zstr(versionobject)c .[[XX#U55$)a$ Format a version string according to the Semantic Versioning specification. .. deprecated:: 2.10.0 Use ``str(Version(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' )rr )majorminorpatch prereleasebuilds r0format_versionrSs& wuU> ??r3c\[[R"U5R55$)z Raise the major part of the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.bump_major` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_major("3.4.5") '4.0.0' )rr r8 bump_majorr;s r0rUrU! w}}W%002 33r3c\[[R"U5R55$)z Raise the minor part of the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.bump_minor` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_minor("3.4.5") '3.5.0' )rr r8 bump_minorr;s r0rXrXrVr3c\[[R"U5R55$)z Raise the patch part of the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.bump_patch` instead. :param: version string :return: the raised version string :rtype: str >>> semver.bump_patch("3.4.5") '3.4.6' )rr r8 bump_patchr;s r0rZrZ)rVr3c^[[R"U5RU55$)a2 Raise the prerelease part of the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.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' )rr r8bump_prereleasertokens r0r\r\;s# w}}W%55e< ==r3c^[[R"U5RU55$)a4 Raise the build part of the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.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' )rr r8 bump_buildr]s r0r`r`Ns# w}}W%007 88r3c`[R"U5n[UR55$)a\ Remove any prerelease and build metadata from the version string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.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' )r r8rfinalize_version)rverinfos r0rbrbas&$mmG$G w'') **r3c `[[R"U5R"S0UD65$)a Replace one or more parts of a version and return the new string. .. deprecated:: 2.10.0 Use :meth:`~semver.version.Version.replace` instead. .. versionadded:: 2.9.0 Added :func:`replace` :param version: the version string to replace :param 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 >>> import semver >>> semver.replace("1.2.3", major=2, patch=10) '2.2.10' )rr r8r)rpartss r0rrws&( w}}W%--66 77r3zsemver.cli.cmd_bumpzsemver.cli.cmd_checkzsemver.cli.cmd_comparezsemver.cli.cmd_nextverzsemver.cli.createparserzsemver.cli.processzsemver.cli.main)N)NN)rc)rR)/__doc__r!r% functoolsrrtypesrtypingrrrr r rr _typesr rDeprecationWarningrWarningr4PendingDeprecationWarningintr9r8r?rArHrLrSrUrXrZr\r`rbrcmd_bump cmd_check cmd_compare cmd_nextver createparserprocessmainrer3r0rys $11 A"! 0 A 1+Ac]Ac] A SM A 7m AAH  1 & -#-S-S-  -2 H,,8 2HE"F"6 H!!6 E8,3-3$ E8,3-3$ ((;@<@* H44" H44" H44" H>>$ H99$ H++* H88. cll,A7 S s}}.Dg V OO5w OO5w 7  S[[*> P#(($5wGr3