Indicate supported sound header formats

[nanjekyejoannah]

BPO	41353
Nosy	@nanjekyejoannah
PRs	gh-85525: Indicate supported sound header formats #21575

^{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 = None
created_at = <Date 2020-07-21.01:59:17.608>
labels = ['type-feature', 'docs']
title = 'Indicate supported sound header formats'
updated_at = <Date 2020-07-21.02:00:20.351>
user = 'https://github.com/nanjekyejoannah'

bugs.python.org fields:

activity = <Date 2020-07-21.02:00:20.351>
actor = 'nanjekyejoannah'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2020-07-21.01:59:17.608>
creator = 'nanjekyejoannah'
dependencies = []
files = []
hgrepos = []
issue_num = 41353
keywords = ['patch']
message_count = 1.0
messages = ['374047']
nosy_count = 2.0
nosy_names = ['docs@python', 'nanjekyejoannah']
pr_nums = ['21575']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue41353'
versions = []

[nanjekyejoannah]

The documentation for the sndhdr module does not have supported file formats. Something like below could help:

+------------+------------------------------------+
| Value | Sound header format |
+============+====================================+
| 'aifc' | Compressed Audio Interchange Files |
+------------+------------------------------------+
| 'aiff' | Audio Interchange Files |
+------------+------------------------------------+
| 'au' | AU Files |
+------------+------------------------------------+
| 'hcom' | HCOM Files |
+------------+------------------------------------+
| 'sndr' | SNDR Files |
+------------+------------------------------------+
| 'sndt' | SNDT Files |
+------------+------------------------------------+
| 'voc' | VOC Files |
+------------+------------------------------------+
| 'wav' | WAV Files |
+------------+------------------------------------+
| '8svx' | 8SVX Files |
+------------+------------------------------------+
| 'sb' | SB Files |
+------------+------------------------------------+
| 'ub' | UB Files |
+------------+------------------------------------+
| 'ul' | uLAW Audio Files |
+------------+------------------------------------+

[hugovk]

Note the sndhdr module is deprecated in 3.11 and set for removal in 3.13.

See PEP 594 – Removing dead batteries from the standard library and #91217.

[merwok]

This was just merged but note that the module is deprecated: #91217

The copied functions in email don’t have the new docstrings.

[nanjekyejoannah]

You can open a new issue and PR for that.