Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Add warnings to and deprecated all those Mac modules

This commit is contained in:
Benjamin Peterson 2008-05-12 21:42:13 +00:00
parent f9b54c2411
commit 236819310d
59 changed files with 286 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Doc/library/aepack.rst
View File

@ -5,6 +5,7 @@
.. module:: aepack .. module:: aepack
:platform: Mac :platform: Mac
:synopsis: Conversion between Python variables and AppleEvent data containers. :synopsis: Conversion between Python variables and AppleEvent data containers.
:deprecated:
.. sectionauthor:: Vincent Marchetti <vincem@en.com> .. sectionauthor:: Vincent Marchetti <vincem@en.com>
.. moduleauthor:: Jack Jansen .. moduleauthor:: Jack Jansen
@ -13,6 +14,11 @@ variables to AppleEvent descriptors and back (unpacking). Within Python the
AppleEvent descriptor is handled by Python objects of built-in type AppleEvent descriptor is handled by Python objects of built-in type
:class:`AEDesc`, defined in module :mod:`Carbon.AE`. :class:`AEDesc`, defined in module :mod:`Carbon.AE`.
.. warning::
This module is removed in 3.0.
The :mod:`aepack` module defines the following functions: The :mod:`aepack` module defines the following functions:

6
Doc/library/aetools.rst
View File

@ -5,6 +5,7 @@
.. module:: aetools .. module:: aetools
:platform: Mac :platform: Mac
:synopsis: Basic support for sending Apple Events :synopsis: Basic support for sending Apple Events
:deprecated:
.. sectionauthor:: Jack Jansen <Jack.Jansen@cwi.nl> .. sectionauthor:: Jack Jansen <Jack.Jansen@cwi.nl>
.. moduleauthor:: Jack Jansen .. moduleauthor:: Jack Jansen
@ -21,6 +22,11 @@ The :mod:`aetools` module itself uses the AppleEvent support provided by the
manager, see section :ref:`osx-gui-scripts` for details. This restriction may be manager, see section :ref:`osx-gui-scripts` for details. This restriction may be
lifted in future releases. lifted in future releases.
.. warning::
This module is removed in 3.0.
The :mod:`aetools` module defines the following functions: The :mod:`aetools` module defines the following functions:

7
Doc/library/aetypes.rst
View File

@ -5,6 +5,7 @@
.. module:: aetypes .. module:: aetypes
:platform: Mac :platform: Mac
:synopsis: Python representation of the Apple Event Object Model. :synopsis: Python representation of the Apple Event Object Model.
:deprecated:
.. sectionauthor:: Vincent Marchetti <vincem@en.com> .. sectionauthor:: Vincent Marchetti <vincem@en.com>
.. moduleauthor:: Jack Jansen .. moduleauthor:: Jack Jansen
@ -30,6 +31,12 @@ application for which you have not generated the stub package this module also
contains object specifiers for a number of common OSA classes such as contains object specifiers for a number of common OSA classes such as
``Document``, ``Window``, ``Character``, etc. ``Document``, ``Window``, ``Character``, etc.
.. warning::
This module is removed in 3.0.
The :mod:`AEObjects` module defines the following classes to represent Apple The :mod:`AEObjects` module defines the following classes to represent Apple
Event descriptor data: Event descriptor data:

5
Doc/library/autogil.rst
View File

@ -5,6 +5,7 @@
.. module:: autoGIL .. module:: autoGIL
:platform: Mac :platform: Mac
:synopsis: Global Interpreter Lock handling in event loops. :synopsis: Global Interpreter Lock handling in event loops.
:deprecated:
.. moduleauthor:: Just van Rossum <just@letterror.com> .. moduleauthor:: Just van Rossum <just@letterror.com>
@ -12,6 +13,10 @@ The :mod:`autoGIL` module provides a function :func:`installAutoGIL` that
automatically locks and unlocks Python's :term:`Global Interpreter Lock` when automatically locks and unlocks Python's :term:`Global Interpreter Lock` when
running an event loop. running an event loop.
.. warning::
This module is removed in 3.0.
.. exception:: AutoGILError .. exception:: AutoGILError

5
Doc/library/binhex.rst
View File

@ -11,6 +11,11 @@ representation of Macintosh files in ASCII. On the Macintosh, both forks of a
file and the finder information are encoded (or decoded), on other platforms file and the finder information are encoded (or decoded), on other platforms
only the data fork is handled. only the data fork is handled.
.. warning::
In 3.0, special Macintosh support is removed.
The :mod:`binhex` module defines the following functions: The :mod:`binhex` module defines the following functions:

31
Doc/library/carbon.rst
View File

