webbrowser.MacOSX is unused, untested and undocumented

[ronaldoussoren]

BPO	42255
Nosy	@ronaldoussoren, @ned-deily, @ambv, @corona10
PRs	bpo-42255: Deprecate webbrowser.MacOSX from Python 3.11 #27837 [3.10] bpo-42255: Update webbrowser doc #28144 [3.9] bpo-42255: Update webbrowser doc #28145

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2021-09-03.17:23:03.825>
created_at = <Date 2020-11-03.19:15:01.672>
labels = ['OS-mac', '3.9', '3.10', '3.11', 'type-feature', 'library']
title = 'webbrowser.MacOSX is unused, untested and undocumented'
updated_at = <Date 2021-09-03.17:23:08.907>
user = 'https://github.com/ronaldoussoren'

bugs.python.org fields:

activity = <Date 2021-09-03.17:23:08.907>
actor = 'lukasz.langa'
assignee = 'none'
closed = True
closed_date = <Date 2021-09-03.17:23:03.825>
closer = 'lukasz.langa'
components = ['Library (Lib)', 'macOS']
creation = <Date 2020-11-03.19:15:01.672>
creator = 'ronaldoussoren'
dependencies = []
files = []
hgrepos = []
issue_num = 42255
keywords = ['patch']
message_count = 7.0
messages = ['380293', '399766', '400910', '401001', '401008', '401009', '401010']
nosy_count = 4.0
nosy_names = ['ronaldoussoren', 'ned.deily', 'lukasz.langa', 'corona10']
pr_nums = ['27837', '28144', '28145']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue42255'
versions = ['Python 3.9', 'Python 3.10', 'Python 3.11']

[ronaldoussoren]

class webbrower.MacOSX is untested and undocumented. It is also not used by webbrowser itself (webbrowser.MacOSXOSAScript is used to launch browsers).

It's probably safe to just remove the class, otherwise deprecate in 3.10 for removal in 3.11.

[corona10]

Let's deprecate it from 3.11 and remove it at 3.12 :)

[ambv]

Dong-hee Na, you can't remove it in 3.12 per PEP-387:

Unless it is going through the deprecation process below, the behavior of an API must not change in an incompatible fashion between any two consecutive releases. Python's yearly release process (PEP-602) means that the deprecation period must last at least two years.

and:

Wait for the warning to appear in at least two minor Python versions of the same major version.

[ambv]

New changeset bc1c49f by Dong-hee Na in branch 'main':
bpo-42255: Deprecate webbrowser.MacOSX from Python 3.11 (GH-27837)
bc1c49f

[ambv]

New changeset ce83e42 by Dong-hee Na in branch '3.9':
bpo-42255: Update webbrowser doc for macOS (GH-28145)
ce83e42

[ambv]

New changeset 2a8956c by Dong-hee Na in branch '3.10':
bpo-42255: Update webbrowser doc for macOS (GH-28144)
2a8956c

[ambv]

Thanks for the patches, Dong-hee Na! ✨ 🍰 ✨

[hugovk]

Please see PR #104816 to remove webbrowser.MacOSX.