diff options
| author | Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> | 2020-05-14 21:59:46 -0300 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-05-14 21:59:46 -0300 |
| commit | 7ba1f75f3f02b4b50ac6d7e17d15e467afa36aac (patch) | |
| tree | 539bc15676c05fa62b4f68e208af44e7cc3b828d | |
| parent | 4b972faf605912092013a1fdbf486c498d002926 (diff) | |
| download | cpython-git-7ba1f75f3f02b4b50ac6d7e17d15e467afa36aac.tar.gz | |
bpo-38872: Document exec symbol for codeop.compile_command (GH-20047)
* Document exec symbol for codeop.compile_command
* Remove extra statements
Co-authored-by: nanjekyejoannah <joannah.nanjekye@ibm.com>
| -rw-r--r-- | Doc/library/code.rst | 4 | ||||
| -rw-r--r-- | Doc/library/codeop.rst | 5 | ||||
| -rw-r--r-- | Lib/codeop.py | 3 |
3 files changed, 7 insertions, 5 deletions
diff --git a/Doc/library/code.rst b/Doc/library/code.rst index 6708079f77..538e5afc78 100644 --- a/Doc/library/code.rst +++ b/Doc/library/code.rst @@ -56,8 +56,8 @@ build applications which provide an interactive interpreter prompt. *source* is the source string; *filename* is the optional filename from which source was read, defaulting to ``'<input>'``; and *symbol* is the optional - grammar start symbol, which should be either ``'single'`` (the default) or - ``'eval'``. + grammar start symbol, which should be ``'single'`` (the default), ``'eval'`` + or ``'exec'``. Returns a code object (the same as ``compile(source, filename, symbol)``) if the command is complete and valid; ``None`` if the command is incomplete; raises diff --git a/Doc/library/codeop.rst b/Doc/library/codeop.rst index a52d2c62c4..c66b9d3ec0 100644 --- a/Doc/library/codeop.rst +++ b/Doc/library/codeop.rst @@ -43,8 +43,9 @@ To do just the former: :exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal. The *symbol* argument determines whether *source* is compiled as a statement - (``'single'``, the default) or as an :term:`expression` (``'eval'``). Any - other value will cause :exc:`ValueError` to be raised. + (``'single'``, the default), as a sequence of statements (``'exec'``) or + as an :term:`expression` (``'eval'``). Any other value will + cause :exc:`ValueError` to be raised. .. note:: diff --git a/Lib/codeop.py b/Lib/codeop.py index 082285f94f..835e68c09b 100644 --- a/Lib/codeop.py +++ b/Lib/codeop.py @@ -112,7 +112,8 @@ def compile_command(source, filename="<input>", symbol="single"): source -- the source string; may contain \n characters filename -- optional filename from which source was read; default "<input>" - symbol -- optional grammar start symbol; "single" (default) or "eval" + symbol -- optional grammar start symbol; "single" (default), "exec" + or "eval" Return value / exceptions raised: |