@ -22,8 +22,9 @@ framework and Qt is in the QuickTime framework. The normal use pattern is ::
from Carbon import AE from Carbon import AE
**Warning!** These modules are not yet documented. If you wish to contribute .. warning::
documentation of any of these modules, please get in touch with docs@python.org.
The Carbon modules are removed in 3.0.
:mod:`Carbon.AE` --- Apple Events :mod:`Carbon.AE` --- Apple Events
@ -32,6 +33,7 @@ documentation of any of these modules, please get in touch with docs@python.org.
.. module:: Carbon.AE .. module:: Carbon.AE
:platform: Mac :platform: Mac
:synopsis: Interface to the Apple Events toolbox. :synopsis: Interface to the Apple Events toolbox.
:deprecated:
@ -41,6 +43,7 @@ documentation of any of these modules, please get in touch with docs@python.org.
.. module:: Carbon.AH .. module:: Carbon.AH
:platform: Mac :platform: Mac
:synopsis: Interface to the Apple Help manager. :synopsis: Interface to the Apple Help manager.
:deprecated:
@ -50,6 +53,7 @@ documentation of any of these modules, please get in touch with docs@python.org.
.. module:: Carbon.App .. module:: Carbon.App
:platform: Mac :platform: Mac
:synopsis: Interface to the Appearance Manager. :synopsis: Interface to the Appearance Manager.
:deprecated:
@ -59,6 +63,7 @@ documentation of any of these modules, please get in touch with docs@python.org.
.. module:: Carbon.CF .. module:: Carbon.CF
:platform: Mac :platform: Mac
:synopsis: Interface to the Core Foundation. :synopsis: Interface to the Core Foundation.
:deprecated:
The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
@ -71,6 +76,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.CG .. module:: Carbon.CG
:platform: Mac :platform: Mac
:synopsis: Interface to Core Graphics. :synopsis: Interface to Core Graphics.
:deprecated:
@ -80,6 +86,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.CarbonEvt .. module:: Carbon.CarbonEvt
:platform: Mac :platform: Mac
:synopsis: Interface to the Carbon Event Manager. :synopsis: Interface to the Carbon Event Manager.
:deprecated:
@ -89,6 +96,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Cm .. module:: Carbon.Cm
:platform: Mac :platform: Mac
:synopsis: Interface to the Component Manager. :synopsis: Interface to the Component Manager.
:deprecated:
@ -98,6 +106,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Ctl .. module:: Carbon.Ctl
:platform: Mac :platform: Mac
:synopsis: Interface to the Control Manager. :synopsis: Interface to the Control Manager.
:deprecated:
@ -107,6 +116,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Dlg .. module:: Carbon.Dlg
:platform: Mac :platform: Mac
:synopsis: Interface to the Dialog Manager. :synopsis: Interface to the Dialog Manager.
:deprecated:
@ -116,6 +126,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Evt .. module:: Carbon.Evt
:platform: Mac :platform: Mac
:synopsis: Interface to the classic Event Manager. :synopsis: Interface to the classic Event Manager.
:deprecated:
@ -125,6 +136,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Fm .. module:: Carbon.Fm
:platform: Mac :platform: Mac
:synopsis: Interface to the Font Manager. :synopsis: Interface to the Font Manager.
:deprecated:
@ -134,6 +146,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Folder .. module:: Carbon.Folder
:platform: Mac :platform: Mac
:synopsis: Interface to the Folder Manager. :synopsis: Interface to the Folder Manager.
:deprecated:
@ -143,6 +156,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Help .. module:: Carbon.Help
:platform: Mac :platform: Mac
:synopsis: Interface to the Carbon Help Manager. :synopsis: Interface to the Carbon Help Manager.
:deprecated:
@ -152,6 +166,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.List .. module:: Carbon.List
:platform: Mac :platform: Mac
:synopsis: Interface to the List Manager. :synopsis: Interface to the List Manager.
:deprecated:
@ -161,6 +176,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Menu .. module:: Carbon.Menu
:platform: Mac :platform: Mac
:synopsis: Interface to the Menu Manager. :synopsis: Interface to the Menu Manager.
:deprecated:
@ -170,6 +186,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Mlte .. module:: Carbon.Mlte
:platform: Mac :platform: Mac
:synopsis: Interface to the MultiLingual Text Editor. :synopsis: Interface to the MultiLingual Text Editor.
:deprecated:
@ -179,6 +196,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Qd .. module:: Carbon.Qd
:platform: Mac :platform: Mac
:synopsis: Interface to the QuickDraw toolbox. :synopsis: Interface to the QuickDraw toolbox.
:deprecated:
@ -188,6 +206,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Qdoffs .. module:: Carbon.Qdoffs
:platform: Mac :platform: Mac
:synopsis: Interface to the QuickDraw Offscreen APIs. :synopsis: Interface to the QuickDraw Offscreen APIs.
:deprecated:
@ -197,6 +216,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Qt .. module:: Carbon.Qt
:platform: Mac :platform: Mac
:synopsis: Interface to the QuickTime toolbox. :synopsis: Interface to the QuickTime toolbox.
:deprecated:
@ -206,6 +226,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
.. module:: Carbon.Res .. module:: Carbon.Res
:platform: Mac :platform: Mac
:synopsis: Interface to the Resource Manager and Handles. :synopsis: Interface to the Resource Manager and Handles.
:deprecated:
@ -216,6 +237,7 @@ The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and
:platform: Mac :platform: Mac
:synopsis: The Scrap Manager provides basic services for implementing cut & paste and :synopsis: The Scrap Manager provides basic services for implementing cut & paste and
clipboard operations. clipboard operations.
:deprecated:
This module is only fully available on MacOS9 and earlier under classic PPC This module is only fully available on MacOS9 and earlier under classic PPC
@ -266,6 +288,7 @@ Manager. It contains the following functions:
.. module:: Carbon.Snd .. module:: Carbon.Snd
:platform: Mac :platform: Mac
:synopsis: Interface to the Sound Manager. :synopsis: Interface to the Sound Manager.
:deprecated:
@ -275,6 +298,7 @@ Manager. It contains the following functions:
.. module:: Carbon.TE .. module:: Carbon.TE
:platform: Mac :platform: Mac
:synopsis: Interface to TextEdit. :synopsis: Interface to TextEdit.
:deprecated:
@ -284,5 +308,4 @@ Manager. It contains the following functions:
.. module:: Carbon.Win .. module:: Carbon.Win
:platform: Mac :platform: Mac
:synopsis: Interface to the Window Manager. :synopsis: Interface to the Window Manager.
:deprecated:

