diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 22412e1a2113bb..d7a389fa13d6a0 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -275,6 +275,10 @@ is the module's name in the Python package namespace. .. versionchanged:: 3.8 The *stacklevel* parameter was added. + .. versionchanged:: 3.13 + Remove the undocumented ``warn()`` method which was an alias to the + :meth:`warning` method. + .. method:: Logger.info(msg, *args, **kwargs) @@ -287,10 +291,6 @@ is the module's name in the Python package namespace. Logs a message with level :const:`WARNING` on this logger. The arguments are interpreted as for :meth:`debug`. - .. note:: There is an obsolete method ``warn`` which is functionally - identical to ``warning``. As ``warn`` is deprecated, please do not use - it - use ``warning`` instead. - .. method:: Logger.error(msg, *args, **kwargs) Logs a message with level :const:`ERROR` on this logger. The arguments are diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst index 35e6303c370e2f..1eb859f3a5af01 100644 --- a/Doc/whatsnew/3.13.rst +++ b/Doc/whatsnew/3.13.rst @@ -310,6 +310,12 @@ Removed use ``locale.setlocale(locale.LC_ALL, "")`` instead. (Contributed by Victor Stinner in :gh:`104783`.) +* Remove the undocumented and untested ``logging.Logger.warn()`` method, + deprecated since Python 3.3, which was an alias to the + :meth:`logging.Logger.warning` method: use the :meth:`logging.Logger.warning` + method instead. + (Contributed by Victor Stinner in :gh:`105376`.) + Porting to Python 3.13 ====================== diff --git a/Lib/logging/__init__.py b/Lib/logging/__init__.py index 056380fb2287af..ba2ed44b095071 100644 --- a/Lib/logging/__init__.py +++ b/Lib/logging/__init__.py @@ -1550,11 +1550,6 @@ def warning(self, msg, *args, **kwargs): if self.isEnabledFor(WARNING): self._log(WARNING, msg, args, **kwargs) - def warn(self, msg, *args, **kwargs): - warnings.warn("The 'warn' method is deprecated, " - "use 'warning' instead", DeprecationWarning, 2) - self.warning(msg, *args, **kwargs) - def error(self, msg, *args, **kwargs): """ Log 'msg % args' with severity 'ERROR'. diff --git a/Misc/NEWS.d/next/Library/2023-06-06-15-32-44.gh-issue-105376.W4oDQp.rst b/Misc/NEWS.d/next/Library/2023-06-06-15-32-44.gh-issue-105376.W4oDQp.rst new file mode 100644 index 00000000000000..a7d3172ca4c642 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2023-06-06-15-32-44.gh-issue-105376.W4oDQp.rst @@ -0,0 +1,4 @@ +Remove the undocumented and untested ``logging.Logger.warn()`` method, +deprecated since Python 3.3, which was an alias to the +:meth:`logging.Logger.warning` method: use the :meth:`logging.Logger.warning` +method instead. Patch by Victor Stinner.