C///

\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5�\D6?\BD�\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2� \00$\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4�\E9\F2�\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// """ Contains all deprecated functions. .. autofunction: deprecated """ import inspect import warnings from functools import partial, wraps from types import FrameType from typing import Type, Callable, Optional, cast from . import cli from .version import Version from ._types import Decorator, F def deprecated( func: Optional[F] = None, *, replace: Optional[str] = None, version: Optional[str] = None, remove: Optional[str] = None, category: Type[Warning] = DeprecationWarning, ) -> Decorator: """ 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 """ if func is None: return partial( deprecated, replace=replace, version=version, remove=remove, category=category, ) @wraps(func) def wrapper(*args, **kwargs) -> Callable[..., F]: msg_list = ["Function 'semver.{f}' is deprecated."] if version: msg_list.append("Deprecated since version {v}. ") if not remove: msg_list.append("This function will be removed in semver 3.") else: msg_list.append(str(remove)) if replace: msg_list.append("Use {r!r} instead.") else: msg_list.append("Use the respective 'semver.Version.{r}' instead.") f = cast(F, func).__qualname__ r = replace or f frame = cast(FrameType, cast(FrameType, inspect.currentframe()).f_back) msg = " ".join(msg_list) warnings.warn_explicit( msg.format(f=f, r=r, v=version), category=category, filename=inspect.getfile(frame.f_code), lineno=frame.f_lineno, ) # As recommended in the Python documentation # https://docs.python.org/3/library/inspect.html#the-interpreter-stack # better remove the interpreter stack: del frame return func(*args, **kwargs) # type: ignore return wrapper @deprecated( version="3.0.0", remove="Still under investigation, see #258.", category=PendingDeprecationWarning, ) def compare(ver1: str, ver2: str) -> int: """ 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 """ return Version.parse(ver1).compare(ver2) @deprecated(version="2.10.0") def parse(version): """ 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' """ return Version.parse(version).to_dict() @deprecated(replace="semver.version.Version.parse", version="2.10.0") def parse_version_info(version): """ 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' """ return Version.parse(version) @deprecated(version="2.10.0") def match(version, match_expr): """ 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 """ ver = Version.parse(version) return ver.match(match_expr) @deprecated(replace="max", version="2.10.2") def max_ver(ver1, ver2): """ 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' """ return str(max(ver1, ver2, key=Version.parse)) @deprecated(replace="min", version="2.10.2") def min_ver(ver1, ver2): """ 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' """ return str(min(ver1, ver2, key=Version.parse)) @deprecated(replace="str(versionobject)", version="2.10.0") def format_version(major, minor, patch, prerelease=None, build=None): """ 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' """ return str(Version(major, minor, patch, prerelease, build)) @deprecated(version="2.10.0") def bump_major(version): """ 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' """ return str(Version.parse(version).bump_major()) @deprecated(version="2.10.0") def bump_minor(version): """ 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' """ return str(Version.parse(version).bump_minor()) @deprecated(version="2.10.0") def bump_patch(version): """ 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' """ return str(Version.parse(version).bump_patch()) @deprecated(version="2.10.0") def bump_prerelease(version, token="rc"): """ 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' """ return str(Version.parse(version).bump_prerelease(token)) @deprecated(version="2.10.0") def bump_build(version, token="build"): """ 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' """ return str(Version.parse(version).bump_build(token)) @deprecated(version="2.10.0") def finalize_version(version): """ Remove any prerelease and build metadata from the version