5
Doc/library/colorpicker.rst
View File

@ -5,6 +5,7 @@
.. module:: ColorPicker .. module:: ColorPicker
:platform: Mac :platform: Mac
:synopsis: Interface to the standard color selection dialog. :synopsis: Interface to the standard color selection dialog.
:deprecated:
.. moduleauthor:: Just van Rossum <just@letterror.com> .. moduleauthor:: Just van Rossum <just@letterror.com>
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
@ -12,6 +13,10 @@
The :mod:`ColorPicker` module provides access to the standard color picker The :mod:`ColorPicker` module provides access to the standard color picker
dialog. dialog.
.. warning::
This module is removed in 3.0.
.. function:: GetColor(prompt, rgb) .. function:: GetColor(prompt, rgb)

6
Doc/library/easydialogs.rst
View File

@ -5,6 +5,7 @@
.. module:: EasyDialogs .. module:: EasyDialogs
:platform: Mac :platform: Mac
:synopsis: Basic Macintosh dialogs. :synopsis: Basic Macintosh dialogs.
:deprecated:
The :mod:`EasyDialogs` module contains some simple dialogs for the Macintosh. The :mod:`EasyDialogs` module contains some simple dialogs for the Macintosh.
@ -13,6 +14,11 @@ override the :const:`DLOG` resource used for the dialog, provided that the
dialog items correspond (both type and item number) to those in the default dialog items correspond (both type and item number) to those in the default
:const:`DLOG` resource. See source code for details. :const:`DLOG` resource. See source code for details.
.. warning::
This module is removed in 3.0.
The :mod:`EasyDialogs` module defines the following functions: The :mod:`EasyDialogs` module defines the following functions:

5
Doc/library/framework.rst
View File

@ -5,6 +5,7 @@
.. module:: FrameWork .. module:: FrameWork
:platform: Mac :platform: Mac
:synopsis: Interactive application framework. :synopsis: Interactive application framework.
:deprecated:
The :mod:`FrameWork` module contains classes that together provide a framework The :mod:`FrameWork` module contains classes that together provide a framework
@ -15,6 +16,10 @@ often be done on various different levels, i.e. to handle clicks in a single
dialog window in a non-standard way it is not necessary to override the complete dialog window in a non-standard way it is not necessary to override the complete
event handling. event handling.
.. warning::
This module is removed in 3.0.
Work on the :mod:`FrameWork` has pretty much stopped, now that :mod:`PyObjC` is Work on the :mod:`FrameWork` has pretty much stopped, now that :mod:`PyObjC` is
available for full Cocoa access from Python, and the documentation describes available for full Cocoa access from Python, and the documentation describes
only the most important functionality, and not in the most logical manner at only the most important functionality, and not in the most logical manner at

6
Doc/library/ic.rst
View File

@ -5,11 +5,17 @@
.. module:: ic .. module:: ic
:platform: Mac :platform: Mac
:synopsis: Access to the Mac OS X Internet Config. :synopsis: Access to the Mac OS X Internet Config.
:deprecated:
This module provides access to various internet-related preferences set through This module provides access to various internet-related preferences set through
:program:`System Preferences` or the :program:`Finder`. :program:`System Preferences` or the :program:`Finder`.
.. warning::
This module is removed in 3.0.
.. index:: module: icglue .. index:: module: icglue
There is a low-level companion module :mod:`icglue` which provides the basic There is a low-level companion module :mod:`icglue` which provides the basic

4
Doc/library/mac.rst
View File

@ -10,6 +10,10 @@ See the chapters :ref:`mac-scripting` and :ref:`undoc-mac-modules` for more
modules, and the HOWTO :ref:`using-on-mac` for a general introduction to modules, and the HOWTO :ref:`using-on-mac` for a general introduction to
Mac-specific Python programming. Mac-specific Python programming.
.. warning::
These modules are deprecated and are removed in 3.0
.. toctree:: .. toctree::

5
Doc/library/macos.rst
View File

@ -5,12 +5,17 @@
.. module:: MacOS .. module:: MacOS
:platform: Mac :platform: Mac
:synopsis: Access to Mac OS-specific interpreter features. :synopsis: Access to Mac OS-specific interpreter features.
:deprecated:
This module provides access to MacOS specific functionality in the Python This module provides access to MacOS specific functionality in the Python
interpreter, such as how the interpreter eventloop functions and the like. Use interpreter, such as how the interpreter eventloop functions and the like. Use
with care. with care.
.. warning::
This module is removed in 3.0.
Note the capitalization of the module name; this is a historical artifact. Note the capitalization of the module name; this is a historical artifact.

5
Doc/library/macostools.rst
View File

@ -5,6 +5,7 @@
.. module:: macostools .. module:: macostools
:platform: Mac :platform: Mac
:synopsis: Convenience routines for file manipulation. :synopsis: Convenience routines for file manipulation.
:deprecated:
This module contains some convenience routines for file-manipulation on the This module contains some convenience routines for file-manipulation on the
@ -12,6 +13,10 @@ Macintosh. All file parameters can be specified as pathnames, :class:`FSRef` or
:class:`FSSpec` objects. This module expects a filesystem which supports forked :class:`FSSpec` objects. This module expects a filesystem which supports forked
files, so it should not be used on UFS partitions. files, so it should not be used on UFS partitions.
.. warning::
This module is removed in 3.0.
The :mod:`macostools` module defines the following functions: The :mod:`macostools` module defines the following functions:

10
Doc/library/plistlib.rst
View File

