changeset: 84136:32067804942e
user: Brett Cannon <brett@python.org>
date: Fri Jun 14 22:35:40 2013 -0400
files: Lib/imp.py Misc/NEWS
description:
Issue #18194: Introduce importlib.util.cache_from_source() and
source_from_cache(), finishing the work introduced in changset
4134:9cacdb9d0c59.
diff -r 7bb54aa762e1 -r 32067804942e Lib/imp.py
--- a/Lib/imp.py	Fri Jun 14 22:29:58 2013 -0400
+++ b/Lib/imp.py	Fri Jun 14 22:35:40 2013 -0400
@@ -16,8 +16,7 @@
 # Platform doesn't support dynamic loading.
 load_dynamic = None
 
-from importlib._bootstrap import (cache_from_source, source_from_cache,
- SourcelessFileLoader, _ERR_MSG)
+from importlib._bootstrap import SourcelessFileLoader, _ERR_MSG
 
 from importlib import machinery
 from importlib import util
@@ -66,6 +65,38 @@
 return sys.implementation.cache_tag
 
 
+def cache_from_source(path, debug_override=None):
+ """**DEPRECATED**
+
+ Given the path to a .py file, return the path to its .pyc/.pyo file.
+
+ The .py file does not need to exist; this simply returns the path to the
+ .pyc/.pyo file calculated as if the .py file were imported. The extension
+ will be .pyc unless sys.flags.optimize is non-zero, then it will be .pyo.
+
+ If debug_override is not None, then it must be a boolean and is used in
+ place of sys.flags.optimize.
+
+ If sys.implementation.cache_tag is None then NotImplementedError is raised.
+
+ """
+ return util.cache_from_source(path, debug_override)
+
+
+def source_from_cache(path):
+ """**DEPRECATED**
+
+ Given the path to a .pyc./.pyo file, return the path to its .py file.
+
+ The .pyc/.pyo file does not need to exist; this simply returns the path to
+ the .py file calculated to correspond to the .pyc/.pyo file. If path does
+ not conform to PEP 3147 format, ValueError will be raised. If
+ sys.implementation.cache_tag is None then NotImplementedError is raised.
+
+ """
+ return util.source_from_cache(path)
+
+
 def get_suffixes():
 warnings.warn('imp.get_suffixes() is deprecated; use the constants '
 'defined on importlib.machinery instead',
diff -r 7bb54aa762e1 -r 32067804942e Misc/NEWS
--- a/Misc/NEWS	Fri Jun 14 22:29:58 2013 -0400
+++ b/Misc/NEWS	Fri Jun 14 22:35:40 2013 -0400
@@ -123,6 +123,10 @@
 Library
 -------
 
+- Issue #18194: Introduce importlib.util.cache_from_source() and
+ source_from_cache() while documenting the equivalent functions in imp as
+ deprecated.
+
 - Issue #17907: Document imp.new_module() as deprecated in favour of
 types.ModuleType.
 
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://hg.python.org/cpython/rev/32067804942e">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://hg.python.org/cpython/rev/32067804942e" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>