.. _undoc: ******************** Undocumented Modules ******************** Here's a quick listing of modules that are currently undocumented, but that should be documented. Feel free to contribute documentation for them! (Send via email to docs@python.org.) The idea and original contents for this chapter were taken from a posting by Fredrik Lundh; the specific contents of this chapter have been substantially revised. Miscellaneous useful utilities ============================== Some of these are very old and/or not very robust; marked with "hmm." :mod:`ihooks` --- Import hook support (for :mod:`rexec`; may become obsolete). .. warning:: The :mod:`ihooks` module has been removed in Python 3.0. Platform specific modules ========================= These modules are used to implement the :mod:`os.path` module, and are not documented beyond this mention. There's little need to document these. :mod:`ntpath` --- Implementation of :mod:`os.path` on Win32, Win64, WinCE, and OS/2 platforms. :mod:`posixpath` --- Implementation of :mod:`os.path` on POSIX. :mod:`bsddb185` --- Backwards compatibility module for systems which still use the Berkeley DB 1.85 module. It is normally only available on certain BSD Unix-based systems. It should never be used directly. Multimedia ========== :mod:`audiodev` --- Platform-independent API for playing audio data. .. warning:: The :mod:`audiodev` module has been removed in 3.0. :mod:`linuxaudiodev` --- Play audio data on the Linux audio device. Replaced in Python 2.3 by the :mod:`ossaudiodev` module. .. warning:: The :mod:`linuxaudiodev` module has been removed in Python 3.0. :mod:`sunaudio` --- Interpret Sun audio headers (may become obsolete or a tool/demo). :mod:`toaiff` --- Convert "arbitrary" sound files to AIFF files; should probably become a tool or demo. Requires the external program :program:`sox`. .. warning:: The :mod:`toaiff` module has been removed in 3.0. .. _undoc-mac-modules: Undocumented Mac OS modules =========================== :mod:`applesingle` --- AppleSingle decoder ------------------------------------------ .. module:: applesingle :platform: Mac :synopsis: Rudimentary decoder for AppleSingle format files. :mod:`buildtools` --- Helper module for BuildApplet and Friends --------------------------------------------------------------- .. module:: buildtools :platform: Mac :synopsis: Helper module for BuildApplet, BuildApplication and macfreeze. .. deprecated:: 2.4 :mod:`cfmfile` --- Code Fragment Resource module ------------------------------------------------ .. module:: cfmfile :platform: Mac :synopsis: Code Fragment Resource module. :mod:`cfmfile` is a module that understands Code Fragments and the accompanying "cfrg" resources. It can parse them and merge them, and is used by BuildApplication to combine all plugin modules to a single executable. .. deprecated:: 2.4 :mod:`icopen` --- Internet Config replacement for :meth:`open` -------------------------------------------------------------- .. module:: icopen :platform: Mac :synopsis: Internet Config replacement for open(). Importing :mod:`icopen` will replace the builtin :meth:`open` with a version that uses Internet Config to set file type and creator for new files. :mod:`macerrors` --- Mac OS Errors ---------------------------------- .. module:: macerrors :platform: Mac :synopsis: Constant definitions for many Mac OS error codes. :mod:`macerrors` contains constant definitions for many Mac OS error codes. :mod:`macresource` --- Locate script resources ---------------------------------------------- .. module:: macresource :platform: Mac :synopsis: Locate script resources. :mod:`macresource` helps scripts finding their resources, such as dialogs and menus, without requiring special case code for when the script is run under MacPython, as a MacPython applet or under OSX Python. :mod:`Nav` --- NavServices calls -------------------------------- .. module:: Nav :platform: Mac :synopsis: Interface to Navigation Services. A low-level interface to Navigation Services. :mod:`PixMapWrapper` --- Wrapper for PixMap objects --------------------------------------------------- .. module:: PixMapWrapper :platform: Mac :synopsis: Wrapper for PixMap objects. .. note:: The :mod:`PixMapWrapper` module has been renamed to `pixmapwrapper` in Python 3.0. :mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows access to the fields by name. It also has methods to convert to and from :mod:`PIL` images. :mod:`videoreader` --- Read QuickTime movies -------------------------------------------- .. module:: videoreader :platform: Mac :synopsis: Read QuickTime movies frame by frame for further processing. :mod:`videoreader` reads and decodes QuickTime movies and passes a stream of images to your program. It also provides some support for audio tracks. :mod:`W` --- Widgets built on :mod:`FrameWork` ---------------------------------------------- .. module:: W :platform: Mac :synopsis: Widgets for the Mac, built on top of FrameWork. The :mod:`W` widgets are used extensively in the :program:`IDE`. .. _obsolete-modules: Obsolete ======== These modules are not normally available for import; additional work must be done to make them available. These extension modules written in C are not built by default. Under Unix, these must be enabled by uncommenting the appropriate lines in :file:`Modules/Setup` in the build tree and either rebuilding Python if the modules are statically linked, or building and installing the shared object if using dynamically-loaded extensions. .. (lib-old is empty as of Python 2.5) Those which are written in Python will be installed into the directory \file{lib-old/} installed as part of the standard library. To use these, the directory must be added to \code{sys.path}, possibly using \envvar{PYTHONPATH}. :mod:`timing` --- Measure time intervals to high resolution (use :func:`time.clock` instead). SGI-specific Extension modules ============================== The following are SGI specific, and may be out of touch with the current version of reality. :mod:`cl` --- Interface to the SGI compression library. :mod:`sv` --- Interface to the "simple video" board on SGI Indigo (obsolete hardware).