@ -75,12 +75,22 @@ This module defines the following functions:
Read a plist from the resource with type *restype* from the resource fork of Read a plist from the resource with type *restype* from the resource fork of
*path*. Availability: MacOS X. *path*. Availability: MacOS X.
.. warning::
In 3.0, this function is removed.
.. function:: writePlistToResource(rootObject, path[, restype='plst'[, resid=0]]) .. function:: writePlistToResource(rootObject, path[, restype='plst'[, resid=0]])
Write *rootObject* as a resource with type *restype* to the resource fork of Write *rootObject* as a resource with type *restype* to the resource fork of
*path*. Availability: MacOS X. *path*. Availability: MacOS X.
.. warning::
In 3.0, this function is removed.
The following class is available: The following class is available:

25
Doc/library/undoc.rst
View File

@ -80,7 +80,9 @@ Undocumented Mac OS modules
.. module:: applesingle .. module:: applesingle
:platform: Mac :platform: Mac
:synopsis: Rudimentary decoder for AppleSingle format files. :synopsis: Rudimentary decoder for AppleSingle format files.
:deprecated:
.. deprecated:: 2.6
:mod:`buildtools` --- Helper module for BuildApplet and Friends :mod:`buildtools` --- Helper module for BuildApplet and Friends
@ -89,6 +91,7 @@ Undocumented Mac OS modules
.. module:: buildtools .. module:: buildtools
:platform: Mac :platform: Mac
:synopsis: Helper module for BuildApplet, BuildApplication and macfreeze. :synopsis: Helper module for BuildApplet, BuildApplication and macfreeze.
:deprecated:
.. deprecated:: 2.4 .. deprecated:: 2.4
@ -99,6 +102,7 @@ Undocumented Mac OS modules
.. module:: cfmfile .. module:: cfmfile
:platform: Mac :platform: Mac
:synopsis: Code Fragment Resource module. :synopsis: Code Fragment Resource module.
:deprecated:
:mod:`cfmfile` is a module that understands Code Fragments and the accompanying :mod:`cfmfile` is a module that understands Code Fragments and the accompanying
@ -113,11 +117,14 @@ BuildApplication to combine all plugin modules to a single executable.
.. module:: icopen .. module:: icopen
:platform: Mac :platform: Mac
:synopsis: Internet Config replacement for open(). :synopsis: Internet Config replacement for open().
:deprecated:
Importing :mod:`icopen` will replace the builtin :meth:`open` with a version Importing :mod:`icopen` will replace the builtin :meth:`open` with a version
that uses Internet Config to set file type and creator for new files. that uses Internet Config to set file type and creator for new files.
.. deprecated:: 2.6
:mod:`macerrors` --- Mac OS Errors :mod:`macerrors` --- Mac OS Errors
---------------------------------- ----------------------------------
@ -125,10 +132,13 @@ that uses Internet Config to set file type and creator for new files.
.. module:: macerrors .. module:: macerrors
:platform: Mac :platform: Mac
:synopsis: Constant definitions for many Mac OS error codes. :synopsis: Constant definitions for many Mac OS error codes.
:deprecated:
:mod:`macerrors` contains constant definitions for many Mac OS error codes. :mod:`macerrors` contains constant definitions for many Mac OS error codes.
.. deprecated:: 2.6
:mod:`macresource` --- Locate script resources :mod:`macresource` --- Locate script resources
---------------------------------------------- ----------------------------------------------
@ -136,12 +146,15 @@ that uses Internet Config to set file type and creator for new files.
.. module:: macresource .. module:: macresource
:platform: Mac :platform: Mac
:synopsis: Locate script resources. :synopsis: Locate script resources.
:deprecated:
:mod:`macresource` helps scripts finding their resources, such as dialogs and :mod:`macresource` helps scripts finding their resources, such as dialogs and
menus, without requiring special case code for when the script is run under menus, without requiring special case code for when the script is run under
MacPython, as a MacPython applet or under OSX Python. MacPython, as a MacPython applet or under OSX Python.
.. deprecated:: 2.6
:mod:`Nav` --- NavServices calls :mod:`Nav` --- NavServices calls
-------------------------------- --------------------------------
@ -149,10 +162,13 @@ MacPython, as a MacPython applet or under OSX Python.
.. module:: Nav .. module:: Nav
:platform: Mac :platform: Mac
:synopsis: Interface to Navigation Services. :synopsis: Interface to Navigation Services.
:deprecated:
A low-level interface to Navigation Services. A low-level interface to Navigation Services.
.. deprecated:: 2.6
:mod:`PixMapWrapper` --- Wrapper for PixMap objects :mod:`PixMapWrapper` --- Wrapper for PixMap objects
--------------------------------------------------- ---------------------------------------------------
@ -160,12 +176,15 @@ A low-level interface to Navigation Services.
.. module:: PixMapWrapper .. module:: PixMapWrapper
:platform: Mac :platform: Mac
:synopsis: Wrapper for PixMap objects. :synopsis: Wrapper for PixMap objects.
:deprecated:
:mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows :mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows
access to the fields by name. It also has methods to convert to and from access to the fields by name. It also has methods to convert to and from
:mod:`PIL` images. :mod:`PIL` images.
.. deprecated:: 2.6
:mod:`videoreader` --- Read QuickTime movies :mod:`videoreader` --- Read QuickTime movies
-------------------------------------------- --------------------------------------------
@ -173,11 +192,14 @@ access to the fields by name. It also has methods to convert to and from
.. module:: videoreader .. module:: videoreader
:platform: Mac :platform: Mac
:synopsis: Read QuickTime movies frame by frame for further processing. :synopsis: Read QuickTime movies frame by frame for further processing.
:deprecated:
:mod:`videoreader` reads and decodes QuickTime movies and passes a stream of :mod:`videoreader` reads and decodes QuickTime movies and passes a stream of
images to your program. It also provides some support for audio tracks. images to your program. It also provides some support for audio tracks.
.. deprecated:: 2.6
:mod:`W` --- Widgets built on :mod:`FrameWork` :mod:`W` --- Widgets built on :mod:`FrameWork`
---------------------------------------------- ----------------------------------------------
@ -185,10 +207,13 @@ images to your program. It also provides some support for audio tracks.
.. module:: W .. module:: W
:platform: Mac :platform: Mac
:synopsis: Widgets for the Mac, built on top of FrameWork. :synopsis: Widgets for the Mac, built on top of FrameWork.
:deprecated:
The :mod:`W` widgets are used extensively in the :program:`IDE`. The :mod:`W` widgets are used extensively in the :program:`IDE`.
.. deprecated:: 2.6
.. _obsolete-modules: .. _obsolete-modules:

