gh-137586: Address hugovk review comments

Move plistlib to top-level imports alongside the existing import block.
Remove os from the inline import inside _macos_default_browser_bundle_id
as it is already imported at module level. Remove the stale
'# Maintained by Georg Brandl.' comment.

Replace manual warnings.warn() in MacOSXOSAScript.__init__ with
warnings._deprecated("webbrowser.MacOSXOSAScript", remove=(3, 17)).

Change 'deprecated:: next' to 'deprecated-removed:: next 3.17' in
Doc/library/webbrowser.rst. Add MacOSXOSAScript to
Doc/deprecations/pending-removal-in-3.17.rst.

Add register("MacOSX", None, MacOS('default')) as a backward
compatibility alias so webbrowser.get("MacOSX") continues to work.

Author: secengjeff

Doc/deprecations/pending-removal-in-3.17.rst

@@ -37,6 +37,11 @@ Pending removal in Python 3.17
     is deprecated and scheduled for removal in Python 3.17.
     (Contributed by Stan Ulbrych in :gh:`136702`.)
 
+* :mod:`webbrowser`:
+
+  - :class:`!webbrowser.MacOSXOSAScript` is deprecated in favour of
+    :class:`!webbrowser.MacOS`. (:gh:`137586`)
+
 * :mod:`typing`:
 
   - Before Python 3.14, old-style unions were implemented using the private class

Doc/library/webbrowser.rst

@@ -227,7 +227,7 @@ Notes:
    :class:`!MacOS` has been added as a replacement for :class:`!MacOSXOSAScript`,
    opening browsers via :program:`/usr/bin/open` instead of :program:`osascript`.
 
-.. deprecated:: next
+.. deprecated-removed:: next 3.17
    :class:`!MacOSXOSAScript` is deprecated in favour of :class:`!MacOS`.
    Using :program:`/usr/bin/open` instead of :program:`osascript` is a
    security and usability improvement: :program:`osascript` may be blocked

Lib/webbrowser.py

@@ -1,7 +1,7 @@
 """Interfaces for launching and remotely controlling web browsers."""
-# Maintained by Georg Brandl.
 
 import os
+import plistlib
 import shlex
 import shutil
 import sys
@@ -493,6 +493,7 @@ def register_standard_browsers():
 
     if sys.platform == 'darwin':
         register("MacOS", None, MacOS('default'))
+        register("MacOSX", None, MacOS('default'))  # backward compat alias
         register("chrome", None, MacOS('google chrome'))
         register("chromium", None, MacOS('chromium'))
         register("firefox", None, MacOS('firefox'))
@@ -628,7 +629,7 @@ def _macos_default_browser_bundle_id():
         LaunchServices plist is not written until the user explicitly
         changes their default browser.
         """
-        import builtins, plistlib, os
+        import builtins
         plist = os.path.expanduser(
             '~/Library/Preferences/com.apple.LaunchServices/'
             'com.apple.launchservices.secure.plist'
@@ -692,11 +693,7 @@ def open(self, url, new=0, autoraise=True):
     class MacOSXOSAScript(BaseBrowser):
         def __init__(self, name='default'):
             import warnings
-            warnings.warn(
-                "MacOSXOSAScript is deprecated, use MacOS instead.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
+            warnings._deprecated("webbrowser.MacOSXOSAScript", remove=(3, 17))
             super().__init__(name)
 
         def open(self, url, new=0, autoraise=True):