summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew M. Kuchling <amk@amk.ca>2010-05-06 01:10:56 (GMT)
committerAndrew M. Kuchling <amk@amk.ca>2010-05-06 01:10:56 (GMT)
commitca4856249dd2c7c469abceeff4aee9a4987b4643 (patch)
treebb37c17a7cc10f09197ff868b81e07838915e71b
parent4758183f0af7443f500a26c4f6444b1a949c7255 (diff)
downloadcpython-ca4856249dd2c7c469abceeff4aee9a4987b4643.zip
cpython-ca4856249dd2c7c469abceeff4aee9a4987b4643.tar.gz
cpython-ca4856249dd2c7c469abceeff4aee9a4987b4643.tar.bz2
Add various items
-rw-r--r--Doc/whatsnew/2.7.rst46
1 files changed, 39 insertions, 7 deletions
diff --git a/Doc/whatsnew/2.7.rst b/Doc/whatsnew/2.7.rst
index 860c90a..cc073c2 100644
--- a/Doc/whatsnew/2.7.rst
+++ b/Doc/whatsnew/2.7.rst
@@ -8,8 +8,7 @@
.. Fix accents on Kristjan Valur Jonsson, Fuerstenau
-.. Big jobs: ElementTree 1.3, pep 391, sysconfig
-.. unittest test discovery
+.. Big jobs: ElementTree 1.3, pep 391
.. hyperlink all the methods & functions.
.. T_STRING_INPLACE not described in main docs
@@ -1217,6 +1216,20 @@ changes, or look through the Subversion logs for all the details.
now accept an optional *flags* argument, for consistency with the
other functions in the module. (Added by Gregory P. Smith.)
+* New function: :func:`~runpy.run_path` in the :mod:`runpy` module
+ will execute the code at a provided *path* argument. *path* can be
+ the path of a Python source file (:file:`example.py`), a compiled
+ bytecode file (:file:`example.pyc`), a directory
+ (:file:`./package/'), or a zip archive (:file:`example.zip`). If a
+ directory or zip path is provided, it will be added to the front of
+ ``sys.path`` and the module :mod:`__main__` will be imported. It's
+ expected that the directory or zip contains a :file:`__main__.py`;
+ if it doesn't, some other :file:`__main__.py` might be imported from
+ a location later in ``sys.path``. This makes some of the machinery
+ of :mod:`runpy` available to scripts that want to mimic the behaviour
+ of Python's :option:`-m` switch. (Added by Nick Coghlan;
+ :issue:`6816`.)
+
* New function: in the :mod:`shutil` module, :func:`~shutil.make_archive`
takes a filename, archive type (zip or tar-format), and a directory
path, and creates an archive containing the directory's contents.
@@ -1443,12 +1456,31 @@ changes, or look through the Subversion logs for all the details.
New module: sysconfig
---------------------------------
-XXX A new :mod:`sysconfig` module has been extracted from
-:mod:`distutils` and put in the standard library.
+The :mod:`sysconfig` module has been pulled out of the Distutils
+package, becoming a new top-level module in its own right.
+:mod:`sysconfig` provides functions for getting information about
+Python's build process: compiler switches, installation paths, the
+platform name, and whether Python is running from its source
+directory.
+
+Some of the functions in the module are:
+
+* :func:`~sysconfig.get_config_var` returns variables from Python's
+ Makefile and the :file:`pyconfig.h` file.
+* :func:`~sysconfig.get_config_vars` returns a dictionary containing
+ all of the configuration variables.
+* :func:`~sysconfig.getpath` returns the configured path for
+ a particular type of module: the standard library,
+ site-specific modules, platform-specific modules, etc.
+* :func:`~sysconfig.is_python_build` returns true if you're running a
+ binary from a Python source tree, and false otherwise.
+
+Consult the :mod:`sysconfig` documentation for more details and for
+a complete list of functions.
+
+The Distutils package and :mod:`sysconfig` are now maintained and
+renamed by Tarek Ziadé.
-The :mod:`sysconfig` module provides access to Python's configuration
-information like the list of installation paths and the configuration
-variables relevant for the current platform. (contributed by Tarek)
Updated module: ElementTree 1.3
---------------------------------