3
Lib/plat-mac/Audio_mac.py
View File

@ -1,6 +1,9 @@
QSIZE = 100000 QSIZE = 100000
error='Audio_mac.error' error='Audio_mac.error'
from warnings import warnpy3k
warnpy3k("In 3.x, the Play_Audio_mac module is removed.")
class Play_Audio_mac: class Play_Audio_mac:
def __init__(self, qsize=QSIZE): def __init__(self, qsize=QSIZE):

3
Lib/plat-mac/Carbon/__init__.py
View File

@ -2,3 +2,6 @@
import warnings import warnings
warnings.filterwarnings("ignore", "", FutureWarning, ".*Controls") warnings.filterwarnings("ignore", "", FutureWarning, ".*Controls")
warnings.filterwarnings("ignore", "", FutureWarning, ".*MacTextEditor") warnings.filterwarnings("ignore", "", FutureWarning, ".*MacTextEditor")
from warnings import warnpy3k
warnpy3k("In 3.x, Carbon is removed.")

3
Lib/plat-mac/EasyDialogs.py
View File

@ -18,6 +18,9 @@ This module uses DLOG resources 260 and on.
Based upon STDWIN dialogs with the same names and functions. Based upon STDWIN dialogs with the same names and functions.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the EasyDialogs module is removed.")
from Carbon.Dlg import GetNewDialog, SetDialogItemText, GetDialogItemText, ModalDialog from Carbon.Dlg import GetNewDialog, SetDialogItemText, GetDialogItemText, ModalDialog
from Carbon import Qd from Carbon import Qd
from Carbon import QuickDraw from Carbon import QuickDraw

3
Lib/plat-mac/FrameWork.py
View File

@ -2,6 +2,9 @@
DEBUG=0 DEBUG=0
from warnings import warnpy3k
warnpy3k("In 3.x, the FrameWork module is removed.")
import MacOS import MacOS
import traceback import traceback

3
Lib/plat-mac/MiniAEFrame.py
View File

@ -6,6 +6,9 @@ There are two classes:
only suitable for the simplest of AppleEvent servers. only suitable for the simplest of AppleEvent servers.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the MiniAEFrame module is removed.")
import traceback import traceback
import MacOS import MacOS
from Carbon import AE from Carbon import AE

4
Lib/plat-mac/PixMapWrapper.py
View File

@ -5,6 +5,10 @@ Python Imaging Library Image object.
J. Strout <joe@strout.net> February 1999""" J. Strout <joe@strout.net> February 1999"""
from warnings import warnpy3k
warnpy3k("In 3.x, the PixMapWrapper module is removed.")
from Carbon import Qd from Carbon import Qd
from Carbon import QuickDraw from Carbon import QuickDraw
import struct import struct

3
Lib/plat-mac/aepack.py
View File

@ -12,6 +12,9 @@ coerce(x, wanted_sample) coerces a python object to another python object
# Apple Event Registry, chapter 9. # Apple Event Registry, chapter 9.
# #
from warnings import warnpy3k
warnpy3k("In 3.x, the aepack module is removed.")
import struct import struct
import types import types
from types import * from types import *

3
Lib/plat-mac/aetools.py
View File

@ -21,6 +21,9 @@ files: the pack stuff from aepack, the objects from aetypes.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the aetools module is removed.")
from types import * from types import *
from Carbon import AE from Carbon import AE
from Carbon import Evt from Carbon import Evt

3
Lib/plat-mac/aetypes.py
View File

@ -1,5 +1,8 @@
"""aetypes - Python objects representing various AE types.""" """aetypes - Python objects representing various AE types."""
from warnings import warnpy3k
warnpy3k("In 3.x, the aetypes module is removed.")
from Carbon.AppleEvents import * from Carbon.AppleEvents import *
import struct import struct
from types import * from types import *

4
Lib/plat-mac/applesingle.py
View File

@ -1,5 +1,9 @@
r"""Routines to decode AppleSingle files r"""Routines to decode AppleSingle files
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the applesingle module is removed.")
import struct import struct
import sys import sys
try: try:

4
Lib/plat-mac/appletrawmain.py
View File

@ -4,6 +4,10 @@
# This script is put into __rawmain__.pyc for applets that need argv # This script is put into __rawmain__.pyc for applets that need argv
# emulation, by BuildApplet and friends. # emulation, by BuildApplet and friends.
# #
from warnings import warnpy3k
warnpy3k("In 3.x, the appletrawmain module is removed.")
import argvemulator import argvemulator
import os import os
import sys import sys

3
Lib/plat-mac/appletrunner.py
View File

