1997-03-14 04:12:52 +00:00
|
|
|
\chapter{Undocumented Modules}
|
1998-02-18 15:47:17 +00:00
|
|
|
\label{undoc}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
Here's a quick listing of modules that are currently undocumented, but
|
|
|
|
that should be documented. Feel free to contribute documentation for
|
1999-02-24 19:57:14 +00:00
|
|
|
them! (The idea and original contents for this chapter were taken
|
|
|
|
from a posting by Fredrik Lundh; I have revised some modules' status.)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
|
1999-02-24 19:57:14 +00:00
|
|
|
\section{Frameworks}
|
|
|
|
|
|
|
|
Frameworks tend to be harder to document, but are well worth the
|
|
|
|
effort spent.
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[Tkinter.py]
|
|
|
|
--- Interface to Tcl/Tk for graphical user interfaces;
|
1999-04-16 18:26:22 +00:00
|
|
|
Fredrik Lundh is working on this one! See \emph{An Introduction to
|
1999-06-18 19:58:59 +00:00
|
|
|
Tkinter} at \url{http://www.pythonware.com/library/} for on-line
|
|
|
|
reference material.
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-14 04:55:43 +00:00
|
|
|
\item[Tkdnd.py]
|
|
|
|
--- Drag-and-drop support for \module{Tkinter}.
|
|
|
|
|
1998-08-11 18:13:31 +00:00
|
|
|
\item[test]
|
|
|
|
--- Regression testing framework. This is used for the Python
|
|
|
|
regression test, but is useful for other Python libraries as well.
|
|
|
|
This is a package rather than a module.
|
1998-04-07 14:15:28 +00:00
|
|
|
\end{description}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
\section{Miscellaneous useful utilities}
|
|
|
|
|
1999-06-23 14:56:13 +00:00
|
|
|
Some of these are very old and/or not very robust; marked with ``hmm.''
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[dircmp.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- class to build directory diff tools on (may become a demo or tool)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[pty.py]
|
|
|
|
--- Pseudo terminal utilities
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[bdb.py]
|
|
|
|
--- A generic Python debugger base class (used by pdb)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[ihooks.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- Import hook support (for \refmodule{rexec}; may become obsolete)
|
1998-04-07 14:15:28 +00:00
|
|
|
\end{description}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1997-08-15 02:52:46 +00:00
|
|
|
|
1997-03-14 04:12:52 +00:00
|
|
|
\section{Platform specific modules}
|
|
|
|
|
1999-06-18 19:58:59 +00:00
|
|
|
These modules are used to implement the \refmodule{os.path} module,
|
|
|
|
and are not documented beyond this mention. There's little need to
|
|
|
|
document these.
|
1999-02-02 18:59:58 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
1999-02-02 18:59:58 +00:00
|
|
|
\item[dospath.py]
|
|
|
|
--- implementation of \module{os.path} on MS-DOS
|
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[ntpath.py]
|
1999-02-02 18:59:58 +00:00
|
|
|
--- implementation on \module{os.path} on 32-bit Windows
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1999-02-02 18:59:58 +00:00
|
|
|
\item[posixpath.py]
|
|
|
|
--- implementation on \module{os.path} on \POSIX{}
|
1998-04-07 14:15:28 +00:00
|
|
|
\end{description}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
\section{Multimedia}
|
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[audiodev.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- Platform-independent API for playing audio data
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[sunaudio.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- interpret sun audio headers (may become obsolete or a tool/demo)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[toaiff.py]
|
1999-06-18 19:58:59 +00:00
|
|
|
--- Convert "arbitrary" sound files to AIFF files; should probably
|
1999-06-23 14:56:13 +00:00
|
|
|
become a tool or demo. Requires the external program \program{sox}.
|
1998-04-07 14:15:28 +00:00
|
|
|
\end{description}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
\section{Oddities}
|
|
|
|
|
|
|
|
These modules are probably also obsolete, or just not very useful.
|
1999-06-18 19:58:59 +00:00
|
|
|
Some of these may be made into tools or demos in future releases.
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[find.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- find files matching pattern in directory tree (may become a demo
|
|
|
|
or tool, or possibly obsolete)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[grep.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- grep (may become a demo or tool)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[mutex.py]
|
|
|
|
--- Mutual exclusion --- for use with module sched
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[packmail.py]
|
|
|
|
--- create a self-unpacking \UNIX{} shell archive
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[sched.py]
|
|
|
|
--- event scheduler class
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[tzparse.py]
|
|
|
|
--- Parse a timezone specification (unfinished)
|
|
|
|
\end{description}
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
\section{Obsolete}
|
|
|
|
|
1998-04-04 07:03:19 +00:00
|
|
|
These modules are not on the standard module search path;
|
|
|
|
\indexiii{module}{search}{path}
|
|
|
|
but are available in the directory \file{lib-old/} installed under
|
1998-08-07 16:02:28 +00:00
|
|
|
\file{\textrm{\$prefix}/lib/python1.5/}. % $ <-- bow to font lock
|
|
|
|
To use any of these modules, add that directory to \code{sys.path},
|
|
|
|
possibly using \envvar{PYTHONPATH}.
|
1997-07-16 15:48:20 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[newdir.py]
|
1999-06-23 14:56:13 +00:00
|
|
|
--- New \function{dir()} function (the standard \function{dir()} is
|
|
|
|
now just as good)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[addpack.py]
|
|
|
|
--- standard support for "packages"
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-11-02 15:46:21 +00:00
|
|
|
\item[codehack.py]
|
|
|
|
--- Extract function name or line number from a function
|
1999-06-23 14:56:13 +00:00
|
|
|
code object (these are now accessible as attributes:
|
|
|
|
\member{co.co_name}, \member{func.func_name},
|
|
|
|
\member{co.co_firstlineno}).
|
1998-11-02 15:46:21 +00:00
|
|
|
|
1999-06-18 17:12:15 +00:00
|
|
|
\item[dump.py]
|
|
|
|
--- Print python code that reconstructs a variable
|
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[fmt.py]
|
|
|
|
--- text formatting abstractions (too slow)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[Para.py]
|
|
|
|
--- helper for fmt.py
|
1998-04-04 07:03:19 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[lockfile.py]
|
|
|
|
--- wrapper around FCNTL file locking (use
|
1999-06-23 14:56:13 +00:00
|
|
|
\function{fcntl.lockf()}/\function{flock()} intead; see \refmodule{fcntl})
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-11-02 15:46:21 +00:00
|
|
|
\item[poly.py]
|
|
|
|
--- Polynomials
|
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[tb.py]
|
|
|
|
--- Print tracebacks, with a dump of local variables (use
|
1999-01-13 17:11:52 +00:00
|
|
|
\function{pdb.pm()} or \refmodule{traceback} instead)
|
1997-03-14 04:12:52 +00:00
|
|
|
|
1998-08-07 16:02:28 +00:00
|
|
|
\item[timingmodule]
|
|
|
|
--- Measure time intervals to high resolution (use
|
|
|
|
\function{time.clock()} instead). (This is an extension module.)
|
1998-11-02 15:46:21 +00:00
|
|
|
|
1999-06-10 21:17:11 +00:00
|
|
|
\item[util.py]
|
|
|
|
--- Useful functions that don't fit elsewhere.
|
|
|
|
|
1999-06-18 19:58:59 +00:00
|
|
|
\item[wdb.py]
|
|
|
|
--- A primitive windowing debugger based on STDWIN.
|
|
|
|
|
1999-01-05 23:09:12 +00:00
|
|
|
\item[whatsound.py]
|
1999-01-13 17:11:52 +00:00
|
|
|
--- Recognize sound files; use \refmodule{sndhdr} instead.
|
1999-01-05 23:09:12 +00:00
|
|
|
|
1998-11-02 15:46:21 +00:00
|
|
|
\item[zmod.py]
|
|
|
|
--- Compute properties of mathematical "fields"
|
1998-04-07 14:15:28 +00:00
|
|
|
\end{description}
|
1997-07-18 21:08:07 +00:00
|
|
|
|
1998-04-09 14:32:28 +00:00
|
|
|
The following modules were documented in previous versions of this
|
1999-06-23 14:56:13 +00:00
|
|
|
manual, but are now considered obsolete. The source for the
|
|
|
|
documentation is still available as part of the documentation source
|
|
|
|
archive.
|
1998-04-09 14:32:28 +00:00
|
|
|
|
|
|
|
\begin{description}
|
|
|
|
\item[ni]
|
1998-08-07 16:02:28 +00:00
|
|
|
--- Import modules in ``packages.'' Basic package support is now
|
|
|
|
built in.
|
1998-04-09 14:32:28 +00:00
|
|
|
|
|
|
|
\item[rand]
|
|
|
|
--- Old interface to the random number generator.
|
|
|
|
|
|
|
|
\item[soundex]
|
|
|
|
--- Algorithm for collapsing names which sound similar to a shared
|
|
|
|
key. (This is an extension module.)
|
|
|
|
\end{description}
|
|
|
|
|
1997-03-14 04:12:52 +00:00
|
|
|
|
|
|
|
\section{Extension modules}
|
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\begin{description}
|
|
|
|
\item[dlmodule.c]
|
|
|
|
--- A highly experimental and dangerous device for calling
|
1998-08-07 16:02:28 +00:00
|
|
|
arbitrary \C{} functions in arbitrary shared libraries.
|
1997-03-27 20:57:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[nismodule.c]
|
|
|
|
--- NIS (a.k.a. Sun's Yellow Pages) interface.
|
1997-03-27 20:57:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[stdwinmodule.c]
|
|
|
|
--- Interface to STDWIN (an old, unsupported
|
1997-06-02 17:34:02 +00:00
|
|
|
platform-independent GUI package). Obsolete; use Tkinter for a
|
|
|
|
platform-independent GUI instead.
|
1998-08-07 16:02:28 +00:00
|
|
|
\end{description}
|
1997-06-02 17:34:02 +00:00
|
|
|
|
1999-06-23 14:56:13 +00:00
|
|
|
The following are SGI specific, and may be out of touch with the
|
|
|
|
current version of reality.
|
1997-03-27 20:57:52 +00:00
|
|
|
|
1998-08-07 16:02:28 +00:00
|
|
|
\begin{description}
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[clmodule.c]
|
|
|
|
--- Interface to the SGI compression library.
|
1997-03-27 20:57:52 +00:00
|
|
|
|
1998-04-07 14:15:28 +00:00
|
|
|
\item[svmodule.c]
|
|
|
|
--- Interface to the ``simple video'' board on SGI Indigo
|
1997-03-27 20:57:52 +00:00
|
|
|
(obsolete hardware).
|
1998-08-07 16:02:28 +00:00
|
|
|
\end{description}
|