mirror of https://github.com/python/cpython
added code.py; codehack.py is obsolete
This commit is contained in:
parent
1c78cf3317
commit
61c270345c
|
@ -112,7 +112,7 @@ LIBFILES = lib.tex \
|
|||
libuser.tex libanydbm.tex librandom.tex libsite.tex libwhichdb.tex \
|
||||
libbase64.tex libfnmatch.tex libquopri.tex libzlib.tex libsocksvr.tex \
|
||||
libmailbox.tex libcommands.tex libcmath.tex libni.tex libgzip.tex \
|
||||
libpprint.tex
|
||||
libpprint.tex libcode.tex
|
||||
|
||||
# Library document
|
||||
lib.dvi: $(LIBFILES)
|
||||
|
|
|
@ -88,6 +88,7 @@ to Python and how to embed it in other applications.
|
|||
\input{libni}
|
||||
\input{libparser}
|
||||
\input{libpprint}
|
||||
\input{libcode}
|
||||
\input{libsite}
|
||||
\input{libbltin} % really __builtin__
|
||||
\input{libmain} % really __main__
|
||||
|
|
|
@ -88,6 +88,7 @@ to Python and how to embed it in other applications.
|
|||
\input{libni}
|
||||
\input{libparser}
|
||||
\input{libpprint}
|
||||
\input{libcode}
|
||||
\input{libsite}
|
||||
\input{libbltin} % really __builtin__
|
||||
\input{libmain} % really __main__
|
||||
|
|
|
@ -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}
|
|
@ -105,8 +105,6 @@ compileall.py -- force "compilation" of all .py files in a directory
|
|||
|
||||
py_compile.py -- "compile" a .py file to a .pyc file
|
||||
|
||||
codehack.py -- extract a function name from a code object
|
||||
|
||||
dis.py -- Disassembler for Python bytecode objects
|
||||
|
||||
repr.py -- Redo the `...` (representation) but with limits on most
|
||||
|
@ -183,6 +181,10 @@ fcntl.lockf/flock intead)
|
|||
tb.py -- Print tracebacks, with a dump of local variables (use
|
||||
pdb.pm() or traceback.py instead)
|
||||
|
||||
codehack.py -- extract function name or line number from a function
|
||||
code object (these are now accessible as attributes: co.co_name,
|
||||
func.func_name, co.co_firstlineno)
|
||||
|
||||
|
||||
\section{Extension modules}
|
||||
|
||||
|
|
|
@ -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}
|
|
@ -105,8 +105,6 @@ compileall.py -- force "compilation" of all .py files in a directory
|
|||
|
||||
py_compile.py -- "compile" a .py file to a .pyc file
|
||||
|
||||
codehack.py -- extract a function name from a code object
|
||||
|
||||
dis.py -- Disassembler for Python bytecode objects
|
||||
|
||||
repr.py -- Redo the `...` (representation) but with limits on most
|
||||
|
@ -183,6 +181,10 @@ fcntl.lockf/flock intead)
|
|||
tb.py -- Print tracebacks, with a dump of local variables (use
|
||||
pdb.pm() or traceback.py instead)
|
||||
|
||||
codehack.py -- extract function name or line number from a function
|
||||
code object (these are now accessible as attributes: co.co_name,
|
||||
func.func_name, co.co_firstlineno)
|
||||
|
||||
|
||||
\section{Extension modules}
|
||||
|
||||
|
|
Loading…
Reference in New Issue