@ -3,6 +3,9 @@
# BuildApplet will use it as the main executable in the .app bundle if # BuildApplet will use it as the main executable in the .app bundle if
# we are not running in a framework build. # we are not running in a framework build.
from warnings import warnpy3k
warnpy3k("In 3.x, appletrunner is removed.")
import os import os
import sys import sys
for name in ["__rawmain__.py", "__rawmain__.pyc", "__main__.py", "__main__.pyc"]: for name in ["__rawmain__.py", "__rawmain__.pyc", "__main__.py", "__main__.pyc"]:

3
Lib/plat-mac/argvemulator.py
View File

@ -2,6 +2,9 @@
want unix-style arguments. want unix-style arguments.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the argvemulator module is removed.")
import sys import sys
import traceback import traceback
from Carbon import AE from Carbon import AE

3
Lib/plat-mac/bgenlocations.py
View File

@ -7,6 +7,9 @@
import os import os
from warnings import warnpy3k
warnpy3k("In 3.x, the bgenlocations module is removed.")
Error = "bgenlocations.Error" Error = "bgenlocations.Error"
# #
# Where bgen is. For unix-Python bgen isn't installed, so you have to refer to # Where bgen is. For unix-Python bgen isn't installed, so you have to refer to

7
Lib/plat-mac/buildtools.py
View File

@ -1,5 +1,9 @@
"""tools for BuildApplet and BuildApplication""" """tools for BuildApplet and BuildApplication"""
import warnings
warnings.warn("the buildtools module is deprecated and is removed in 3.0",
DeprecationWarning, 2)
import sys import sys
import os import os
import string import string
@ -14,9 +18,6 @@ import macresource
import EasyDialogs import EasyDialogs
import shutil import shutil
import warnings
warnings.warn("the buildtools module is deprecated", DeprecationWarning, 2)
BuildError = "BuildError" BuildError = "BuildError"

3
Lib/plat-mac/bundlebuilder.py
View File

@ -28,6 +28,9 @@ this model:
__all__ = ["BundleBuilder", "BundleBuilderError", "AppBuilder", "buildapp"] __all__ = ["BundleBuilder", "BundleBuilderError", "AppBuilder", "buildapp"]
from warnings import warnpy3k
warnpy3k("In 3.x, the bundlebuilder module is removed.")
import sys import sys
import os, errno, shutil import os, errno, shutil
import imp, marshal import imp, marshal

7
Lib/plat-mac/cfmfile.py
View File

@ -5,15 +5,16 @@
__version__ = "0.8b3" __version__ = "0.8b3"
__author__ = "jvr" __author__ = "jvr"
import warnings
warnings.warn("the cfmfile module is deprecated and is removed in 3,0",
DeprecationWarning, 2)
import Carbon.File import Carbon.File
import struct import struct
from Carbon import Res from Carbon import Res
import os import os
import sys import sys
import warnings
warnings.warn("the cfmfile module is deprecated", DeprecationWarning, 2)
DEBUG = 0 DEBUG = 0
error = "cfm.error" error = "cfm.error"

4
Lib/plat-mac/findertools.py
View File

@ -14,6 +14,10 @@ So bottom line: the processes() stuff does not work on < MacOS9
Mostly written by erik@letterror.com Mostly written by erik@letterror.com
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the findertools module is removed.")
import Finder import Finder
from Carbon import AppleEvents from Carbon import AppleEvents
import aetools import aetools

3
Lib/plat-mac/gensuitemodule.py
View File

@ -6,6 +6,9 @@ Based on aete.py.
Reading and understanding this code is left as an exercise to the reader. Reading and understanding this code is left as an exercise to the reader.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the gensuitemodule module is removed.")
import MacOS import MacOS
import EasyDialogs import EasyDialogs
import os import os

3
Lib/plat-mac/ic.py
View File

@ -1,5 +1,8 @@
"""IC wrapper module, based on Internet Config 1.3""" """IC wrapper module, based on Internet Config 1.3"""
from warnings import warnpy3k
warnpy3k("In 3.x, the ic module is removed.")
import icglue import icglue
import string import string
import sys import sys

3
Lib/plat-mac/icopen.py
View File

@ -37,6 +37,9 @@ The next time you launch PythonInterpreter or Python IDE, the patch will take
effect. effect.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the icopen module is removed.")
import __builtin__ import __builtin__
_builtin_open = globals().get('_builtin_open', __builtin__.open) _builtin_open = globals().get('_builtin_open', __builtin__.open)

4
Lib/plat-mac/lib-scriptpackages/CodeWarrior/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /Volumes/Sap/Applications (Mac OS 9)/Metrowerks CodeWarrior 7.0/Metrowerks CodeWarrior/CodeWarrior IDE 4.2.5 Package generated from /Volumes/Sap/Applications (Mac OS 9)/Metrowerks CodeWarrior 7.0/Metrowerks CodeWarrior/CodeWarrior IDE 4.2.5
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the CodeWarrior package is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import CodeWarrior_suite import CodeWarrior_suite

4
Lib/plat-mac/lib-scriptpackages/Explorer/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /Applications/Internet Explorer.app Package generated from /Applications/Internet Explorer.app
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the Explorer module is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Standard_Suite import Standard_Suite

4
Lib/plat-mac/lib-scriptpackages/Finder/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /System/Library/CoreServices/Finder.app Package generated from /System/Library/CoreServices/Finder.app
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the Finder package is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Standard_Suite import Standard_Suite

