summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/util
diff options
context:
space:
mode:
authormike bayer <mike_mp@zzzcomputing.com>2022-01-06 19:15:06 +0000
committerGerrit Code Review <gerrit@ci3.zzzcomputing.com>2022-01-06 19:15:06 +0000
commitdd5f9c2039731adb6c019c4cc3a39694f9b236ad (patch)
treece80dd61476c0c09f792f5690c7c7434b7876cc7 /lib/sqlalchemy/util
parentf3c93170dcbe705da25bc18bad2b29620d82a490 (diff)
parent01c50c64e302c193733cef7fb146fbab8eaa44bd (diff)
downloadsqlalchemy-dd5f9c2039731adb6c019c4cc3a39694f9b236ad.tar.gz
Merge "Remove all remaining removed_in_20 warnings slated for removal" into main
Diffstat (limited to 'lib/sqlalchemy/util')
-rw-r--r--lib/sqlalchemy/util/__init__.py5
-rw-r--r--lib/sqlalchemy/util/deprecations.py87
2 files changed, 6 insertions, 86 deletions
diff --git a/lib/sqlalchemy/util/__init__.py b/lib/sqlalchemy/util/__init__.py
index b452a1fda..eb9ddb313 100644
--- a/lib/sqlalchemy/util/__init__.py
+++ b/lib/sqlalchemy/util/__init__.py
@@ -70,16 +70,13 @@ from .concurrency import await_fallback
from .concurrency import await_only
from .concurrency import greenlet_spawn
from .concurrency import is_exit_exception
+from .deprecations import became_legacy_20
from .deprecations import deprecated
-from .deprecations import deprecated_20
-from .deprecations import deprecated_20_cls
from .deprecations import deprecated_cls
from .deprecations import deprecated_params
from .deprecations import inject_docstring_text
from .deprecations import moved_20
-from .deprecations import SQLALCHEMY_WARN_20
from .deprecations import warn_deprecated
-from .deprecations import warn_deprecated_20
from .langhelpers import add_parameter_text
from .langhelpers import as_interface
from .langhelpers import asbool
diff --git a/lib/sqlalchemy/util/deprecations.py b/lib/sqlalchemy/util/deprecations.py
index 4d3e04fde..6a0fdecb5 100644
--- a/lib/sqlalchemy/util/deprecations.py
+++ b/lib/sqlalchemy/util/deprecations.py
@@ -8,7 +8,6 @@
"""Helpers related to deprecation of functions, methods, classes, other
functionality."""
-import os
import re
from . import compat
@@ -20,19 +19,7 @@ from .langhelpers import inject_param_text
from .. import exc
-SQLALCHEMY_WARN_20 = False
-
-if os.getenv("SQLALCHEMY_WARN_20", "false").lower() in ("true", "yes", "1"):
- SQLALCHEMY_WARN_20 = True
-
-
def _warn_with_version(msg, version, type_, stacklevel, code=None):
- if (
- issubclass(type_, exc.Base20DeprecationWarning)
- and not SQLALCHEMY_WARN_20
- ):
- return
-
warn = type_(msg, code=code)
warn.deprecated_since = version
@@ -57,17 +44,6 @@ def warn_deprecated_limited(msg, args, version, stacklevel=3, code=None):
)
-def warn_deprecated_20(msg, stacklevel=3, code=None):
-
- _warn_with_version(
- msg,
- exc.RemovedIn20Warning.deprecated_since,
- exc.RemovedIn20Warning,
- stacklevel,
- code=code,
- )
-
-
def deprecated_cls(version, message, constructor="__init__"):
header = ".. deprecated:: %s %s" % (version, (message or ""))
@@ -84,41 +60,6 @@ def deprecated_cls(version, message, constructor="__init__"):
return decorate
-def deprecated_20_cls(
- clsname, alternative=None, constructor="__init__", becomes_legacy=False
-):
- message = (
- ".. deprecated:: 1.4 The %s class is considered legacy as of the "
- "1.x series of SQLAlchemy and %s in 2.0."
- % (
- clsname,
- "will be removed"
- if not becomes_legacy
- else "becomes a legacy construct",
- )
- )
-
- if alternative:
- message += " " + alternative
-
- if becomes_legacy:
- warning_cls = exc.LegacyAPIWarning
- else:
- warning_cls = exc.RemovedIn20Warning
-
- def decorate(cls):
- return _decorate_cls_with_warning(
- cls,
- constructor,
- warning_cls,
- message,
- warning_cls.deprecated_since,
- message,
- )
-
- return decorate
-
-
def deprecated(
version,
message=None,
@@ -142,14 +83,6 @@ def deprecated(
"""
- # nothing is deprecated "since" 2.0 at this time. All "removed in 2.0"
- # should emit the RemovedIn20Warning, but messaging should be expressed
- # in terms of "deprecated since 1.4".
-
- if version == "2.0":
- if warning is None:
- warning = exc.RemovedIn20Warning
- version = "1.4"
if add_deprecation_to_docstring:
header = ".. deprecated:: %s %s" % (
version,
@@ -164,8 +97,7 @@ def deprecated(
if warning is None:
warning = exc.SADeprecationWarning
- if warning is not exc.RemovedIn20Warning:
- message += " (deprecated since: %s)" % version
+ message += " (deprecated since: %s)" % version
def decorate(fn):
return _decorate_with_warning(
@@ -186,7 +118,7 @@ def moved_20(message, **kw):
)
-def deprecated_20(api_name, alternative=None, becomes_legacy=False, **kw):
+def became_legacy_20(api_name, alternative=None, **kw):
type_reg = re.match("^:(attr|func|meth):", api_name)
if type_reg:
type_ = {"attr": "attribute", "func": "function", "meth": "method"}[
@@ -200,9 +132,7 @@ def deprecated_20(api_name, alternative=None, becomes_legacy=False, **kw):
% (
api_name,
type_,
- "will be removed"
- if not becomes_legacy
- else "becomes a legacy construct",
+ "becomes a legacy construct",
)
)
@@ -219,10 +149,7 @@ def deprecated_20(api_name, alternative=None, becomes_legacy=False, **kw):
if alternative:
message += " " + alternative
- if becomes_legacy:
- warning_cls = exc.LegacyAPIWarning
- else:
- warning_cls = exc.RemovedIn20Warning
+ warning_cls = exc.LegacyAPIWarning
return deprecated("2.0", message=message, warning=warning_cls, **kw)
@@ -250,11 +177,7 @@ def deprecated_params(**specs):
for param, (version, message) in specs.items():
versions[param] = version
messages[param] = _sanitize_restructured_text(message)
- version_warnings[param] = (
- exc.RemovedIn20Warning
- if version == "2.0"
- else exc.SADeprecationWarning
- )
+ version_warnings[param] = exc.SADeprecationWarning
def decorate(fn):
spec = compat.inspect_getfullargspec(fn)