mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-23 03:05:38 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 15

Merged changes from the 1.5.2p2 release.

Browse source 
(Very rough.)
This commit is contained in:
Fred Drake 2000-04-03 20:13:55 +00:00
parent 659ebfa79e
commit 38e5d27cae
59 changed files with 1248 additions and 516 deletions
Download patch file Download diff file Expand all files Collapse all files

30
Doc/lib/libcodeop.tex
View file

@ -1,13 +1,14 @@
% LaTeXed from excellent doc-string.
\section{\module{codeop} ---
Compile Python code}
% LaTeXed from excellent doc-string.
\declaremodule{standard}{codeop}
\sectionauthor{Moshe Zadka}{mzadka@geocities.com}
\modulesynopsis{Compile (possibly incomplete) Python code.}
The \module{codeop} module provides a function to compile Python code
with hints on whether it certainly complete, possible complete or
with hints on whether it is certainly complete, possibly complete or
definitely incomplete. This is used by the \refmodule{code} module
and should not normally be used directly.
@ -15,25 +16,22 @@ The \module{codeop} module defines the following function:
\begin{funcdesc}{compile_command}
{source\optional{, filename\optional{, symbol}}}
Try to compile \var{source}, which should be a string of Python
code. Return a code object if \var{source} is valid
Tries to compile \var{source}, which should be a string of Python
code and return a code object if \var{source} is valid
Python code. In that case, the filename attribute of the code object
will be \var{filename}, which defaults to \code{'<input>'}.
Return \code{None} if \var{source} is \emph{not} valid Python
Returns \code{None} if \var{source} is \emph{not} valid Python
code, but is a prefix of valid Python code.
Raise an exception if there is a problem with \var{source}:
\begin{itemize}
\item \exception{SyntaxError}
if there is invalid Python syntax.
\item \exception{OverflowError}
if there is an invalid numeric constant.
\end{itemize}
If there is a problem with \var{source}, an exception will be raised.
\exception{SyntaxError} is raised if there is invalid Python syntax,
and \exception{OverflowError} if there is an invalid numeric
constant.
The \var{symbol} argument means whether to compile it as a statement
(\code{'single'}, the default) or as an expression (\code{'eval'}).
The \var{symbol} argument determines whether \var{source} is compiled
as a statement (\code{'single'}, the default) or as an expression
(\code{'eval'}). Any other value will cause \exception{ValueError} to
be raised.
\strong{Caveat:}
It is possible (but not likely) that the parser stops parsing