mirror of
https://github.com/python/cpython.git
synced 2025-10-30 05:01:30 +00:00
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>
This commit is contained in:
parent
4b972faf60
commit
7ba1f75f3f
3 changed files with 7 additions and 5 deletions
|
|
@ -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* is the source string; *filename* is the optional filename from which
|
||||||
source was read, defaulting to ``'<input>'``; and *symbol* is the optional
|
source was read, defaulting to ``'<input>'``; and *symbol* is the optional
|
||||||
grammar start symbol, which should be either ``'single'`` (the default) or
|
grammar start symbol, which should be ``'single'`` (the default), ``'eval'``
|
||||||
``'eval'``.
|
or ``'exec'``.
|
||||||
|
|
||||||
Returns a code object (the same as ``compile(source, filename, symbol)``) if the
|
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
|
command is complete and valid; ``None`` if the command is incomplete; raises
|
||||||
|
|
|
||||||
|
|
@ -43,8 +43,9 @@ To do just the former:
|
||||||
:exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal.
|
:exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal.
|
||||||
|
|
||||||
The *symbol* argument determines whether *source* is compiled as a statement
|
The *symbol* argument determines whether *source* is compiled as a statement
|
||||||
(``'single'``, the default) or as an :term:`expression` (``'eval'``). Any
|
(``'single'``, the default), as a sequence of statements (``'exec'``) or
|
||||||
other value will cause :exc:`ValueError` to be raised.
|
as an :term:`expression` (``'eval'``). Any other value will
|
||||||
|
cause :exc:`ValueError` to be raised.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -112,7 +112,8 @@ def compile_command(source, filename="<input>", symbol="single"):
|
||||||
source -- the source string; may contain \n characters
|
source -- the source string; may contain \n characters
|
||||||
filename -- optional filename from which source was read; default
|
filename -- optional filename from which source was read; default
|
||||||
"<input>"
|
"<input>"
|
||||||
symbol -- optional grammar start symbol; "single" (default) or "eval"
|
symbol -- optional grammar start symbol; "single" (default), "exec"
|
||||||
|
or "eval"
|
||||||
|
|
||||||
Return value / exceptions raised:
|
Return value / exceptions raised:
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue