.. include:: pending-removal-in-3.19.rst
+.. include:: pending-removal-in-3.20.rst
+
.. include:: pending-removal-in-future.rst
C API deprecations
--- /dev/null
+Pending removal in Python 3.20
+------------------------------
+
+* The ``__version__`` attribute has been deprecated in these standard library
+ modules and will be removed in Python 3.20.
+ Use :py:data:`sys.version_info` instead.
+
+ - :mod:`argparse`
+ - :mod:`csv`
+ - :mod:`!ctypes.macholib`
+ - :mod:`ipaddress`
+ - :mod:`json`
+ - :mod:`logging` (``__date__`` also deprecated)
+ - :mod:`optparse`
+ - :mod:`pickle`
+ - :mod:`platform`
+ - :mod:`re`
+ - :mod:`socketserver`
+ - :mod:`tabnanny`
+ - :mod:`tkinter.font`
+ - :mod:`tkinter.ttk`
+
+ (Contributed by Hugo van Kemenade in :gh:`76007`.)
.. include:: ../deprecations/pending-removal-in-3.17.rst
+.. include:: ../deprecations/pending-removal-in-3.19.rst
+
+.. include:: ../deprecations/pending-removal-in-3.20.rst
+
.. include:: ../deprecations/pending-removal-in-future.rst
.. _whatsnew312-removed:
.. include:: ../deprecations/pending-removal-in-3.17.rst
+.. include:: ../deprecations/pending-removal-in-3.19.rst
+
+.. include:: ../deprecations/pending-removal-in-3.20.rst
+
.. include:: ../deprecations/pending-removal-in-future.rst
CPython Bytecode Changes
.. include:: ../deprecations/pending-removal-in-3.19.rst
+.. include:: ../deprecations/pending-removal-in-3.20.rst
+
.. include:: ../deprecations/pending-removal-in-future.rst
(Contributed by Bénédikt Tran in :gh:`134978`.)
+__version__
+-----------
+
+* The ``__version__`` attribute has been deprecated in these standard library
+ modules and will be removed in Python 3.20.
+ Use :py:data:`sys.version_info` instead.
+
+ - :mod:`argparse`
+ - :mod:`csv`
+ - :mod:`!ctypes.macholib`
+ - :mod:`ipaddress`
+ - :mod:`json`
+ - :mod:`logging` (``__date__`` also deprecated)
+ - :mod:`optparse`
+ - :mod:`pickle`
+ - :mod:`platform`
+ - :mod:`re`
+ - :mod:`socketserver`
+ - :mod:`tabnanny`
+ - :mod:`tkinter.font`
+ - :mod:`tkinter.ttk`
+
+ (Contributed by Hugo van Kemenade in :gh:`76007`.)
.. Add deprecations above alphabetically, not here at the end.
+.. include:: ../deprecations/pending-removal-in-3.16.rst
+
+.. include:: ../deprecations/pending-removal-in-3.17.rst
+
+.. include:: ../deprecations/pending-removal-in-3.19.rst
+
+.. include:: ../deprecations/pending-removal-in-3.20.rst
+
+.. include:: ../deprecations/pending-removal-in-future.rst
+
Removed
=======
still considered an implementation detail.)
"""
-__version__ = '1.1'
__all__ = [
'ArgumentParser',
'ArgumentError',
def _warning(self, message):
args = {'prog': self.prog, 'message': message}
self._print_message(_('%(prog)s: warning: %(message)s\n') % args, _sys.stderr)
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.1" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
"unregister_dialect", "DictReader", "DictWriter",
"unix_dialect"]
-__version__ = "1.0"
-
class Dialect:
"""Describe a CSV dialect.
hasHeader -= 1
return hasHeader > 0
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.0" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
And also Apple's documentation.
"""
-__version__ = '1.0'
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.0" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
"""
-__version__ = '1.0'
-
-
import functools
IPV4LENGTH = 32
IPv6Address._constants = _IPv6Constants
IPv6Network._constants = _IPv6Constants
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.0" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
$ echo '{ 1.2:3.4}' | python -m json
Expecting property name enclosed in double quotes: line 1 column 3 (char 2)
"""
-__version__ = '2.0.9'
__all__ = [
'dump', 'dumps', 'load', 'loads',
'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
if parse_constant is not None:
kw['parse_constant'] = parse_constant
return cls(**kw).decode(s)
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "2.0.9" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
__author__ = "Vinay Sajip <vinay_sajip@red-dove.com>"
__status__ = "production"
-# The following module attributes are no longer updated.
-__version__ = "0.5.1.2"
-__date__ = "07 February 2010"
#---------------------------------------------------------------------------
# Miscellaneous module data
if _warnings_showwarning is not None:
warnings.showwarning = _warnings_showwarning
_warnings_showwarning = None
+
+
+def __getattr__(name):
+ if name in ("__version__", "__date__"):
+ from warnings import _deprecated
+
+ _deprecated(name, remove=(3, 20))
+ return { # Do not change
+ "__version__": "0.5.1.2",
+ "__date__": "07 February 2010",
+ }[name]
+
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
(options, args) = parser.parse_args()
"""
-__version__ = "1.5.3"
-
__all__ = ['Option',
'make_option',
'SUPPRESS_HELP',
# which will become a factory function when there are many Option
# classes.
make_option = Option
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.5.3" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
Misc variables:
- __version__
format_version
compatible_formats
"""
-__version__ = '1.1.0'
-
import collections
import os
import re
print(platform(aliased, terse))
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "1.1.0" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
if __name__ == "__main__":
_main()
"UNICODE", "NOFLAG", "RegexFlag", "PatternError"
]
-__version__ = "2.2.1"
-
@enum.global_enum
@enum._simple_enum(enum.IntFlag, boundary=enum.KEEP)
class RegexFlag:
append(action)
i = j
return result, string[i:]
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "2.2.1" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
# Author of the BaseServer patch: Luke Kenneth Casson Leighton
-__version__ = "0.4"
-
-
import socket
import selectors
import os
def finish(self):
self.socket.sendto(self.wfile.getvalue(), self.client_address)
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "0.4" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
# XXX The API needs to undergo changes however; the current code is too
# XXX script-like. This will be addressed later.
-__version__ = "6"
-
import os
import sys
import tokenize
raise NannyNag(start[0], msg, line)
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "6" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
if __name__ == '__main__':
main()
'''))
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(argparse, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
def tearDownModule():
# Remove global references to avoid looking like we have refleaks.
RFile.seen = {}
with self.subTest(tp=tp):
check_disallow_instantiation(self, tp)
+
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(csv, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == '__main__':
unittest.main()
d('P', 'F.framework/Versions/A/F_debug', 'F', 'A', 'debug'))
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ import ctypes.macholib
+
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(ctypes.macholib, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == "__main__":
unittest.main()
)
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(ipaddress, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == '__main__':
unittest.main()
'_json')
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(json, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
def load_tests(loader, _, pattern):
suite = unittest.TestSuite()
for mod in (json, json.encoder, json.decoder):
support.check__all__(self, logging, not_exported=not_exported)
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__and__date__(self):
+ msg = "is deprecated and slated for removal in Python 3.20"
+ for attr in ("__version__", "__date__"):
+ with self.subTest(attr=attr):
+ with self.assertWarnsRegex(DeprecationWarning, msg) as cm:
+ getattr(logging, attr)
+ self.assertEqual(cm.filename, __file__)
+
+
# Set the locale to the platform-dependent default. I have no idea
# why the test does this, but in any case we save the current locale
# first and restore it at the end.
self.assertMsgidsEqual(optparse)
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(optparse, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == '__main__':
# To regenerate translation snapshots
if len(sys.argv) > 1 and sys.argv[1] == '--snapshot-update':
self.assertTrue(obj.search(s))
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(re, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == "__main__":
unittest.main()
server.server_close()
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(socketserver, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == "__main__":
unittest.main()
Glossary:
* errored : Whitespace related problems present in file.
"""
-from unittest import TestCase, mock
+
+from unittest import TestCase, main, mock
import errno
import os
import tabnanny
"offending line: '\\tprint(\"world\")'"
).strip()
self.validate_cmd("-vv", path, stdout=stdout, partial=True)
+
+
+class TestModule(TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(tabnanny, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
+if __name__ == "__main__":
+ main()
self.assertRaises(RuntimeError, font.nametofont, fontname)
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(font, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
if __name__ == "__main__":
unittest.main()
from tkinter import ttk
+class TestModule(unittest.TestCase):
+ def test_deprecated__version__(self):
+ with self.assertWarnsRegex(
+ DeprecationWarning,
+ "'__version__' is deprecated and slated for removal in Python 3.20",
+ ) as cm:
+ getattr(ttk, "__version__")
+ self.assertEqual(cm.filename, __file__)
+
+
def setUpModule():
root = None
try:
import itertools
import tkinter
-__version__ = "0.9"
__all__ = ["NORMAL", "ROMAN", "BOLD", "ITALIC",
"nametofont", "Font", "families", "names"]
return root.tk.splitlist(root.tk.call("font", "names"))
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "0.9" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
# --------------------------------------------------------------------
# test stuff
of the widgets appearance lies at Themes.
"""
-__version__ = "0.3.1"
-
__author__ = "Guilherme Polo <ggpolo@gmail.com>"
__all__ = ["Button", "Checkbutton", "Combobox", "Entry", "Frame", "Label",
except AttributeError:
pass
super().destroy()
+
+
+def __getattr__(name):
+ if name == "__version__":
+ from warnings import _deprecated
+
+ _deprecated("__version__", remove=(3, 20))
+ return "0.3.1" # Do not change
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
--- /dev/null
+Deprecate ``__version__`` from a number of standard library modules. Patch
+by Hugo van Kemenade.
"checksums": [
{
"algorithm": "SHA1",
- "checksumValue": "0fbc026a9771d9675e7094790b5b945334d3cb53"
+ "checksumValue": "0d83ed429ede0a2c6617cd2f24490be16d8393f4"
},
{
"algorithm": "SHA256",
- "checksumValue": "1e77c01eec8f167ed10b754f153c0c743c8e5196ae9c81dffc08f129ab56dbfd"
+ "checksumValue": "876f4486d08d3eac3581a8681d7fb3cec2fe5b823d1bef27cca15e755510365c"
}
],
"fileName": "Lib/ctypes/macholib/__init__.py"
projects / thirdparty / Python / cpython.git / commitdiff