4
Lib/plat-mac/lib-scriptpackages/Netscape/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /Volumes/Sap/Applications (Mac OS 9)/Netscape Communicator\xe2\x84\xa2 Folder/Netscape Communicator\xe2\x84\xa2 Package generated from /Volumes/Sap/Applications (Mac OS 9)/Netscape Communicator\xe2\x84\xa2 Folder/Netscape Communicator\xe2\x84\xa2
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the Netscape package is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Standard_Suite import Standard_Suite

4
Lib/plat-mac/lib-scriptpackages/StdSuites/__init__.py
View File

@ -2,6 +2,10 @@
Package generated from /Volumes/Sap/System Folder/Extensions/AppleScript Package generated from /Volumes/Sap/System Folder/Extensions/AppleScript
Resource aeut resid 0 Standard Event Suites for English Resource aeut resid 0 Standard Event Suites for English
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the StdSuites package is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Text_Suite import Text_Suite

4
Lib/plat-mac/lib-scriptpackages/SystemEvents/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /System/Library/CoreServices/System Events.app Package generated from /System/Library/CoreServices/System Events.app
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the SystemEvents package is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Standard_Suite import Standard_Suite

4
Lib/plat-mac/lib-scriptpackages/Terminal/__init__.py
View File

@ -1,6 +1,10 @@
""" """
Package generated from /Applications/Utilities/Terminal.app Package generated from /Applications/Utilities/Terminal.app
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the Terminal module is removed.")
import aetools import aetools
Error = aetools.Error Error = aetools.Error
import Standard_Suite import Standard_Suite

4
Lib/plat-mac/lib-scriptpackages/_builtinSuites/__init__.py
View File

@ -4,6 +4,10 @@ suites. This is needed because the events and enums in this suite belong
in the Required suite according to the Apple docs, but they often seem to be in the Required suite according to the Apple docs, but they often seem to be
in the Standard suite. in the Standard suite.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the _builtinSuites module is removed.")
import aetools import aetools
import builtin_Suite import builtin_Suite

4
Lib/plat-mac/macerrors.py
View File

@ -1,4 +1,8 @@
# -coding=latin1- # -coding=latin1-
from warnings import warnpy3k
warnpy3k("In 3.x, the macerrors module is removed.")
svTempDisable = -32768 #svTempDisable svTempDisable = -32768 #svTempDisable
svDisabled = -32640 #Reserve range -32640 to -32768 for Apple temp disables. svDisabled = -32640 #Reserve range -32640 to -32768 for Apple temp disables.
fontNotOutlineErr = -32615 #bitmap font passed to routine that does outlines only fontNotOutlineErr = -32615 #bitmap font passed to routine that does outlines only

3
Lib/plat-mac/macostools.py
View File

@ -4,6 +4,9 @@ mkalias(src, dst) - Create a finder alias 'dst' pointing to 'src'
copy(src, dst) - Full copy of 'src' to 'dst' copy(src, dst) - Full copy of 'src' to 'dst'
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the macostools module is removed.")
from Carbon import Res from Carbon import Res
from Carbon import File, Files from Carbon import File, Files
import os import os

3
Lib/plat-mac/macresource.py
View File

@ -1,5 +1,8 @@
"""macresource - Locate and open the resources needed for a script.""" """macresource - Locate and open the resources needed for a script."""
from warnings import warnpy3k
warnpy3k("In 3.x, the macresource module is removed.")
from Carbon import Res from Carbon import Res
import os import os
import sys import sys

4
Lib/plat-mac/pimp.py
View File

@ -12,6 +12,10 @@ dependencies and installing packages.
There is a minimal main program that works as a command line tool, but the There is a minimal main program that works as a command line tool, but the
intention is that the end user will use this through a GUI. intention is that the end user will use this through a GUI.
""" """
from warnings import warnpy3k
warnpy3k("In 3.x, the pimp module is removed.")
import sys import sys
import os import os
import subprocess import subprocess

3
Lib/plat-mac/terminalcommand.py
View File

@ -14,6 +14,9 @@ with a decent input/output window.
# Mac/OSX/PythonLauncher/doscript.m. # Mac/OSX/PythonLauncher/doscript.m.
# #
from warnings import warnpy3k
warnpy3k("In 3.x, the terminalcommand module is removed.")
import time import time
import os import os
from Carbon import AE from Carbon import AE

5
Lib/plat-mac/videoreader.py
View File

@ -5,6 +5,11 @@
# #
# Jack Jansen, August 2000 # Jack Jansen, August 2000
# #
from warnings import warnpy3k
warnpy3k("In 3.x, the videoreader module is removed.")
import sys import sys
from Carbon import Qt from Carbon import Qt
from Carbon import QuickTime from Carbon import QuickTime

3
Lib/plistlib.py
View File

@ -62,6 +62,7 @@ import binascii
import datetime import datetime
from cStringIO import StringIO from cStringIO import StringIO
import re import re
import warnings
def readPlist(pathOrFile): def readPlist(pathOrFile):
@ -113,6 +114,7 @@ def writePlistToString(rootObject):
def readPlistFromResource(path, restype='plst', resid=0): def readPlistFromResource(path, restype='plst', resid=0):
"""Read plst resource from the resource fork of path. """Read plst resource from the resource fork of path.
""" """
warnings.warnpy3k("In 3.x, readPlistFromResource is removed.")
from Carbon.File import FSRef, FSGetResourceForkName from Carbon.File import FSRef, FSGetResourceForkName
from Carbon.Files import fsRdPerm from Carbon.Files import fsRdPerm
from Carbon import Res from Carbon import Res
@ -127,6 +129,7 @@ def readPlistFromResource(path, restype='plst', resid=0):
def writePlistToResource(rootObject, path, restype='plst', resid=0): def writePlistToResource(rootObject, path, restype='plst', resid=0):
"""Write 'rootObject' as a plst resource to the resource fork of path. """Write 'rootObject' as a plst resource to the resource fork of path.
""" """
warnings.warnpy3k("In 3.x, writePlistToResource is removed.")
from Carbon.File import FSRef, FSGetResourceForkName from Carbon.File import FSRef, FSGetResourceForkName
from Carbon.Files import fsRdWrPerm from Carbon.Files import fsRdWrPerm
from Carbon import Res from Carbon import Res

