[Python-checkins] cpython (3.4): #23891: describe a few more modules in the tutorial

[andrew.kuchling]

https://hg.python.org/cpython/rev/a18615eb5aec
changeset:   96550:a18615eb5aec
branch:      3.4
parent:      96544:da642b5aaf79
user:        Andrew Kuchling <amk at amk.ca>
date:        Thu Apr 09 22:20:01 2015 -0400
summary:
  #23891: describe a few more modules in the tutorial

files:
  Doc/tutorial/stdlib.rst |  31 ++++++++++++++++++++++------
  1 files changed, 24 insertions(+), 7 deletions(-)


diff --git a/Doc/tutorial/stdlib.rst b/Doc/tutorial/stdlib.rst
--- a/Doc/tutorial/stdlib.rst
+++ b/Doc/tutorial/stdlib.rst
@@ -140,6 +140,18 @@
    >>> random.randrange(6)    # random integer chosen from range(6)
    4
 
+The :mod:`statistics` module calculates basic statistical properties
+(the mean, median, variance, etc.) of numeric data::
+
+    >>> import statistics
+    >>> data = [2.75, 1.75, 1.25, 0.25, 0.5, 1.25, 3.5]
+    >>> statistics.mean(data)
+    1.6071428571428572
+    >>> statistics.median(data)
+    1.25
+    >>> statistics.variance(data)
+    1.3720238095238095
+
 The SciPy project <http://scipy.org> has many other modules for numerical
 computations.
 
@@ -311,13 +323,18 @@
   (including attachments) and for implementing internet encoding and header
   protocols.
 
-* The :mod:`xml.dom` and :mod:`xml.sax` packages provide robust support for
-  parsing this popular data interchange format. Likewise, the :mod:`csv` module
-  supports direct reads and writes in a common database format. Together, these
-  modules and packages greatly simplify data interchange between Python
-  applications and other tools.
+* The :mod:`json` package provides robust support for parsing this
+  popular data interchange format.  The :mod:`csv` module supports
+  direct reading and writing of files in Comma-Separated Value format,
+  commonly supported by databases and spreadsheets.  XML processing is
+  supported by the :mod:`xml.etree.ElementTree`, :mod:`xml.dom` and
+  :mod:`xml.sax` packages. Together, these modules and packages
+  greatly simplify data interchange between Python applications and
+  other tools.
+
+* The :mod:`sqlite3` module is a wrapper for the SQLite database
+  library, providing a persistent database that can be updated and
+  accessed using slightly nonstandard SQL syntax.
 
 * Internationalization is supported by a number of modules including
   :mod:`gettext`, :mod:`locale`, and the :mod:`codecs` package.
-
-

-- 
Repository URL: https://hg.python.org/cpython