From 3788ce13982e1f8476168fec58e83fbb6d178421 Mon Sep 17 00:00:00 2001
From: "Michiel W. Beijen" <mb@x14.nl>
Date: Tue, 3 Mar 2026 13:44:56 +0100
Subject: [PATCH] GH-145450: Document missing `wave.Wave_write` getter methods
 (GH-145451) (cherry picked from commit
 db41717cd50af6db7d496b0aa282b1f3370327c6)

Co-authored-by: Michiel W. Beijen <mb@x14.nl>
---
 Doc/library/wave.rst                          | 37 +++++++++++++++++++
 ...-03-03-08-18-00.gh-issue-145450.VI7GXj.rst |  1 +
 2 files changed, 38 insertions(+)
 create mode 100644 Misc/NEWS.d/next/Documentation/2026-03-03-08-18-00.gh-issue-145450.VI7GXj.rst

diff --git a/Doc/library/wave.rst b/Doc/library/wave.rst
index c71f6f25c9d13b..38b05f0b4fdd7b 100644
--- a/Doc/library/wave.rst
+++ b/Doc/library/wave.rst
@@ -199,11 +199,21 @@ Wave_write Objects
       Set the number of channels.
 
 
+   .. method:: getnchannels()
+
+      Return the number of channels.
+
+
    .. method:: setsampwidth(n)
 
       Set the sample width to *n* bytes.
 
 
+   .. method:: getsampwidth()
+
+      Return the sample width in bytes.
+
+
    .. method:: setframerate(n)
 
       Set the frame rate to *n*.
@@ -213,6 +223,11 @@ Wave_write Objects
          integer.
 
 
+   .. method:: getframerate()
+
+      Return the frame rate.
+
+
    .. method:: setnframes(n)
 
       Set the number of frames to *n*.  This will be changed later if the number
@@ -220,12 +235,27 @@ Wave_write Objects
       raise an error if the output stream is not seekable).
 
 
+   .. method:: getnframes()
+
+      Return the number of audio frames written so far.
+
+
    .. method:: setcomptype(type, name)
 
       Set the compression type and description. At the moment, only compression type
       ``NONE`` is supported, meaning no compression.
 
 
+   .. method:: getcomptype()
+
+      Return the compression type (``'NONE'``).
+
+
+   .. method:: getcompname()
+
+      Return the human-readable compression type name.
+
+
    .. method:: setparams(tuple)
 
       The *tuple* should be ``(nchannels, sampwidth, framerate, nframes, comptype,
@@ -233,6 +263,13 @@ Wave_write Objects
       parameters.
 
 
+   .. method:: getparams()
+
+      Return a :func:`~collections.namedtuple`
+      ``(nchannels, sampwidth, framerate, nframes, comptype, compname)``
+      containing the current output parameters.
+
+
    .. method:: tell()
 
       Return current position in the file, with the same disclaimer for the
diff --git a/Misc/NEWS.d/next/Documentation/2026-03-03-08-18-00.gh-issue-145450.VI7GXj.rst b/Misc/NEWS.d/next/Documentation/2026-03-03-08-18-00.gh-issue-145450.VI7GXj.rst
new file mode 100644
index 00000000000000..681c932b34a05d
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2026-03-03-08-18-00.gh-issue-145450.VI7GXj.rst
@@ -0,0 +1 @@
+Document missing public :class:`wave.Wave_write` getter methods.