Mercurial > cpython-lru_cache-weakref
diff Doc/lib/libcode.tex @ 5842:35b14d78c61d legacy-trunk
added code.py; codehack.py is obsolete
| author | Guido van Rossum <guido@python.org> |
|---|---|
| date | Fri, 18 Jul 1997 21:08:07 +0000 |
| parents | |
| children | e70c4af157d5 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Doc/lib/libcode.tex Fri Jul 18 21:08:07 1997 +0000 @@ -0,0 +1,35 @@ +% Template for a library manual section. + +\section{Standard module \sectcode{code}} +\label{module-code} +\stmodindex{code} + +The \code{code} module defines operations pertaining to Python code +objects. + +The \code{code} module defines the following functions: + +\renewcommand{\indexsubitem}{(in module code)} + +\begin{funcdesc}{compile_command}{source\, +\optional{filename\optional{\, symbol}}} +This function is useful for programs that want to emulate Python's +interpreter main loop (a.k.a. the read-eval-print loop). The tricky +part is to determine when the user has entered an incomplete command +that can be completed by entering more text (as opposed to a complete +command or a syntax error). This function \emph{almost} always makes +the same decision as the real interpreter main loop. + +Arguments: \var{source} is the source string; \var{filename} is the +optional filename from which source was read, defaulting to +\code{"<input>"}; and \var{symbol} is the optional grammar start +symbol, which should be either \code{"single"} (the default) or +\code{"eval"}. + +Return a code object (the same as \code{compile(\var{source}, +\var{filename}, \var{symbol})}) if the command is complete and valid; +return \code{None} if the command is incomplete; raise +\code{SyntaxError} if the command is a syntax error. + + +\end{funcdesc}