14
Lib/test/test_py3kwarn.py
View File

@ -131,7 +131,19 @@ class TestStdlibRemovals(unittest.TestCase):
all_platforms = ('audiodev', 'imputil', 'mutex', 'user', 'new', 'rexec', all_platforms = ('audiodev', 'imputil', 'mutex', 'user', 'new', 'rexec',
'Bastion', 'compiler', 'dircache', 'fpformat', 'Bastion', 'compiler', 'dircache', 'fpformat',
'ihooks', 'mhlib') 'ihooks', 'mhlib')
inclusive_platforms = {'irix':('pure',)} inclusive_platforms = {'irix' : ('pure',),
'darwin' : ('autoGIL', 'Carbon', 'OSATerminology',
'icglue', 'Nav', 'MacOS', 'aepack', 'aetools'
'aetypes', 'applesingle', 'appletrawmain',
'appletrunner', 'argvemulator', 'bgenlocations',
'EasyDialogs', 'macerrors', 'macostools',
'findertools', 'FrameWork', 'ic',
'gensuitemodule', 'icopen', 'macresource',
'MiniAEFrame', 'pimp', 'PixMapWrapper',
'terminalcommand', 'videoreader', '_builtinSuites',
'CodeWarrior', 'Explorer', 'Finder', 'Netscape',
'StdSuites', 'SystemEvents', 'Terminal', 'cfmfile',
'bundlebuilder', 'buildtools', 'ColorPicker')}
optional_modules = ('bsddb185', 'Canvas', 'dl', 'linuxaudiodev', 'imageop', optional_modules = ('bsddb185', 'Canvas', 'dl', 'linuxaudiodev', 'imageop',
'sv') 'sv')

3
Mac/Modules/ColorPickermodule.c
View File

@ -65,6 +65,9 @@ void initColorPicker(void)
{ {
PyObject *m; PyObject *m;
if (PyErr_WarnPy3k("In 3.x, ColorPicker is removed.", 1) < 0)
return;
/* Create the module and add the functions */ /* Create the module and add the functions */
m = Py_InitModule4("ColorPicker", cp_methods, m = Py_InitModule4("ColorPicker", cp_methods,
cp_module_documentation, cp_module_documentation,

3
Mac/Modules/MacOS.c
View File

@ -603,6 +603,9 @@ initMacOS(void)
{ {
PyObject *m, *d; PyObject *m, *d;
if (PyErr_WarnPy3k("In 3.x, MacOS is removed.", 1))
return;
m = Py_InitModule("MacOS", MacOS_Methods); m = Py_InitModule("MacOS", MacOS_Methods);
d = PyModule_GetDict(m); d = PyModule_GetDict(m);

3
Mac/Modules/Nav.c
View File

@ -917,6 +917,9 @@ initNav(void)
{ {
PyObject *m, *d; PyObject *m, *d;
if (PyErr_WarnPy3k("In 3.x, Nav is removed.", 1))
return;
/* Test that we have NavServices */ /* Test that we have NavServices */
if ( !NavServicesAvailable() ) { if ( !NavServicesAvailable() ) {
PyErr_SetString(PyExc_ImportError, "Navigation Services not available"); PyErr_SetString(PyExc_ImportError, "Navigation Services not available");

2
Mac/Modules/OSATerminology.c
View File

@ -89,5 +89,7 @@ static struct PyMethodDef OSATerminology_methods[] =
void void
initOSATerminology(void) initOSATerminology(void)
{ {
if (PyErr_WarnPy3k("In 3.x, OSATerminology is removed.", 1) < 0)
return;
Py_InitModule("OSATerminology", OSATerminology_methods); Py_InitModule("OSATerminology", OSATerminology_methods);
} }

3
Mac/Modules/autoGIL.c
View File

@ -134,6 +134,9 @@ initautoGIL(void)
{ {
PyObject *mod; PyObject *mod;
if (PyErr_WarnPy3k("In 3.x, the autoGIL module is removed.", 1) < 0)
return;
mod = Py_InitModule4("autoGIL", autoGIL_methods, autoGIL_docs, mod = Py_InitModule4("autoGIL", autoGIL_methods, autoGIL_docs,
NULL, PYTHON_API_VERSION); NULL, PYTHON_API_VERSION);
if (mod == NULL) if (mod == NULL)

3
Mac/Modules/icgluemodule.c
View File

@ -454,6 +454,9 @@ initicglue(void)
{ {
PyObject *m, *d; PyObject *m, *d;
if (PyErr_WarnPy3k("In 3.x, icglue is removed.", 1))
return;
/* Create the module and add the functions */ /* Create the module and add the functions */
m = Py_InitModule4("icglue", ic_methods, m = Py_InitModule4("icglue", ic_methods,
icglue_module_documentation, icglue_module_documentation,

3
Misc/NEWS
View File

@ -91,6 +91,9 @@ Library
- pdb gained the "until" command. - pdb gained the "until" command.
- The Mac Modules (including Carbon) have been deprecated for removal in
3.0.
Build Build
----- -----