classification
Title: Document importlib.abc.Finder as deprecated
Type: Stage: resolved
Components: Documentation Versions: Python 3.3
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: brett.cannon Nosy List: asvetlov, barry, brett.cannon, eric.snow, ncoghlan, python-dev
Priority: normal Keywords:

Created on 2012-08-13 19:47 by brett.cannon, last changed 2012-08-17 18:08 by brett.cannon. This issue is now closed.

Messages (2)
msg168138 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2012-08-13 19:47
importlib.abc.Finder is no longer the proper level of abstraction for either meta path finders or path entry finders, so direct inheritance should be discouraged by documenting deprecation for the class (actual deprecation will need to be avoided as the constructor gets involved and having that error out if someone sets warnings to errors would be bad). Should probably also document as deprecated importlib.abc.PathEntryFinder.find_module().

Also need to remember to update the inheritance hierarchy now added to the docs with a note next to the class about the deprecation (along with PyLoader and PyPycLoader).
msg168454 - (view) Author: Roundup Robot (python-dev) Date: 2012-08-17 18:08
New changeset 4bbb1ff4f7ea by Brett Cannon in branch 'default':
Issue #15640: Document importlib.abc.Finder as deprecated.
http://hg.python.org/cpython/rev/4bbb1ff4f7ea
History
Date User Action Args
2012-08-17 18:08:52brett.cannonsetstatus: open -> closed
resolution: fixed
stage: needs patch -> resolved
2012-08-17 18:08:31python-devsetnosy: + python-dev
messages: + msg168454
2012-08-17 16:28:09asvetlovsetnosy: + asvetlov
2012-08-13 19:47:27brett.cannonsettitle: Document deprecate importlib.abc.Finder -> Document importlib.abc.Finder as deprecated
2012-08-13 19:47:17brett.cannoncreate