This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: More documentation for the imp module
Type: enhancement Stage: needs patch
Components: Documentation Versions: Python 3.1, Python 2.7
process
Status: closed Resolution: wont fix
Dependencies: Superseder:
Assigned To: brett.cannon Nosy List: brett.cannon, facundobatista, jhorneman, jvr, rhettinger
Priority: low Keywords:

Created on 2002-09-29 19:58 by jhorneman, last changed 2022-04-10 16:05 by admin. This issue is now closed.

Messages (4)
msg53633 - (view) Author: Jurie Horneman (jhorneman) Date: 2002-09-29 19:58
Not all of the public functions of the imp module appear to be 
documented (in section 3.21, Python version 
2.2).

get_frozen_object
load_package
PY_CODERESOURCE

are 
not documented.

Also, the documentation for 
load_module() can be a bit confusing, partially due to inconsistent 
use of the word pairs 'tuple' / 'triple' and 'pathname' / 
'filename'.

(I did not need the abovementioned public 
functions, but while struggling with this module I noticed them and 
wondered if the documentation was outdated, or whether they held 
the key to my success.)
msg53634 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2003-07-12 04:14
Logged In: YES 
user_id=80475

I believe both functions are obsolete and are subsumed by 
load_module() and find_module().  I don't know about 
Py_CODERESOURCE (it is MacIntosh specific).

Referring to jvr for disposition on the first two and then to 
Jack for the third.
msg60141 - (view) Author: Facundo Batista (facundobatista) * (Python committer) Date: 2008-01-19 10:43
If those two are obsolete, we may add a DeprecationWarning in 2.6 and
hide/remove them in 2.7.

What do you think?
msg85170 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2009-04-02 05:43
As Raymond pointed out, people should not use the undocumented
functions. Deprecation should be a separate issue.
History
Date User Action Args
2022-04-10 16:05:42adminsetgithub: 37237
2009-04-02 05:43:21brett.cannonsetstatus: open -> closed
resolution: wont fix
messages: + msg85170
2009-02-11 03:13:50brett.cannonsetstage: needs patch
2009-02-11 01:27:08ajaksu2setassignee: jvr -> brett.cannon
nosy: + brett.cannon
versions: + Python 3.1, Python 2.7, - Python 2.6, Python 3.0
2008-01-19 10:43:48facundobatistasetnosy: + facundobatista
messages: + msg60141
2008-01-05 16:18:43christian.heimessetpriority: normal -> low
versions: + Python 2.6, Python 3.0
2002-09-29 19:58:55jhornemancreate