From fa191901ac9d9e306315b1d5c06e3757c0c6c322 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Wed, 19 Mar 2008 20:20:37 +0000 Subject: [PATCH] Add all Mac modules for deprecation along with everything from PEP 4. --- pep-3108.txt | 183 +++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 135 insertions(+), 48 deletions(-) diff --git a/pep-3108.txt b/pep-3108.txt index 3716e6973..48735e6f2 100644 --- a/pep-3108.txt +++ b/pep-3108.txt @@ -92,6 +92,32 @@ The entire contents of lib-old will also be removed. These modules have already been removed from being imported but are kept in the distribution for Python for users that rely upon the code. +* buildtools + +* cfmfile + +* cl + +* md5 + +* mimetools + +* MimeWriter + +* mimify + +* multifile + +* posixfile + +* rfc822 + +* sha + +* sv + +* timing + Platform-specific with minimal use ---------------------------------- @@ -161,54 +187,6 @@ their maintenance. - Access to the sound card on Sun machines. - Code not uniquely edited in over eight years. -* Mac - - + aetools/aepack/aetypes/MiniAEFrame - - - OSA support is better through third-party modules. - - * Appscript [#appscript]_. - - - Hard-coded endianness which breaks on Intel Macs. - - Might need to rename if Carbon package dependent. - - + applesingle - - - Undocumented. - - AppleSingle is a binary file format for A/UX. - - A/UX no longer distributed. - - + autoGIL - - - Very bad model for using Python with the CFRunLoop. - - Rename to _autogil if needed by Carbon package. - - + Carbon.CF - - - Half-heared attempt. - - + findertools - - - No longer useful. - - + FrameWork - - - Poorly documented. - - Not updated to support Carbon Events. - - + icopen - - - Not needed on OS X. - - Meant to replace 'open' which is usually a bad thing to do. - - + videoreader - - - No longer used. - - + W - - - No longer distributed with Python. - Hardly used ------------ @@ -385,6 +363,115 @@ for what the module is meant for. * UserList/UserString [done] + Not useful since types can be a superclass. + + +Mac-specific modules +//////////////////// + +Thanks to both Apple including Python with OS X and PyObjC_, +the included Mac modules in Python are obsolete. +Apple's Cocoa API will always be more up-to-date than Python's own +attempt at maintaining wrappers. Plus Apple can be expected to +include useful Mac-only modules that third-parties do not provide. + +* aepack + + - OSA support is better through third-party modules. + + * Appscript [#appscript]_. + + - Hard-coded endianness which breaks on Intel Macs. + - Might need to rename if Carbon package dependent. + +* aetools + + - See aepack. + +* aetypes + + - See aepack. + +* applesingle + + - Undocumented. + - AppleSingle is a binary file format for A/UX. + - A/UX no longer distributed. + +* autoGIL + + - Very bad model for using Python with the CFRunLoop. + +* Carbon + + - Carbon development has stopped. + - Does not support 64-bit systems completely. + - Dependent on bgen which has never been updated to support UCS-4 + Unicode builds of Python. + +* ColorPicker + + - Better to use Cocoa for GUIs. + +* EasyDialogs + + - Better to use Cocoa for GUIs. + +* findertools + + - No longer useful. + +* FrameWork + + - Poorly documented. + - Not updated to support Carbon Events. + +* gensuitemodule + + - See aepack. + +* ic + +* icopen + + - Not needed on OS X. + - Meant to replace 'open' which is usually a bad thing to do. + +* macerrors + + - Undocumented. + +* MacOS + + - Would also mean the removal of binhex. + +* macostools + +* macresource + + - Undocumented. + +* MiniAEFrame + + - See aepack. + +* Nav + + - Undocumented. + +* PixMapWrapper + + - Undocumented. + +* videoreader + + - No longer used. + +* W + + - No longer distributed with Python. + + +.. _PyObjC: http://pyobjc.sourceforge.net/ Modules to Rename