Commit 29a0b57e authored by Éric Araujo's avatar Éric Araujo

Backport source links from 3.x.

Existing links have been updated to use the new reST role.  In some
files, I have also made cosmetic changes to the header.
parent d478a46d
...@@ -4,6 +4,9 @@ ...@@ -4,6 +4,9 @@
.. module:: __future__ .. module:: __future__
:synopsis: Future statement definitions :synopsis: Future statement definitions
**Source code:** :source:`Lib/__future__.py`
--------------
:mod:`__future__` is a real module, and serves three purposes: :mod:`__future__` is a real module, and serves three purposes:
......
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
.. versionadded:: 2.6 .. versionadded:: 2.6
**Source code:** :source:`Lib/abc.py`
--------------
This module provides the infrastructure for defining :term:`abstract base This module provides the infrastructure for defining :term:`abstract base
classes <abstract base class>` (ABCs) in Python, as outlined in :pep:`3119`; see the PEP for why this classes <abstract base class>` (ABCs) in Python, as outlined in :pep:`3119`; see the PEP for why this
was added to Python. (See also :pep:`3141` and the :mod:`numbers` module was added to Python. (See also :pep:`3141` and the :mod:`numbers` module
......
...@@ -10,6 +10,10 @@ ...@@ -10,6 +10,10 @@
single: AIFF single: AIFF
single: AIFF-C single: AIFF-C
**Source code:** :source:`Lib/aifc.py`
--------------
This module provides support for reading and writing AIFF and AIFF-C files. This module provides support for reading and writing AIFF and AIFF-C files.
AIFF is Audio Interchange File Format, a format for storing digital audio AIFF is Audio Interchange File Format, a format for storing digital audio
samples in a file. AIFF-C is a newer version of the format that includes the samples in a file. AIFF-C is a newer version of the format that includes the
......
...@@ -4,9 +4,13 @@ ...@@ -4,9 +4,13 @@
.. module:: argparse .. module:: argparse
:synopsis: Command-line option and argument parsing library. :synopsis: Command-line option and argument parsing library.
.. moduleauthor:: Steven Bethard <steven.bethard@gmail.com> .. moduleauthor:: Steven Bethard <steven.bethard@gmail.com>
.. versionadded:: 2.7
.. sectionauthor:: Steven Bethard <steven.bethard@gmail.com> .. sectionauthor:: Steven Bethard <steven.bethard@gmail.com>
.. versionadded:: 2.7
**Source code:** :source:`Lib/argparse.py`
--------------
The :mod:`argparse` module makes it easy to write user-friendly command-line The :mod:`argparse` module makes it easy to write user-friendly command-line
interfaces. The program defines what arguments it requires, and :mod:`argparse` interfaces. The program defines what arguments it requires, and :mod:`argparse`
......
...@@ -13,6 +13,9 @@ ...@@ -13,6 +13,9 @@
.. versionadded:: 2.6 .. versionadded:: 2.6
The high-level ``ast`` module containing all helpers. The high-level ``ast`` module containing all helpers.
**Source code:** :source:`Lib/ast.py`
--------------
The :mod:`ast` module helps Python applications to process trees of the Python The :mod:`ast` module helps Python applications to process trees of the Python
abstract syntax grammar. The abstract syntax itself might change with each abstract syntax grammar. The abstract syntax itself might change with each
...@@ -26,11 +29,6 @@ classes all inherit from :class:`ast.AST`. An abstract syntax tree can be ...@@ -26,11 +29,6 @@ classes all inherit from :class:`ast.AST`. An abstract syntax tree can be
compiled into a Python code object using the built-in :func:`compile` function. compiled into a Python code object using the built-in :func:`compile` function.
.. seealso::
Latest version of the `ast module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/ast.py?view=markup>`_
Node classes Node classes
------------ ------------
......
:mod:`asynchat` --- Asynchronous socket command/response handler :mod:`asynchat` --- Asynchronous socket command/response handler
================================================================ ================================================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
.. moduleauthor:: Sam Rushing <rushing@nightmare.com> .. moduleauthor:: Sam Rushing <rushing@nightmare.com>
.. sectionauthor:: Steve Holden <sholden@holdenweb.com> .. sectionauthor:: Steve Holden <sholden@holdenweb.com>
**Source code:** :source:`Lib/asynchat.py`
--------------
This module builds on the :mod:`asyncore` infrastructure, simplifying This module builds on the :mod:`asyncore` infrastructure, simplifying
asynchronous clients and servers and making it easier to handle protocols asynchronous clients and servers and making it easier to handle protocols
......
:mod:`asyncore` --- Asynchronous socket handler :mod:`asyncore` --- Asynchronous socket handler
=============================================== ===============================================
...@@ -10,6 +9,9 @@ ...@@ -10,6 +9,9 @@
.. sectionauthor:: Steve Holden <sholden@holdenweb.com> .. sectionauthor:: Steve Holden <sholden@holdenweb.com>
.. heavily adapted from original documentation by Sam Rushing .. heavily adapted from original documentation by Sam Rushing
**Source code:** :source:`Lib/asyncore.py`
--------------
This module provides the basic infrastructure for writing asynchronous socket This module provides the basic infrastructure for writing asynchronous socket
service clients and servers. service clients and servers.
......
:mod:`atexit` --- Exit handlers :mod:`atexit` --- Exit handlers
=============================== ===============================
...@@ -10,17 +9,16 @@ ...@@ -10,17 +9,16 @@
.. versionadded:: 2.0 .. versionadded:: 2.0
**Source code:** :source:`Lib/atexit.py`
--------------
The :mod:`atexit` module defines a single function to register cleanup The :mod:`atexit` module defines a single function to register cleanup
functions. Functions thus registered are automatically executed upon normal functions. Functions thus registered are automatically executed upon normal
interpreter termination. The order in which the functions are called is not interpreter termination. The order in which the functions are called is not
defined; if you have cleanup operations that depend on each other, you should defined; if you have cleanup operations that depend on each other, you should
wrap them in a function and register that one. This keeps :mod:`atexit` simple. wrap them in a function and register that one. This keeps :mod:`atexit` simple.
.. seealso::
Latest version of the `atexit Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/atexit.py?view=markup>`_
Note: the functions registered via this module are not called when the program Note: the functions registered via this module are not called when the program
is killed by a signal not handled by Python, when a Python fatal internal error is killed by a signal not handled by Python, when a Python fatal internal error
is detected, or when :func:`os._exit` is called. is detected, or when :func:`os._exit` is called.
......
...@@ -18,6 +18,10 @@ ...@@ -18,6 +18,10 @@
module: SimpleHTTPServer module: SimpleHTTPServer
module: CGIHTTPServer module: CGIHTTPServer
**Source code:** :source:`Lib/BaseHTTPServer.py`
--------------
This module defines two classes for implementing HTTP servers (Web servers). This module defines two classes for implementing HTTP servers (Web servers).
Usually, this module isn't used directly, but is used as a basis for building Usually, this module isn't used directly, but is used as a basis for building
functioning Web servers. See the :mod:`SimpleHTTPServer` and functioning Web servers. See the :mod:`SimpleHTTPServer` and
......
...@@ -4,6 +4,10 @@ ...@@ -4,6 +4,10 @@
.. module:: bdb .. module:: bdb
:synopsis: Debugger framework. :synopsis: Debugger framework.
**Source code:** :source:`Lib/bdb.py`
--------------
The :mod:`bdb` module handles basic debugger functions, like setting breakpoints The :mod:`bdb` module handles basic debugger functions, like setting breakpoints
or managing execution via the debugger. or managing execution via the debugger.
......
...@@ -7,6 +7,12 @@ ...@@ -7,6 +7,12 @@
.. sectionauthor:: Raymond Hettinger <python at rcn.com> .. sectionauthor:: Raymond Hettinger <python at rcn.com>
.. example based on the PyModules FAQ entry by Aaron Watters <arw@pythonpros.com> .. example based on the PyModules FAQ entry by Aaron Watters <arw@pythonpros.com>
.. versionadded:: 2.1
**Source code:** :source:`Lib/bisect.py`
--------------
This module provides support for maintaining a list in sorted order without This module provides support for maintaining a list in sorted order without
having to sort the list after each insertion. For long lists of items with having to sort the list after each insertion. For long lists of items with
expensive comparison operations, this can be an improvement over the more common expensive comparison operations, this can be an improvement over the more common
...@@ -14,13 +20,6 @@ approach. The module is called :mod:`bisect` because it uses a basic bisection ...@@ -14,13 +20,6 @@ approach. The module is called :mod:`bisect` because it uses a basic bisection
algorithm to do its work. The source code may be most useful as a working algorithm to do its work. The source code may be most useful as a working
example of the algorithm (the boundary conditions are already right!). example of the algorithm (the boundary conditions are already right!).
.. versionadded:: 2.1
.. seealso::
Latest version of the `bisect module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/bisect.py?view=markup>`_
The following functions are provided: The following functions are provided:
......
:mod:`calendar` --- General calendar-related functions :mod:`calendar` --- General calendar-related functions
====================================================== ======================================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
program. program.
.. sectionauthor:: Drew Csillag <drew_csillag@geocities.com> .. sectionauthor:: Drew Csillag <drew_csillag@geocities.com>
**Source code:** :source:`Lib/calendar.py`
--------------
This module allows you to output calendars like the Unix :program:`cal` program, This module allows you to output calendars like the Unix :program:`cal` program,
and provides additional useful functions related to the calendar. By default, and provides additional useful functions related to the calendar. By default,
...@@ -22,10 +24,6 @@ in both directions. This matches the definition of the "proleptic Gregorian" ...@@ -22,10 +24,6 @@ in both directions. This matches the definition of the "proleptic Gregorian"
calendar in Dershowitz and Reingold's book "Calendrical Calculations", where calendar in Dershowitz and Reingold's book "Calendrical Calculations", where
it's the base calendar for all computations. it's the base calendar for all computations.
.. seealso::
Latest version of the `calendar module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/calendar.py?view=markup>`_
.. class:: Calendar([firstweekday]) .. class:: Calendar([firstweekday])
......
...@@ -13,6 +13,10 @@ ...@@ -13,6 +13,10 @@
single: URL single: URL
single: Common Gateway Interface single: Common Gateway Interface
**Source code:** :source:`Lib/cgi.py`
--------------
Support module for Common Gateway Interface (CGI) scripts. Support module for Common Gateway Interface (CGI) scripts.
This module defines a number of utilities for use by CGI scripts written in This module defines a number of utilities for use by CGI scripts written in
......
:mod:`cmd` --- Support for line-oriented command interpreters :mod:`cmd` --- Support for line-oriented command interpreters
============================================================= =============================================================
...@@ -6,17 +5,15 @@ ...@@ -6,17 +5,15 @@
:synopsis: Build line-oriented command interpreters. :synopsis: Build line-oriented command interpreters.
.. sectionauthor:: Eric S. Raymond <esr@snark.thyrsus.com> .. sectionauthor:: Eric S. Raymond <esr@snark.thyrsus.com>
**Source code:** :source:`Lib/cmd.py`
--------------
The :class:`Cmd` class provides a simple framework for writing line-oriented The :class:`Cmd` class provides a simple framework for writing line-oriented
command interpreters. These are often useful for test harnesses, administrative command interpreters. These are often useful for test harnesses, administrative
tools, and prototypes that will later be wrapped in a more sophisticated tools, and prototypes that will later be wrapped in a more sophisticated
interface. interface.
.. seealso::
Latest version of the `cmd module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/cmd.py?view=markup>`_
.. class:: Cmd([completekey[, stdin[, stdout]]]) .. class:: Cmd([completekey[, stdin[, stdout]]])
A :class:`Cmd` instance or subclass instance is a line-oriented interpreter A :class:`Cmd` instance or subclass instance is a line-oriented interpreter
......
:mod:`collections` --- High-performance container datatypes :mod:`collections` --- High-performance container datatypes
=========================================================== ===========================================================
...@@ -15,6 +14,10 @@ ...@@ -15,6 +14,10 @@
import itertools import itertools
__name__ = '<doctest>' __name__ = '<doctest>'
**Source code:** :source:`Lib/collections.py` and :source:`Lib/_abcoll.py`
--------------
This module implements specialized container datatypes providing alternatives to This module implements specialized container datatypes providing alternatives to
Python's general purpose built-in containers, :class:`dict`, :class:`list`, Python's general purpose built-in containers, :class:`dict`, :class:`list`,
:class:`set`, and :class:`tuple`. :class:`set`, and :class:`tuple`.
...@@ -32,10 +35,6 @@ In addition to the concrete container classes, the collections module provides ...@@ -32,10 +35,6 @@ In addition to the concrete container classes, the collections module provides
used to test whether a class provides a particular interface, for example, used to test whether a class provides a particular interface, for example,
whether it is hashable or a mapping. whether it is hashable or a mapping.
.. seealso::
Latest version of the `collections module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/collections.py?view=markup>`_
:class:`Counter` objects :class:`Counter` objects
------------------------ ------------------------
...@@ -1024,9 +1023,6 @@ Notes on using :class:`Set` and :class:`MutableSet` as a mixin: ...@@ -1024,9 +1023,6 @@ Notes on using :class:`Set` and :class:`MutableSet` as a mixin:
.. seealso:: .. seealso::
* Latest version of the `Python source code for the collections abstract base classes
<http://svn.python.org/view/python/branches/release27-maint/Lib/_abcoll.py?view=markup>`_
* `OrderedSet recipe <http://code.activestate.com/recipes/576694/>`_ for an * `OrderedSet recipe <http://code.activestate.com/recipes/576694/>`_ for an
example built on :class:`MutableSet`. example built on :class:`MutableSet`.
......
...@@ -5,6 +5,9 @@ ...@@ -5,6 +5,9 @@
:synopsis: Conversion functions between RGB and other color systems. :synopsis: Conversion functions between RGB and other color systems.
.. sectionauthor:: David Ascher <da@python.net> .. sectionauthor:: David Ascher <da@python.net>
**Source code:** :source:`Lib/colorsys.py`
--------------
The :mod:`colorsys` module defines bidirectional conversions of color values The :mod:`colorsys` module defines bidirectional conversions of color values
between colors expressed in the RGB (Red Green Blue) color space used in between colors expressed in the RGB (Red Green Blue) color space used in
......
...@@ -7,15 +7,14 @@ ...@@ -7,15 +7,14 @@
.. versionadded:: 2.5 .. versionadded:: 2.5
**Source code:** :source:`Lib/contextlib.py`
--------------
This module provides utilities for common tasks involving the :keyword:`with` This module provides utilities for common tasks involving the :keyword:`with`
statement. For more information see also :ref:`typecontextmanager` and statement. For more information see also :ref:`typecontextmanager` and
:ref:`context-managers`. :ref:`context-managers`.
.. seealso::
Latest version of the `contextlib Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/contextlib.py?view=markup>`_
Functions provided: Functions provided:
......
...@@ -11,6 +11,9 @@ ...@@ -11,6 +11,9 @@
3.0. The :term:`2to3` tool will automatically adapt imports when converting 3.0. The :term:`2to3` tool will automatically adapt imports when converting
your sources to 3.0. your sources to 3.0.
**Source code:** :source:`Lib/Cookie.py`
--------------
The :mod:`Cookie` module defines classes for abstracting the concept of The :mod:`Cookie` module defines classes for abstracting the concept of
cookies, an HTTP state management mechanism. It supports both simple string-only cookies, an HTTP state management mechanism. It supports both simple string-only
......
...@@ -11,10 +11,11 @@ ...@@ -11,10 +11,11 @@
Python 3.0. The :term:`2to3` tool will automatically adapt imports when Python 3.0. The :term:`2to3` tool will automatically adapt imports when
converting your sources to 3.0. converting your sources to 3.0.
.. versionadded:: 2.4 .. versionadded:: 2.4
**Source code:** :source:`Lib/cookielib.py`
--------------
The :mod:`cookielib` module defines classes for automatic handling of HTTP The :mod:`cookielib` module defines classes for automatic handling of HTTP
cookies. It is useful for accessing web sites that require small pieces of data cookies. It is useful for accessing web sites that require small pieces of data
......
:mod:`dis` --- Disassembler for Python bytecode :mod:`dis` --- Disassembler for Python bytecode
=============================================== ===============================================
.. module:: dis .. module:: dis
:synopsis: Disassembler for Python bytecode. :synopsis: Disassembler for Python bytecode.
**Source code:** :source:`Lib/dis.py`
--------------
The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by
disassembling it. The CPython bytecode which this module takes as an disassembling it. The CPython bytecode which this module takes as an
input is defined in the file :file:`Include/opcode.h` and used by the compiler input is defined in the file :file:`Include/opcode.h` and used by the compiler
and the interpreter. and the interpreter.
.. seealso::
Latest version of the `dis module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/dis.py?view=markup>`_
.. impl-detail:: .. impl-detail::
Bytecode is an implementation detail of the CPython interpreter! No Bytecode is an implementation detail of the CPython interpreter! No
......
...@@ -10,6 +10,9 @@ ...@@ -10,6 +10,9 @@
converting your sources to 3.0; however, you should consider using the converting your sources to 3.0; however, you should consider using the
high-lever :mod:`dummy_threading` module instead. high-lever :mod:`dummy_threading` module instead.
**Source code:** :source:`Lib/dummy_thread.py`
--------------
This module provides a duplicate interface to the :mod:`thread` module. It is This module provides a duplicate interface to the :mod:`thread` module. It is
meant to be imported when the :mod:`thread` module is not provided on a meant to be imported when the :mod:`thread` module is not provided on a
......
:mod:`dummy_threading` --- Drop-in replacement for the :mod:`threading` module :mod:`dummy_threading` --- Drop-in replacement for the :mod:`threading` module
============================================================================== ==============================================================================
.. module:: dummy_threading .. module:: dummy_threading
:synopsis: Drop-in replacement for the threading module. :synopsis: Drop-in replacement for the threading module.
**Source code:** :source:`Lib/dummy_threading.py`
--------------
This module provides a duplicate interface to the :mod:`threading` module. It This module provides a duplicate interface to the :mod:`threading` module. It
is meant to be imported when the :mod:`thread` module is not provided on a is meant to be imported when the :mod:`thread` module is not provided on a
......
:mod:`filecmp` --- File and Directory Comparisons :mod:`filecmp` --- File and Directory Comparisons
================================================= =================================================
...@@ -6,16 +5,14 @@ ...@@ -6,16 +5,14 @@
:synopsis: Compare files efficiently. :synopsis: Compare files efficiently.
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
**Source code:** :source:`Lib/filecmp.py`
--------------
The :mod:`filecmp` module defines functions to compare files and directories, The :mod:`filecmp` module defines functions to compare files and directories,
with various optional time/correctness trade-offs. For comparing files, with various optional time/correctness trade-offs. For comparing files,
see also the :mod:`difflib` module. see also the :mod:`difflib` module.
.. seealso::
Latest version of the `filecmp Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/filecmp.py?view=markup>`_
The :mod:`filecmp` module defines the following functions: The :mod:`filecmp` module defines the following functions:
......
...@@ -6,6 +6,9 @@ ...@@ -6,6 +6,9 @@
.. moduleauthor:: Guido van Rossum <guido@python.org> .. moduleauthor:: Guido van Rossum <guido@python.org>
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/fileinput.py`
--------------
This module implements a helper class and functions to quickly write a This module implements a helper class and functions to quickly write a
loop over standard input or a list of files. If you just want to read or loop over standard input or a list of files. If you just want to read or
...@@ -44,11 +47,6 @@ hook must be a function that takes two arguments, *filename* and *mode*, and ...@@ -44,11 +47,6 @@ hook must be a function that takes two arguments, *filename* and *mode*, and
returns an accordingly opened file-like object. Two useful hooks are already returns an accordingly opened file-like object. Two useful hooks are already
provided by this module. provided by this module.
.. seealso::
Latest version of the `fileinput Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/fileinput.py?view=markup>`_
The following function is the primary interface of this module: The following function is the primary interface of this module:
......
:mod:`fnmatch` --- Unix filename pattern matching :mod:`fnmatch` --- Unix filename pattern matching
================================================= =================================================
...@@ -10,6 +9,10 @@ ...@@ -10,6 +9,10 @@
.. index:: module: re .. index:: module: re
**Source code:** :source:`Lib/fnmatch.py`
--------------
This module provides support for Unix shell-style wildcards, which are *not* the This module provides support for Unix shell-style wildcards, which are *not* the
same as regular expressions (which are documented in the :mod:`re` module). The same as regular expressions (which are documented in the :mod:`re` module). The
special characters used in shell-style wildcards are: special characters used in shell-style wildcards are:
...@@ -34,10 +37,6 @@ module. See module :mod:`glob` for pathname expansion (:mod:`glob` uses ...@@ -34,10 +37,6 @@ module. See module :mod:`glob` for pathname expansion (:mod:`glob` uses
a period are not special for this module, and are matched by the ``*`` and ``?`` a period are not special for this module, and are matched by the ``*`` and ``?``
patterns. patterns.
.. seealso::
Latest version of the `fnmatch Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/fnmatch.py?view=markup>`_
.. function:: fnmatch(filename, pattern) .. function:: fnmatch(filename, pattern)
...@@ -95,4 +94,3 @@ patterns. ...@@ -95,4 +94,3 @@ patterns.
Module :mod:`glob` Module :mod:`glob`
Unix shell-style path expansion. Unix shell-style path expansion.
:mod:`fractions` --- Rational numbers :mod:`fractions` --- Rational numbers
===================================== =====================================
...@@ -8,6 +7,9 @@ ...@@ -8,6 +7,9 @@
.. sectionauthor:: Jeffrey Yasskin <jyasskin at gmail.com> .. sectionauthor:: Jeffrey Yasskin <jyasskin at gmail.com>
.. versionadded:: 2.6 .. versionadded:: 2.6
**Source code:** :source:`Lib/fractions.py`
--------------
The :mod:`fractions` module provides support for rational number arithmetic. The :mod:`fractions` module provides support for rational number arithmetic.
......
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
pair: FTP; protocol pair: FTP; protocol
single: FTP; ftplib (standard module) single: FTP; ftplib (standard module)
**Source code:** :source:`Lib/ftplib.py`
--------------
This module defines the class :class:`FTP` and a few related items. The This module defines the class :class:`FTP` and a few related items. The
:class:`FTP` class implements the client side of the FTP protocol. You can use :class:`FTP` class implements the client side of the FTP protocol. You can use
this to write Python programs that perform a variety of automated FTP jobs, such this to write Python programs that perform a variety of automated FTP jobs, such
......
...@@ -8,18 +8,16 @@ ...@@ -8,18 +8,16 @@
.. moduleauthor:: Nick Coghlan <ncoghlan@gmail.com> .. moduleauthor:: Nick Coghlan <ncoghlan@gmail.com>
.. sectionauthor:: Peter Harris <scav@blueyonder.co.uk> .. sectionauthor:: Peter Harris <scav@blueyonder.co.uk>
.. versionadded:: 2.5 .. versionadded:: 2.5
**Source code:** :source:`Lib/functools.py`
--------------
The :mod:`functools` module is for higher-order functions: functions that act on The :mod:`functools` module is for higher-order functions: functions that act on
or return other functions. In general, any callable object can be treated as a or return other functions. In general, any callable object can be treated as a
function for the purposes of this module. function for the purposes of this module.
.. seealso::
Latest version of the `functools Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/functools.py?view=markup>`_
The :mod:`functools` module defines the following functions: The :mod:`functools` module defines the following functions:
.. function:: cmp_to_key(func) .. function:: cmp_to_key(func)
......
:mod:`getopt` --- C-style parser for command line options :mod:`getopt` --- C-style parser for command line options
========================================================= =========================================================
...@@ -6,6 +5,10 @@ ...@@ -6,6 +5,10 @@
:synopsis: Portable parser for command line options; support both short and long option :synopsis: Portable parser for command line options; support both short and long option
names. names.
**Source code:** :source:`Lib/getopt.py`
--------------
.. note:: .. note::
The :mod:`getopt` module is a parser for command line options whose API is The :mod:`getopt` module is a parser for command line options whose API is
designed to be familiar to users of the C :cfunc:`getopt` function. Users who designed to be familiar to users of the C :cfunc:`getopt` function. Users who
......
:mod:`gettext` --- Multilingual internationalization services :mod:`gettext` --- Multilingual internationalization services
============================================================= =============================================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
.. moduleauthor:: Barry A. Warsaw <barry@zope.com> .. moduleauthor:: Barry A. Warsaw <barry@zope.com>
.. sectionauthor:: Barry A. Warsaw <barry@zope.com> .. sectionauthor:: Barry A. Warsaw <barry@zope.com>
**Source code:** :source:`Lib/gettext.py`
--------------
The :mod:`gettext` module provides internationalization (I18N) and localization The :mod:`gettext` module provides internationalization (I18N) and localization
(L10N) services for your Python modules and applications. It supports both the (L10N) services for your Python modules and applications. It supports both the
......
:mod:`glob` --- Unix style pathname pattern expansion :mod:`glob` --- Unix style pathname pattern expansion
===================================================== =====================================================
...@@ -8,6 +7,10 @@ ...@@ -8,6 +7,10 @@
.. index:: single: filenames; pathname expansion .. index:: single: filenames; pathname expansion
**Source code:** :source:`Lib/glob.py`
--------------
The :mod:`glob` module finds all the pathnames matching a specified pattern The :mod:`glob` module finds all the pathnames matching a specified pattern
according to the rules used by the Unix shell. No tilde expansion is done, but according to the rules used by the Unix shell. No tilde expansion is done, but
``*``, ``?``, and character ranges expressed with ``[]`` will be correctly ``*``, ``?``, and character ranges expressed with ``[]`` will be correctly
...@@ -16,10 +19,6 @@ matched. This is done by using the :func:`os.listdir` and ...@@ -16,10 +19,6 @@ matched. This is done by using the :func:`os.listdir` and
subshell. (For tilde and shell variable expansion, use subshell. (For tilde and shell variable expansion, use
:func:`os.path.expanduser` and :func:`os.path.expandvars`.) :func:`os.path.expanduser` and :func:`os.path.expandvars`.)
.. seealso::
Latest version of the `glob module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/glob.py?view=markup>`_
.. function:: glob(pathname) .. function:: glob(pathname)
......
...@@ -4,6 +4,10 @@ ...@@ -4,6 +4,10 @@
.. module:: gzip .. module:: gzip
:synopsis: Interfaces for gzip compression and decompression using file objects. :synopsis: Interfaces for gzip compression and decompression using file objects.
**Source code:** :source:`Lib/gzip.py`
--------------
This module provides a simple interface to compress and decompress files just This module provides a simple interface to compress and decompress files just
like the GNU programs :program:`gzip` and :program:`gunzip` would. like the GNU programs :program:`gzip` and :program:`gunzip` would.
......
:mod:`hashlib` --- Secure hashes and message digests :mod:`hashlib` --- Secure hashes and message digests
==================================================== ====================================================
...@@ -14,6 +13,10 @@ ...@@ -14,6 +13,10 @@
single: message digest, MD5 single: message digest, MD5
single: secure hash algorithm, SHA1, SHA224, SHA256, SHA384, SHA512 single: secure hash algorithm, SHA1, SHA224, SHA256, SHA384, SHA512
**Source code:** :source:`Lib/hashlib.py`
--------------
This module implements a common interface to many different secure hash and This module implements a common interface to many different secure hash and
message digest algorithms. Included are the FIPS secure hash algorithms SHA1, message digest algorithms. Included are the FIPS secure hash algorithms SHA1,
SHA224, SHA256, SHA384, and SHA512 (defined in FIPS 180-2) as well as RSA's MD5 SHA224, SHA256, SHA384, and SHA512 (defined in FIPS 180-2) as well as RSA's MD5
......
...@@ -10,13 +10,12 @@ ...@@ -10,13 +10,12 @@
.. versionadded:: 2.3 .. versionadded:: 2.3
This module provides an implementation of the heap queue algorithm, also known **Source code:** :source:`Lib/heapq.py`
as the priority queue algorithm.
.. seealso:: --------------
Latest version of the `heapq Python source code This module provides an implementation of the heap queue algorithm, also known
<http://svn.python.org/view/*checkout*/python/branches/release27-maint/Lib/heapq.py?content-type=text%2Fplain>`_ as the priority queue algorithm.
Heaps are binary trees for which every parent node has a value less than or Heaps are binary trees for which every parent node has a value less than or
equal to any of its children. This implementation uses arrays for which equal to any of its children. This implementation uses arrays for which
......
:mod:`hmac` --- Keyed-Hashing for Message Authentication :mod:`hmac` --- Keyed-Hashing for Message Authentication
======================================================== ========================================================
...@@ -10,6 +9,10 @@ ...@@ -10,6 +9,10 @@
.. versionadded:: 2.2 .. versionadded:: 2.2
**Source code:** :source:`Lib/hmac.py`
--------------
This module implements the HMAC algorithm as described by :rfc:`2104`. This module implements the HMAC algorithm as described by :rfc:`2104`.
......
...@@ -165,6 +165,9 @@ additional methods and instance variables for use within tag methods. ...@@ -165,6 +165,9 @@ additional methods and instance variables for use within tag methods.
Python 3.0. The :term:`2to3` tool will automatically adapt imports when Python 3.0. The :term:`2to3` tool will automatically adapt imports when
converting your sources to 3.0. converting your sources to 3.0.
**Source code:** :source:`Lib/htmlentitydefs.py`
--------------
This module defines three dictionaries, ``name2codepoint``, ``codepoint2name``, This module defines three dictionaries, ``name2codepoint``, ``codepoint2name``,
and ``entitydefs``. ``entitydefs`` is used by the :mod:`htmllib` module to and ``entitydefs``. ``entitydefs`` is used by the :mod:`htmllib` module to
......
...@@ -18,6 +18,10 @@ ...@@ -18,6 +18,10 @@
single: HTML single: HTML
single: XHTML single: XHTML
**Source code:** :source:`Lib/HTMLParser.py`
--------------
This module defines a class :class:`HTMLParser` which serves as the basis for This module defines a class :class:`HTMLParser` which serves as the basis for
parsing text files formatted in HTML (HyperText Mark-up Language) and XHTML. parsing text files formatted in HTML (HyperText Mark-up Language) and XHTML.
Unlike the parser in :mod:`htmllib`, this parser is not based on the SGML parser Unlike the parser in :mod:`htmllib`, this parser is not based on the SGML parser
......
...@@ -16,6 +16,10 @@ ...@@ -16,6 +16,10 @@
.. index:: module: urllib .. index:: module: urllib
**Source code:** :source:`Lib/httplib.py`
--------------
This module defines classes which implement the client side of the HTTP and This module defines classes which implement the client side of the HTTP and
HTTPS protocols. It is normally not used directly --- the module :mod:`urllib` HTTPS protocols. It is normally not used directly --- the module :mod:`urllib`
uses it to handle URLs that use HTTP and HTTPS. uses it to handle URLs that use HTTP and HTTPS.
......
...@@ -16,6 +16,10 @@ ...@@ -16,6 +16,10 @@
pair: IMAP4_SSL; protocol pair: IMAP4_SSL; protocol
pair: IMAP4_stream; protocol pair: IMAP4_stream; protocol
**Source code:** :source:`Lib/imaplib.py`
--------------
This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and
:class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and :class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and
implement a large subset of the IMAP4rev1 client protocol as defined in implement a large subset of the IMAP4rev1 client protocol as defined in
......
:mod:`imghdr` --- Determine the type of an image :mod:`imghdr` --- Determine the type of an image
================================================ ================================================
.. module:: imghdr .. module:: imghdr
:synopsis: Determine the type of image contained in a file or byte stream. :synopsis: Determine the type of image contained in a file or byte stream.
**Source code:** :source:`Lib/imghdr.py`
--------------
The :mod:`imghdr` module determines the type of image contained in a file or The :mod:`imghdr` module determines the type of image contained in a file or
byte stream. byte stream.
......
:mod:`inspect` --- Inspect live objects :mod:`inspect` --- Inspect live objects
======================================= =======================================
...@@ -10,6 +9,10 @@ ...@@ -10,6 +9,10 @@
.. versionadded:: 2.1 .. versionadded:: 2.1
**Source code:** :source:`Lib/inspect.py`
--------------
The :mod:`inspect` module provides several useful functions to help get The :mod:`inspect` module provides several useful functions to help get
information about live objects such as modules, classes, methods, functions, information about live objects such as modules, classes, methods, functions,
tracebacks, frame objects, and code objects. For example, it can help you tracebacks, frame objects, and code objects. For example, it can help you
......
:mod:`keyword` --- Testing for Python keywords :mod:`keyword` --- Testing for Python keywords
============================================== ==============================================
.. module:: keyword .. module:: keyword
:synopsis: Test whether a string is a keyword in Python. :synopsis: Test whether a string is a keyword in Python.
**Source code:** :source:`Lib/keyword.py`
--------------
This module allows a Python program to determine if a string is a keyword. This module allows a Python program to determine if a string is a keyword.
...@@ -19,9 +21,3 @@ This module allows a Python program to determine if a string is a keyword. ...@@ -19,9 +21,3 @@ This module allows a Python program to determine if a string is a keyword.
Sequence containing all the keywords defined for the interpreter. If any Sequence containing all the keywords defined for the interpreter. If any
keywords are defined to only be active when particular :mod:`__future__` keywords are defined to only be active when particular :mod:`__future__`
statements are in effect, these will be included as well. statements are in effect, these will be included as well.
.. seealso::
Latest version of the `keyword module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/keyword.py?view=markup>`_
...@@ -6,17 +6,15 @@ ...@@ -6,17 +6,15 @@
:synopsis: This module provides random access to individual lines from text files. :synopsis: This module provides random access to individual lines from text files.
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
**Source code:** :source:`Lib/linecache.py`
--------------
The :mod:`linecache` module allows one to get any line from any file, while The :mod:`linecache` module allows one to get any line from any file, while
attempting to optimize internally, using a cache, the common case where many attempting to optimize internally, using a cache, the common case where many
lines are read from a single file. This is used by the :mod:`traceback` module lines are read from a single file. This is used by the :mod:`traceback` module
to retrieve source lines for inclusion in the formatted traceback. to retrieve source lines for inclusion in the formatted traceback.
.. seealso::
Latest version of the `linecache module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/linecache.py?view=markup>`_
The :mod:`linecache` module defines the following functions: The :mod:`linecache` module defines the following functions:
......
...@@ -4,7 +4,9 @@ ...@@ -4,7 +4,9 @@
.. module:: mailcap .. module:: mailcap
:synopsis: Mailcap file handling. :synopsis: Mailcap file handling.
**Source code:** :source:`Lib/mailcap.py`
--------------
Mailcap files are used to configure how MIME-aware applications such as mail Mailcap files are used to configure how MIME-aware applications such as mail
readers and Web browsers react to files with different MIME types. (The name readers and Web browsers react to files with different MIME types. (The name
......
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
.. index:: pair: MIME; content type .. index:: pair: MIME; content type
**Source code:** :source:`Lib/mimetypes.py`
--------------
The :mod:`mimetypes` module converts between a filename or URL and the MIME type The :mod:`mimetypes` module converts between a filename or URL and the MIME type
associated with the filename extension. Conversions are provided from filename associated with the filename extension. Conversions are provided from filename
to MIME type and from MIME type to filename extension; encodings are not to MIME type and from MIME type to filename extension; encodings are not
......
:mod:`modulefinder` --- Find modules used by a script :mod:`modulefinder` --- Find modules used by a script
===================================================== =====================================================
.. sectionauthor:: A.M. Kuchling <amk@amk.ca>
.. module:: modulefinder .. module:: modulefinder
:synopsis: Find modules used by a script. :synopsis: Find modules used by a script.
.. sectionauthor:: A.M. Kuchling <amk@amk.ca>
.. versionadded:: 2.3 .. versionadded:: 2.3
**Source code:** :source:`Lib/modulefinder.py`
--------------
This module provides a :class:`ModuleFinder` class that can be used to determine This module provides a :class:`ModuleFinder` class that can be used to determine
the set of modules imported by a script. ``modulefinder.py`` can also be run as the set of modules imported by a script. ``modulefinder.py`` can also be run as
a script, giving the filename of a Python script as its argument, after which a a script, giving the filename of a Python script as its argument, after which a
......
...@@ -10,6 +10,10 @@ ...@@ -10,6 +10,10 @@
.. versionadded:: 1.5.2 .. versionadded:: 1.5.2
**Source code:** :source:`Lib/netrc.py`
--------------
The :class:`netrc` class parses and encapsulates the netrc file format used by The :class:`netrc` class parses and encapsulates the netrc file format used by
the Unix :program:`ftp` program and other FTP clients. the Unix :program:`ftp` program and other FTP clients.
......
...@@ -10,6 +10,10 @@ ...@@ -10,6 +10,10 @@
pair: NNTP; protocol pair: NNTP; protocol
single: Network News Transfer Protocol single: Network News Transfer Protocol
**Source code:** :source:`Lib/nntplib.py`
--------------
This module defines the class :class:`NNTP` which implements the client side of This module defines the class :class:`NNTP` which implements the client side of
the NNTP protocol. It can be used to implement a news reader or poster, or the NNTP protocol. It can be used to implement a news reader or poster, or
automated news processors. For more information on NNTP (Network News Transfer automated news processors. For more information on NNTP (Network News Transfer
......
...@@ -4,17 +4,18 @@ ...@@ -4,17 +4,18 @@
.. module:: optparse .. module:: optparse
:synopsis: Command-line option parsing library. :synopsis: Command-line option parsing library.
:deprecated: :deprecated:
.. moduleauthor:: Greg Ward <gward@python.net>
.. sectionauthor:: Greg Ward <gward@python.net>
.. versionadded:: 2.3
.. deprecated:: 2.7 .. deprecated:: 2.7
The :mod:`optparse` module is deprecated and will not be developed further; The :mod:`optparse` module is deprecated and will not be developed further;
development will continue with the :mod:`argparse` module. development will continue with the :mod:`argparse` module.
.. moduleauthor:: Greg Ward <gward@python.net> **Source code:** :source:`Lib/optparse.py`
.. versionadded:: 2.3
.. sectionauthor:: Greg Ward <gward@python.net>
--------------
:mod:`optparse` is a more convenient, flexible, and powerful library for parsing :mod:`optparse` is a more convenient, flexible, and powerful library for parsing
command-line options than the old :mod:`getopt` module. :mod:`optparse` uses a command-line options than the old :mod:`getopt` module. :mod:`optparse` uses a
......
...@@ -8,6 +8,10 @@ ...@@ -8,6 +8,10 @@
.. versionadded:: 2.3 .. versionadded:: 2.3
**Source code:** :source:`Lib/pickletools.py`
--------------
This module contains various constants relating to the intimate details of the This module contains various constants relating to the intimate details of the
:mod:`pickle` module, some lengthy comments about the implementation, and a few :mod:`pickle` module, some lengthy comments about the implementation, and a few
useful functions for analyzing pickled data. The contents of this module are useful functions for analyzing pickled data. The contents of this module are
......
:mod:`pipes` --- Interface to shell pipelines :mod:`pipes` --- Interface to shell pipelines
============================================= =============================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
:synopsis: A Python interface to Unix shell pipelines. :synopsis: A Python interface to Unix shell pipelines.
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
**Source code:** :source:`Lib/pipes.py`
--------------
The :mod:`pipes` module defines a class to abstract the concept of a *pipeline* The :mod:`pipes` module defines a class to abstract the concept of a *pipeline*
--- a sequence of converters from one file to another. --- a sequence of converters from one file to another.
......
:mod:`pkgutil` --- Package extension utility :mod:`pkgutil` --- Package extension utility
============================================ ============================================
.. module:: pkgutil .. module:: pkgutil
:synopsis: Utilities for the import system. :synopsis: Utilities for the import system.
.. versionadded:: 2.3
**Source code:** :source:`Lib/pkgutil.py`
--------------
This module provides utilities for the import system, in particular package This module provides utilities for the import system, in particular package
support. support.
.. versionadded:: 2.3
.. function:: extend_path(path, name) .. function:: extend_path(path, name)
......
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
.. versionadded:: 2.3 .. versionadded:: 2.3
**Source code:** :source:`Lib/platform.py`
--------------
.. note:: .. note::
Specific platforms listed alphabetically, with Linux included in the Unix Specific platforms listed alphabetically, with Linux included in the Unix
......
...@@ -15,6 +15,10 @@ ...@@ -15,6 +15,10 @@
pair: plist; file pair: plist; file
single: property list single: property list
**Source code:** :source:`Lib/plistlib.py`
--------------
This module provides an interface for reading and writing the "property list" This module provides an interface for reading and writing the "property list"
XML files used mainly by Mac OS X. XML files used mainly by Mac OS X.
......
:mod:`poplib` --- POP3 protocol client :mod:`poplib` --- POP3 protocol client
====================================== ======================================
...@@ -9,6 +8,10 @@ ...@@ -9,6 +8,10 @@
.. index:: pair: POP3; protocol .. index:: pair: POP3; protocol
**Source code:** :source:`Lib/poplib.py`
--------------
This module defines a class, :class:`POP3`, which encapsulates a connection to a This module defines a class, :class:`POP3`, which encapsulates a connection to a
POP3 server and implements the protocol as defined in :rfc:`1725`. The POP3 server and implements the protocol as defined in :rfc:`1725`. The
:class:`POP3` class supports both the minimal and optional command sets. :class:`POP3` class supports both the minimal and optional command sets.
......
:mod:`pprint` --- Data pretty printer :mod:`pprint` --- Data pretty printer
===================================== =====================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
.. moduleauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. moduleauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/pprint.py`
--------------
The :mod:`pprint` module provides a capability to "pretty-print" arbitrary The :mod:`pprint` module provides a capability to "pretty-print" arbitrary
Python data structures in a form which can be used as input to the interpreter. Python data structures in a form which can be used as input to the interpreter.
...@@ -28,10 +30,6 @@ width constraint. ...@@ -28,10 +30,6 @@ width constraint.
.. versionchanged:: 2.6 .. versionchanged:: 2.6
Added support for :class:`set` and :class:`frozenset`. Added support for :class:`set` and :class:`frozenset`.
.. seealso::
Latest version of the `pprint module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/pprint.py?view=markup>`_
The :mod:`pprint` module defines one class: The :mod:`pprint` module defines one class:
......
.. _profile: .. _profile:
******************** ********************
...@@ -10,6 +9,9 @@ The Python Profilers ...@@ -10,6 +9,9 @@ The Python Profilers
.. module:: profile .. module:: profile
:synopsis: Python source profiler. :synopsis: Python source profiler.
**Source code:** :source:`Lib/profile.py` and :source:`Lib/pstats.py`
--------------
.. _profiler-introduction: .. _profiler-introduction:
......
...@@ -8,6 +8,10 @@ ...@@ -8,6 +8,10 @@
.. index:: pair: file; byte-code .. index:: pair: file; byte-code
**Source code:** :source:`Lib/py_compile.py`
--------------
The :mod:`py_compile` module provides a function to generate a byte-code file The :mod:`py_compile` module provides a function to generate a byte-code file
from a source file, and another function used when the module source file is from a source file, and another function used when the module source file is
invoked as a script. invoked as a script.
......
:mod:`pyclbr` --- Python class browser support :mod:`pyclbr` --- Python class browser support
============================================== ==============================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Supports information extraction for a Python class browser. :synopsis: Supports information extraction for a Python class browser.
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/pyclbr.py`
--------------
The :mod:`pyclbr` module can be used to determine some limited information The :mod:`pyclbr` module can be used to determine some limited information
about the classes, methods and top-level functions defined in a module. The about the classes, methods and top-level functions defined in a module. The
......
:mod:`pydoc` --- Documentation generator and online help system :mod:`pydoc` --- Documentation generator and online help system
=============================================================== ===============================================================
...@@ -15,6 +14,10 @@ ...@@ -15,6 +14,10 @@
single: documentation; online single: documentation; online
single: help; online single: help; online
**Source code:** :source:`Lib/pydoc.py`
--------------
The :mod:`pydoc` module automatically generates documentation from Python The :mod:`pydoc` module automatically generates documentation from Python
modules. The documentation can be presented as pages of text on the console, modules. The documentation can be presented as pages of text on the console,
served to a Web browser, or saved to HTML files. served to a Web browser, or saved to HTML files.
......
...@@ -9,6 +9,9 @@ ...@@ -9,6 +9,9 @@
:term:`2to3` tool will automatically adapt imports when converting your :term:`2to3` tool will automatically adapt imports when converting your
sources to 3.0. sources to 3.0.
**Source code:** :source:`Lib/Queue.py`
--------------
The :mod:`Queue` module implements multi-producer, multi-consumer queues. The :mod:`Queue` module implements multi-producer, multi-consumer queues.
It is especially useful in threaded programming when information must be It is especially useful in threaded programming when information must be
...@@ -24,11 +27,6 @@ the first retrieved (operating like a stack). With a priority queue, ...@@ -24,11 +27,6 @@ the first retrieved (operating like a stack). With a priority queue,
the entries are kept sorted (using the :mod:`heapq` module) and the the entries are kept sorted (using the :mod:`heapq` module) and the
lowest valued entry is retrieved first. lowest valued entry is retrieved first.
.. seealso::
Latest version of the `Queue module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/Queue.py?view=markup>`_.
The :mod:`Queue` module defines the following classes and exceptions: The :mod:`Queue` module defines the following classes and exceptions:
.. class:: Queue(maxsize=0) .. class:: Queue(maxsize=0)
......
:mod:`quopri` --- Encode and decode MIME quoted-printable data :mod:`quopri` --- Encode and decode MIME quoted-printable data
============================================================== ==============================================================
...@@ -10,6 +9,10 @@ ...@@ -10,6 +9,10 @@
pair: quoted-printable; encoding pair: quoted-printable; encoding
single: MIME; quoted-printable encoding single: MIME; quoted-printable encoding
**Source code:** :source:`Lib/quopri.py`
--------------
This module performs quoted-printable transport encoding and decoding, as This module performs quoted-printable transport encoding and decoding, as
defined in :rfc:`1521`: "MIME (Multipurpose Internet Mail Extensions) Part One: defined in :rfc:`1521`: "MIME (Multipurpose Internet Mail Extensions) Part One:
Mechanisms for Specifying and Describing the Format of Internet Message Bodies". Mechanisms for Specifying and Describing the Format of Internet Message Bodies".
...@@ -18,11 +21,6 @@ few nonprintable characters; the base64 encoding scheme available via the ...@@ -18,11 +21,6 @@ few nonprintable characters; the base64 encoding scheme available via the
:mod:`base64` module is more compact if there are many such characters, as when :mod:`base64` module is more compact if there are many such characters, as when
sending a graphics file. sending a graphics file.
.. seealso::
Latest version of the `quopri module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/quopri.py?view=markup>`_
.. function:: decode(input, output[,header]) .. function:: decode(input, output[,header])
Decode the contents of the *input* file and write the resulting decoded binary Decode the contents of the *input* file and write the resulting decoded binary
......
:mod:`random` --- Generate pseudo-random numbers :mod:`random` --- Generate pseudo-random numbers
================================================ ================================================
.. module:: random .. module:: random
:synopsis: Generate pseudo-random numbers with various common distributions. :synopsis: Generate pseudo-random numbers with various common distributions.
**Source code:** :source:`Lib/random.py`
--------------
This module implements pseudo-random number generators for various This module implements pseudo-random number generators for various
distributions. distributions.
.. seealso::
Latest version of the `random module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/random.py?view=markup>`_
For integers, uniform selection from a range. For sequences, uniform selection For integers, uniform selection from a range. For sequences, uniform selection
of a random element, a function to generate a random permutation of a list of a random element, a function to generate a random permutation of a list
in-place, and a function for random sampling without replacement. in-place, and a function for random sampling without replacement.
......
:mod:`repr` --- Alternate :func:`repr` implementation :mod:`repr` --- Alternate :func:`repr` implementation
===================================================== =====================================================
...@@ -11,15 +10,14 @@ ...@@ -11,15 +10,14 @@
:term:`2to3` tool will automatically adapt imports when converting your :term:`2to3` tool will automatically adapt imports when converting your
sources to 3.0. sources to 3.0.
**Source code:** :source:`Lib/repr.py`
--------------
The :mod:`repr` module provides a means for producing object representations The :mod:`repr` module provides a means for producing object representations
with limits on the size of the resulting strings. This is used in the Python with limits on the size of the resulting strings. This is used in the Python
debugger and may be useful in other contexts as well. debugger and may be useful in other contexts as well.
.. seealso::
Latest version of the `repr module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/repr.py?view=markup>`_
This module provides a class, an instance, and a function: This module provides a class, an instance, and a function:
......
:mod:`rlcompleter` --- Completion function for GNU readline :mod:`rlcompleter` --- Completion function for GNU readline
=========================================================== ===========================================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Python identifier completion, suitable for the GNU readline library. :synopsis: Python identifier completion, suitable for the GNU readline library.
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
**Source code:** :source:`Lib/rlcompleter.py`
--------------
The :mod:`rlcompleter` module defines a completion function suitable for the The :mod:`rlcompleter` module defines a completion function suitable for the
:mod:`readline` module by completing valid Python identifiers and keywords. :mod:`readline` module by completing valid Python identifiers and keywords.
......
...@@ -8,6 +8,10 @@ ...@@ -8,6 +8,10 @@
.. versionadded:: 2.5 .. versionadded:: 2.5
**Source code:** :source:`Lib/runpy.py`
--------------
The :mod:`runpy` module is used to locate and run Python modules without The :mod:`runpy` module is used to locate and run Python modules without
importing them first. Its main use is to implement the :option:`-m` command importing them first. Its main use is to implement the :option:`-m` command
line switch that allows scripts to be located using the Python module line switch that allows scripts to be located using the Python module
......
...@@ -7,13 +7,12 @@ ...@@ -7,13 +7,12 @@
.. index:: single: event scheduling .. index:: single: event scheduling
The :mod:`sched` module defines a class which implements a general purpose event **Source code:** :source:`Lib/sched.py`
scheduler:
.. seealso:: --------------
Latest version of the `sched module Python source code The :mod:`sched` module defines a class which implements a general purpose event
<http://svn.python.org/view/python/branches/release27-maint/Lib/sched.py?view=markup>`_ scheduler:
.. class:: scheduler(timefunc, delayfunc) .. class:: scheduler(timefunc, delayfunc)
......
...@@ -7,16 +7,16 @@ ...@@ -7,16 +7,16 @@
.. index:: module: pickle .. index:: module: pickle
**Source code:** :source:`Lib/shelve.py`
--------------
A "shelf" is a persistent, dictionary-like object. The difference with "dbm" A "shelf" is a persistent, dictionary-like object. The difference with "dbm"
databases is that the values (not the keys!) in a shelf can be essentially databases is that the values (not the keys!) in a shelf can be essentially
arbitrary Python objects --- anything that the :mod:`pickle` module can handle. arbitrary Python objects --- anything that the :mod:`pickle` module can handle.
This includes most class instances, recursive data types, and objects containing This includes most class instances, recursive data types, and objects containing
lots of shared sub-objects. The keys are ordinary strings. lots of shared sub-objects. The keys are ordinary strings.
.. seealso::
Latest version of the `shelve module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/shelve.py?view=markup>`_
.. function:: open(filename[, flag='c'[, protocol=None[, writeback=False]]]) .. function:: open(filename[, flag='c'[, protocol=None[, writeback=False]]])
......
:mod:`shlex` --- Simple lexical analysis :mod:`shlex` --- Simple lexical analysis
======================================== ========================================
...@@ -12,6 +11,11 @@ ...@@ -12,6 +11,11 @@
.. versionadded:: 1.5.2 .. versionadded:: 1.5.2
**Source code:** :source:`Lib/shlex.py`
--------------
The :class:`shlex` class makes it easy to write lexical analyzers for simple The :class:`shlex` class makes it easy to write lexical analyzers for simple
syntaxes resembling that of the Unix shell. This will often be useful for syntaxes resembling that of the Unix shell. This will often be useful for
writing minilanguages, (for example, in run control files for Python writing minilanguages, (for example, in run control files for Python
......
:mod:`shutil` --- High-level file operations :mod:`shutil` --- High-level file operations
============================================ ============================================
...@@ -11,16 +10,15 @@ ...@@ -11,16 +10,15 @@
single: file; copying single: file; copying
single: copying files single: copying files
**Source code:** :source:`Lib/shutil.py`
--------------
The :mod:`shutil` module offers a number of high-level operations on files and The :mod:`shutil` module offers a number of high-level operations on files and
collections of files. In particular, functions are provided which support file collections of files. In particular, functions are provided which support file
copying and removal. For operations on individual files, see also the copying and removal. For operations on individual files, see also the
:mod:`os` module. :mod:`os` module.
.. seealso::
Latest version of the `shutil module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/shutil.py?view=markup>`_
.. warning:: .. warning::
Even the higher-level file copying functions (:func:`copy`, :func:`copy2`) Even the higher-level file copying functions (:func:`copy`, :func:`copy2`)
......
...@@ -14,6 +14,10 @@ ...@@ -14,6 +14,10 @@
.. versionadded:: 2.2 .. versionadded:: 2.2
**Source code:** :source:`Lib/SimpleXMLRPCServer.py`
--------------
The :mod:`SimpleXMLRPCServer` module provides a basic server framework for The :mod:`SimpleXMLRPCServer` module provides a basic server framework for
XML-RPC servers written in Python. Servers can either be free standing, using XML-RPC servers written in Python. Servers can either be free standing, using
:class:`SimpleXMLRPCServer`, or embedded in a CGI environment, using :class:`SimpleXMLRPCServer`, or embedded in a CGI environment, using
......
:mod:`site` --- Site-specific configuration hook :mod:`site` --- Site-specific configuration hook
================================================ ================================================
.. module:: site .. module:: site
:synopsis: A standard way to reference site-specific modules. :synopsis: A standard way to reference site-specific modules.
**Source code:** :source:`Lib/site.py`
--------------
**This module is automatically imported during initialization.** The automatic **This module is automatically imported during initialization.** The automatic
import can be suppressed using the interpreter's :option:`-S` option. import can be suppressed using the interpreter's :option:`-S` option.
......
...@@ -7,8 +7,9 @@ ...@@ -7,8 +7,9 @@
.. moduleauthor:: Barry Warsaw <barry@zope.com> .. moduleauthor:: Barry Warsaw <barry@zope.com>
.. sectionauthor:: Moshe Zadka <moshez@moshez.org> .. sectionauthor:: Moshe Zadka <moshez@moshez.org>
**Source code:** :source:`Lib/smtpd.py`
--------------
This module offers several classes to implement SMTP servers. One is a generic This module offers several classes to implement SMTP servers. One is a generic
do-nothing implementation, which can be overridden, while the other two offer do-nothing implementation, which can be overridden, while the other two offer
......
:mod:`smtplib` --- SMTP protocol client :mod:`smtplib` --- SMTP protocol client
======================================= =======================================
...@@ -11,6 +10,10 @@ ...@@ -11,6 +10,10 @@
pair: SMTP; protocol pair: SMTP; protocol
single: Simple Mail Transfer Protocol single: Simple Mail Transfer Protocol
**Source code:** :source:`Lib/smtplib.py`
--------------
The :mod:`smtplib` module defines an SMTP client session object that can be used The :mod:`smtplib` module defines an SMTP client session object that can be used
to send mail to any Internet machine with an SMTP or ESMTP listener daemon. For to send mail to any Internet machine with an SMTP or ESMTP listener daemon. For
details of SMTP and ESMTP operation, consult :rfc:`821` (Simple Mail Transfer details of SMTP and ESMTP operation, consult :rfc:`821` (Simple Mail Transfer
......
:mod:`sndhdr` --- Determine type of sound file :mod:`sndhdr` --- Determine type of sound file
============================================== ==============================================
...@@ -11,6 +10,10 @@ ...@@ -11,6 +10,10 @@
single: A-LAW single: A-LAW
single: u-LAW single: u-LAW
**Source code:** :source:`Lib/sndhdr.py`
--------------
The :mod:`sndhdr` provides utility functions which attempt to determine the type The :mod:`sndhdr` provides utility functions which attempt to determine the type
of sound data which is in a file. When these functions are able to determine of sound data which is in a file. When these functions are able to determine
what type of sound data is stored in a file, they return a tuple ``(type, what type of sound data is stored in a file, they return a tuple ``(type,
......
:mod:`SocketServer` --- A framework for network servers :mod:`SocketServer` --- A framework for network servers
======================================================= =======================================================
...@@ -11,6 +10,9 @@ ...@@ -11,6 +10,9 @@
Python 3.0. The :term:`2to3` tool will automatically adapt imports when Python 3.0. The :term:`2to3` tool will automatically adapt imports when
converting your sources to 3.0. converting your sources to 3.0.
**Source code:** :source:`Lib/SocketServer.py`
--------------
The :mod:`SocketServer` module simplifies the task of writing network servers. The :mod:`SocketServer` module simplifies the task of writing network servers.
......
...@@ -5,9 +5,6 @@ ...@@ -5,9 +5,6 @@
:synopsis: TLS/SSL wrapper for socket objects :synopsis: TLS/SSL wrapper for socket objects
.. moduleauthor:: Bill Janssen <bill.janssen@gmail.com> .. moduleauthor:: Bill Janssen <bill.janssen@gmail.com>
.. versionadded:: 2.6
.. sectionauthor:: Bill Janssen <bill.janssen@gmail.com> .. sectionauthor:: Bill Janssen <bill.janssen@gmail.com>
...@@ -15,6 +12,12 @@ ...@@ -15,6 +12,12 @@
.. index:: TLS, SSL, Transport Layer Security, Secure Sockets Layer .. index:: TLS, SSL, Transport Layer Security, Secure Sockets Layer
.. versionadded:: 2.6
**Source code:** :source:`Lib/ssl.py`
--------------
This module provides access to Transport Layer Security (often known as "Secure This module provides access to Transport Layer Security (often known as "Secure
Sockets Layer") encryption and peer authentication facilities for network Sockets Layer") encryption and peer authentication facilities for network
sockets, both client-side and server-side. This module uses the OpenSSL sockets, both client-side and server-side. This module uses the OpenSSL
......
:mod:`stat` --- Interpreting :func:`stat` results :mod:`stat` --- Interpreting :func:`stat` results
================================================= =================================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Utilities for interpreting the results of os.stat(), os.lstat() and os.fstat(). :synopsis: Utilities for interpreting the results of os.stat(), os.lstat() and os.fstat().
.. sectionauthor:: Skip Montanaro <skip@automatrix.com> .. sectionauthor:: Skip Montanaro <skip@automatrix.com>
**Source code:** :source:`Lib/stat.py`
--------------
The :mod:`stat` module defines constants and functions for interpreting the The :mod:`stat` module defines constants and functions for interpreting the
results of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat` (if they results of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat` (if they
......
...@@ -7,6 +7,10 @@ ...@@ -7,6 +7,10 @@
.. index:: module: re .. index:: module: re
**Source code:** :source:`Lib/string.py`
--------------
The :mod:`string` module contains a number of useful constants and The :mod:`string` module contains a number of useful constants and
classes, as well as some deprecated legacy functions that are also classes, as well as some deprecated legacy functions that are also
available as methods on strings. In addition, Python's built-in string available as methods on strings. In addition, Python's built-in string
...@@ -17,12 +21,6 @@ template strings or the ``%`` operator described in the ...@@ -17,12 +21,6 @@ template strings or the ``%`` operator described in the
:ref:`string-formatting` section. Also, see the :mod:`re` module for :ref:`string-formatting` section. Also, see the :mod:`re` module for
string functions based on regular expressions. string functions based on regular expressions.
.. seealso::
Latest version of the `string module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/string.py?view=markup>`_
String constants String constants
---------------- ----------------
......
:mod:`sunau` --- Read and write Sun AU files :mod:`sunau` --- Read and write Sun AU files
============================================ ============================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Provide an interface to the Sun AU sound format. :synopsis: Provide an interface to the Sun AU sound format.
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
**Source code:** :source:`Lib/sunau.py`
--------------
The :mod:`sunau` module provides a convenient interface to the Sun AU sound The :mod:`sunau` module provides a convenient interface to the Sun AU sound
format. Note that this module is interface-compatible with the modules format. Note that this module is interface-compatible with the modules
......
:mod:`symbol` --- Constants used with Python parse trees :mod:`symbol` --- Constants used with Python parse trees
======================================================== ========================================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Constants representing internal nodes of the parse tree. :synopsis: Constants representing internal nodes of the parse tree.
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/symbol.py`
--------------
This module provides constants which represent the numeric values of internal This module provides constants which represent the numeric values of internal
nodes of the parse tree. Unlike most Python constants, these use lower-case nodes of the parse tree. Unlike most Python constants, these use lower-case
......
...@@ -5,10 +5,15 @@ ...@@ -5,10 +5,15 @@
:synopsis: Python's configuration information :synopsis: Python's configuration information
.. moduleauthor:: Tarek Ziade <tarek@ziade.org> .. moduleauthor:: Tarek Ziade <tarek@ziade.org>
.. sectionauthor:: Tarek Ziade <tarek@ziade.org> .. sectionauthor:: Tarek Ziade <tarek@ziade.org>
.. versionadded:: 2.7
.. index:: .. index::
single: configuration information single: configuration information
.. versionadded:: 2.7
**Source code:** :source:`Lib/sysconfig.py`
--------------
The :mod:`sysconfig` module provides access to Python's configuration The :mod:`sysconfig` module provides access to Python's configuration
information like the list of installation paths and the configuration variables information like the list of installation paths and the configuration variables
relevant for the current platform. relevant for the current platform.
......
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
.. rudimentary documentation based on module comments .. rudimentary documentation based on module comments
**Source code:** :source:`Lib/tabnanny.py`
--------------
For the time being this module is intended to be called as a script. However it For the time being this module is intended to be called as a script. However it
is possible to import it into an IDE and use the function :func:`check` is possible to import it into an IDE and use the function :func:`check`
described below. described below.
......
...@@ -10,6 +10,9 @@ ...@@ -10,6 +10,9 @@
.. moduleauthor:: Lars Gustäbel <lars@gustaebel.de> .. moduleauthor:: Lars Gustäbel <lars@gustaebel.de>
.. sectionauthor:: Lars Gustäbel <lars@gustaebel.de> .. sectionauthor:: Lars Gustäbel <lars@gustaebel.de>
**Source code:** :source:`Lib/tarfile.py`
--------------
The :mod:`tarfile` module makes it possible to read and write tar The :mod:`tarfile` module makes it possible to read and write tar
archives, including those using gzip or bz2 compression. archives, including those using gzip or bz2 compression.
......
:mod:`telnetlib` --- Telnet client :mod:`telnetlib` --- Telnet client
================================== ==================================
...@@ -9,6 +8,10 @@ ...@@ -9,6 +8,10 @@
.. index:: single: protocol; Telnet .. index:: single: protocol; Telnet
**Source code:** :source:`Lib/telnetlib.py`
--------------
The :mod:`telnetlib` module provides a :class:`Telnet` class that implements the The :mod:`telnetlib` module provides a :class:`Telnet` class that implements the
Telnet protocol. See :rfc:`854` for details about the protocol. In addition, it Telnet protocol. See :rfc:`854` for details about the protocol. In addition, it
provides symbolic constants for the protocol characters (see below), and for the provides symbolic constants for the protocol characters (see below), and for the
......
:mod:`tempfile` --- Generate temporary files and directories :mod:`tempfile` --- Generate temporary files and directories
============================================================ ============================================================
...@@ -13,6 +12,10 @@ ...@@ -13,6 +12,10 @@
pair: temporary; file name pair: temporary; file name
pair: temporary; file pair: temporary; file
**Source code:** :source:`Lib/tempfile.py`
--------------
This module generates temporary files and directories. It works on all This module generates temporary files and directories. It works on all
supported platforms. supported platforms.
......
:mod:`textwrap` --- Text wrapping and filling :mod:`textwrap` --- Text wrapping and filling
============================================= =============================================
...@@ -7,20 +6,18 @@ ...@@ -7,20 +6,18 @@
.. moduleauthor:: Greg Ward <gward@python.net> .. moduleauthor:: Greg Ward <gward@python.net>
.. sectionauthor:: Greg Ward <gward@python.net> .. sectionauthor:: Greg Ward <gward@python.net>
.. versionadded:: 2.3 .. versionadded:: 2.3
**Source code:** :source:`Lib/textwrap.py`
--------------
The :mod:`textwrap` module provides two convenience functions, :func:`wrap` and The :mod:`textwrap` module provides two convenience functions, :func:`wrap` and
:func:`fill`, as well as :class:`TextWrapper`, the class that does all the work, :func:`fill`, as well as :class:`TextWrapper`, the class that does all the work,
and a utility function :func:`dedent`. If you're just wrapping or filling one and a utility function :func:`dedent`. If you're just wrapping or filling one
or two text strings, the convenience functions should be good enough; or two text strings, the convenience functions should be good enough;
otherwise, you should use an instance of :class:`TextWrapper` for efficiency. otherwise, you should use an instance of :class:`TextWrapper` for efficiency.
.. seealso::
Latest version of the `textwrap module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/textwrap.py?view=markup>`_
.. function:: wrap(text[, width[, ...]]) .. function:: wrap(text[, width[, ...]])
Wraps the single paragraph in *text* (a string) so every line is at most *width* Wraps the single paragraph in *text* (a string) so every line is at most *width*
......
...@@ -4,6 +4,9 @@ ...@@ -4,6 +4,9 @@
.. module:: threading .. module:: threading
:synopsis: Higher-level threading interface. :synopsis: Higher-level threading interface.
**Source code:** :source:`Lib/threading.py`
--------------
This module constructs higher-level threading interfaces on top of the lower This module constructs higher-level threading interfaces on top of the lower
level :mod:`thread` module. level :mod:`thread` module.
...@@ -36,11 +39,6 @@ The :mod:`dummy_threading` module is provided for situations where ...@@ -36,11 +39,6 @@ The :mod:`dummy_threading` module is provided for situations where
:mod:`multiprocessing`. However, threading is still an appropriate model :mod:`multiprocessing`. However, threading is still an appropriate model
if you want to run multiple I/O-bound tasks simultaneously. if you want to run multiple I/O-bound tasks simultaneously.
.. seealso::
Latest version of the `threading module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/threading.py?view=markup>`_
This module defines the following functions and objects: This module defines the following functions and objects:
......
:mod:`timeit` --- Measure execution time of small code snippets :mod:`timeit` --- Measure execution time of small code snippets
=============================================================== ===============================================================
...@@ -12,6 +11,10 @@ ...@@ -12,6 +11,10 @@
single: Benchmarking single: Benchmarking
single: Performance single: Performance
**Source code:** :source:`Lib/timeit.py`
--------------
This module provides a simple way to time small bits of Python code. It has both This module provides a simple way to time small bits of Python code. It has both
command line as well as callable interfaces. It avoids a number of common traps command line as well as callable interfaces. It avoids a number of common traps
for measuring execution times. See also Tim Peters' introduction to the for measuring execution times. See also Tim Peters' introduction to the
......
:mod:`token` --- Constants used with Python parse trees :mod:`token` --- Constants used with Python parse trees
======================================================= =======================================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Constants representing terminal nodes of the parse tree. :synopsis: Constants representing terminal nodes of the parse tree.
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/token.py`
--------------
This module provides constants which represent the numeric values of leaf nodes This module provides constants which represent the numeric values of leaf nodes
of the parse tree (terminal tokens). Refer to the file :file:`Grammar/Grammar` of the parse tree (terminal tokens). Refer to the file :file:`Grammar/Grammar`
......
:mod:`tokenize` --- Tokenizer for Python source :mod:`tokenize` --- Tokenizer for Python source
=============================================== ===============================================
...@@ -7,17 +6,15 @@ ...@@ -7,17 +6,15 @@
.. moduleauthor:: Ka Ping Yee .. moduleauthor:: Ka Ping Yee
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/tokenize.py`
--------------
The :mod:`tokenize` module provides a lexical scanner for Python source code, The :mod:`tokenize` module provides a lexical scanner for Python source code,
implemented in Python. The scanner in this module returns comments as tokens as implemented in Python. The scanner in this module returns comments as tokens as
well, making it useful for implementing "pretty-printers," including colorizers well, making it useful for implementing "pretty-printers," including colorizers
for on-screen displays. for on-screen displays.
.. seealso::
Latest version of the `tokenize module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/tokenize.py?view=markup>`_
The primary entry point is a :term:`generator`: The primary entry point is a :term:`generator`:
.. function:: generate_tokens(readline) .. function:: generate_tokens(readline)
......
:mod:`trace` --- Trace or track Python statement execution :mod:`trace` --- Trace or track Python statement execution
========================================================== ==========================================================
.. module:: trace .. module:: trace
:synopsis: Trace or track Python statement execution. :synopsis: Trace or track Python statement execution.
**Source code:** :source:`Lib/trace.py`
--------------
The :mod:`trace` module allows you to trace program execution, generate The :mod:`trace` module allows you to trace program execution, generate
annotated statement coverage listings, print caller/callee relationships and annotated statement coverage listings, print caller/callee relationships and
list functions executed during a program run. It can be used in another program list functions executed during a program run. It can be used in another program
or from the command line. or from the command line.
.. seealso::
Latest version of the `trace module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/trace.py?view=markup>`_
.. _trace-cli: .. _trace-cli:
Command-Line Usage Command-Line Usage
......
...@@ -4,6 +4,9 @@ ...@@ -4,6 +4,9 @@
.. module:: types .. module:: types
:synopsis: Names for built-in types. :synopsis: Names for built-in types.
**Source code:** :source:`Lib/types.py`
--------------
This module defines names for some object types that are used by the standard This module defines names for some object types that are used by the standard
Python interpreter, but not for the types defined by various extension modules. Python interpreter, but not for the types defined by various extension modules.
......
...@@ -17,6 +17,9 @@ ...@@ -17,6 +17,9 @@
The :term:`2to3` tool will automatically adapt imports when converting The :term:`2to3` tool will automatically adapt imports when converting
your sources to 3.0. your sources to 3.0.
**Source code:** :source:`Lib/urlparse.py`
--------------
This module defines a standard interface to break Uniform Resource Locator (URL) This module defines a standard interface to break Uniform Resource Locator (URL)
strings up in components (addressing scheme, network location, path etc.), to strings up in components (addressing scheme, network location, path etc.), to
...@@ -33,11 +36,6 @@ following URL schemes: ``file``, ``ftp``, ``gopher``, ``hdl``, ``http``, ...@@ -33,11 +36,6 @@ following URL schemes: ``file``, ``ftp``, ``gopher``, ``hdl``, ``http``,
.. versionadded:: 2.5 .. versionadded:: 2.5
Support for the ``sftp`` and ``sips`` schemes. Support for the ``sftp`` and ``sips`` schemes.
.. seealso::
Latest version of the `urlparse module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/urlparse.py?view=markup>`_
The :mod:`urlparse` module defines the following functions: The :mod:`urlparse` module defines the following functions:
......
:mod:`UserDict` --- Class wrapper for dictionary objects :mod:`UserDict` --- Class wrapper for dictionary objects
======================================================== ========================================================
...@@ -6,6 +5,10 @@ ...@@ -6,6 +5,10 @@
:synopsis: Class wrapper for dictionary objects. :synopsis: Class wrapper for dictionary objects.
**Source code:** :source:`Lib/UserDict.py`
--------------
The module defines a mixin, :class:`DictMixin`, defining all dictionary methods The module defines a mixin, :class:`DictMixin`, defining all dictionary methods
for classes that already have a minimum mapping interface. This greatly for classes that already have a minimum mapping interface. This greatly
simplifies writing classes that need to be substitutable for dictionaries (such simplifies writing classes that need to be substitutable for dictionaries (such
...@@ -19,11 +22,6 @@ available starting with Python version 2.2). Prior to the introduction of ...@@ -19,11 +22,6 @@ available starting with Python version 2.2). Prior to the introduction of
sub-classes that obtained new behaviors by overriding existing methods or adding sub-classes that obtained new behaviors by overriding existing methods or adding
new ones. new ones.
.. seealso::
Latest version of the `UserDict Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/UserDict.py?view=markup>`_
The :mod:`UserDict` module defines the :class:`UserDict` class and The :mod:`UserDict` module defines the :class:`UserDict` class and
:class:`DictMixin`: :class:`DictMixin`:
......
:mod:`uu` --- Encode and decode uuencode files :mod:`uu` --- Encode and decode uuencode files
============================================== ==============================================
...@@ -6,6 +5,9 @@ ...@@ -6,6 +5,9 @@
:synopsis: Encode and decode files in uuencode format. :synopsis: Encode and decode files in uuencode format.
.. moduleauthor:: Lance Ellinghouse .. moduleauthor:: Lance Ellinghouse
**Source code:** :source:`Lib/uu.py`
--------------
This module encodes and decodes files in uuencode format, allowing arbitrary This module encodes and decodes files in uuencode format, allowing arbitrary
binary data to be transferred over ASCII-only connections. Wherever a file binary data to be transferred over ASCII-only connections. Wherever a file
...@@ -22,11 +24,6 @@ that, when required, the mode is ``'rb'`` or ``'wb'`` on Windows. ...@@ -22,11 +24,6 @@ that, when required, the mode is ``'rb'`` or ``'wb'`` on Windows.
This code was contributed by Lance Ellinghouse, and modified by Jack Jansen. This code was contributed by Lance Ellinghouse, and modified by Jack Jansen.
.. seealso::
Latest version of the `uu module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/uu.py?view=markup>`_
The :mod:`uu` module defines the following functions: The :mod:`uu` module defines the following functions:
...@@ -62,4 +59,3 @@ The :mod:`uu` module defines the following functions: ...@@ -62,4 +59,3 @@ The :mod:`uu` module defines the following functions:
Module :mod:`binascii` Module :mod:`binascii`
Support module containing ASCII-to-binary and binary-to-ASCII conversions. Support module containing ASCII-to-binary and binary-to-ASCII conversions.
...@@ -9,6 +9,10 @@ ...@@ -9,6 +9,10 @@
.. versionadded:: 2.1 .. versionadded:: 2.1
**Source code:** :source:`Lib/warnings.py`
--------------
Warning messages are typically issued in situations where it is useful to alert Warning messages are typically issued in situations where it is useful to alert
the user of some condition in a program, where that condition (normally) doesn't the user of some condition in a program, where that condition (normally) doesn't
warrant raising an exception and terminating the program. For example, one warrant raising an exception and terminating the program. For example, one
......
...@@ -6,6 +6,10 @@ ...@@ -6,6 +6,10 @@
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il> .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
.. Documentations stolen from comments in file. .. Documentations stolen from comments in file.
**Source code:** :source:`Lib/wave.py`
--------------
The :mod:`wave` module provides a convenient interface to the WAV sound format. The :mod:`wave` module provides a convenient interface to the WAV sound format.
It does not support compression/decompression, but it does support mono/stereo. It does not support compression/decompression, but it does support mono/stereo.
......
...@@ -11,6 +11,10 @@ ...@@ -11,6 +11,10 @@
.. versionadded:: 2.1 .. versionadded:: 2.1
**Source code:** :source:`Lib/weakref.py`
--------------
The :mod:`weakref` module allows the Python programmer to create :dfn:`weak The :mod:`weakref` module allows the Python programmer to create :dfn:`weak
references` to objects. references` to objects.
......
:mod:`webbrowser` --- Convenient Web-browser controller :mod:`webbrowser` --- Convenient Web-browser controller
======================================================= =======================================================
...@@ -7,6 +6,9 @@ ...@@ -7,6 +6,9 @@
.. moduleauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. moduleauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
**Source code:** :source:`Lib/webbrowser.py`
--------------
The :mod:`webbrowser` module provides a high-level interface to allow displaying The :mod:`webbrowser` module provides a high-level interface to allow displaying
Web-based documents to users. Under most circumstances, simply calling the Web-based documents to users. Under most circumstances, simply calling the
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment