summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBatuhan Taskaya <batuhanosmantaskaya@gmail.com>2020-05-31 22:01:50 (GMT)
committerGitHub <noreply@github.com>2020-05-31 22:01:50 (GMT)
commitcf88871d6a9c12e7b7e5f4d65abc2ec6e2fe952e (patch)
tree9937063a3701e7287a1c879e470c28064ca5ac24
parentb7d79b4f36787874128c439d38397fe95c48429b (diff)
downloadcpython-cf88871d6a9c12e7b7e5f4d65abc2ec6e2fe952e.zip
cpython-cf88871d6a9c12e7b7e5f4d65abc2ec6e2fe952e.tar.gz
cpython-cf88871d6a9c12e7b7e5f4d65abc2ec6e2fe952e.tar.bz2
bpo-40759: Deprecate the symbol module (GH-20364)
Automerge-Triggered-By: @pablogsal
-rw-r--r--Doc/library/symbol.rst5
-rw-r--r--Doc/whatsnew/3.9.rst7
-rw-r--r--Lib/symbol.py9
-rw-r--r--Misc/NEWS.d/next/Library/2020-05-24-23-52-35.bpo-40759.DdZdaw.rst1
4 files changed, 19 insertions, 3 deletions
diff --git a/Doc/library/symbol.rst b/Doc/library/symbol.rst
index 4499693..d56600a 100644
--- a/Doc/library/symbol.rst
+++ b/Doc/library/symbol.rst
@@ -17,6 +17,11 @@ the definitions of the names in the context of the language grammar. The
specific numeric values which the names map to may change between Python
versions.
+.. warning::
+
+ The symbol module is deprecated and will be removed in future versions of
+ Python.
+
This module also provides one additional data object:
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index 7f81074..6ace7a4 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -692,9 +692,10 @@ Deprecated
Python versions it will raise a :exc:`TypeError` for all floats.
(Contributed by Serhiy Storchaka in :issue:`37315`.)
-* The :mod:`parser` module is deprecated and will be removed in future versions
- of Python. For the majority of use cases, users can leverage the Abstract Syntax
- Tree (AST) generation and compilation stage, using the :mod:`ast` module.
+* The :mod:`parser` and :mod:`symbol` modules are deprecated and will be
+ removed in future versions of Python. For the majority of use cases,
+ users can leverage the Abstract Syntax Tree (AST) generation and compilation
+ stage, using the :mod:`ast` module.
* Using :data:`NotImplemented` in a boolean context has been deprecated,
as it is almost exclusively the result of incorrect rich comparator
diff --git a/Lib/symbol.py b/Lib/symbol.py
index 36e0eec..aaac8c9 100644
--- a/Lib/symbol.py
+++ b/Lib/symbol.py
@@ -11,6 +11,15 @@
#
# make regen-symbol
+import warnings
+
+warnings.warn(
+ "The symbol module is deprecated and will be removed "
+ "in future versions of Python",
+ DeprecationWarning,
+ stacklevel=2,
+)
+
#--start constants--
single_input = 256
file_input = 257
diff --git a/Misc/NEWS.d/next/Library/2020-05-24-23-52-35.bpo-40759.DdZdaw.rst b/Misc/NEWS.d/next/Library/2020-05-24-23-52-35.bpo-40759.DdZdaw.rst
new file mode 100644
index 0000000..e77da3a
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2020-05-24-23-52-35.bpo-40759.DdZdaw.rst
@@ -0,0 +1 @@
+Deprecate the :mod:`symbol` module.