[Python-checkins] cpython (merge 3.2 -> default): Merge #15230 doc updates from 3.2
nick.coghlan
python-checkins at python.org
Sat Jul 14 16:39:01 CEST 2012
http://hg.python.org/cpython/rev/416cd57d38cf
changeset: 78097:416cd57d38cf
parent: 78095:8a44e7c0fa30
parent: 78096:4880aac5c665
user: Nick Coghlan <ncoghlan at gmail.com>
date: Sun Jul 15 00:38:43 2012 +1000
summary:
Merge #15230 doc updates from 3.2
files:
Doc/library/runpy.rst | 11 +++++++++++
Misc/NEWS | 5 ++++-
2 files changed, 15 insertions(+), 1 deletions(-)
diff --git a/Doc/library/runpy.rst b/Doc/library/runpy.rst
--- a/Doc/library/runpy.rst
+++ b/Doc/library/runpy.rst
@@ -14,6 +14,15 @@
line switch that allows scripts to be located using the Python module
namespace rather than the filesystem.
+Note that this is *not* a sandbox module - all code is executed in the
+current process, and any side effects (such as cached imports of other
+modules) will remain in place after the functions have returned.
+
+Furthermore, any functions and classes defined by the executed code are not
+guaranteed to work correctly after a :mod:`runpy` function has returned.
+If that limitation is not acceptable for a given use case, :mod:`importlib`
+is likely to be a more suitable choice than this module.
+
The :mod:`runpy` module provides two functions:
@@ -141,3 +150,5 @@
PEP written and implemented by Nick Coghlan.
:ref:`using-on-general` - CPython command line details
+
+ The :func:`importlib.import_module` function
diff --git a/Misc/NEWS b/Misc/NEWS
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -122,6 +122,9 @@
Documentation
-------------
+- Issue #15230: Clearly document some of the limitations of the runpy
+ module and nudge readers towards importlib when appropriate.
+
- Issue #15053: Copy Python 3.3 import lock change notice to all relevant
functions in imp instead of just at the top of the relevant section.
@@ -1184,12 +1187,12 @@
Based on patch from Hervé Coatanhay.
- Issue #14321: Do not run pgen during the build if files are up to date.
+
Documentation
-------------
- Issue #14034: added the argparse tutorial.
-
- Issue #14324: Fix configure tests for cross builds.
- Issue #14327: Call AC_CANONICAL_HOST in configure.ac and check in
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list