Refinements

Author: rhshadrach

doc/source/whatsnew/v2.3.0.rst

@@ -37,9 +37,9 @@ Other enhancements
   updated to work correctly with NumPy >= 2 (:issue:`57739`)
 - :meth:`Series.str.decode` result now has ``StringDtype`` when ``future.infer_string`` is True (:issue:`60709`)
 - :meth:`~Series.to_hdf` and :meth:`~DataFrame.to_hdf` now round-trip with ``StringDtype``  (:issue:`60663`)
+- The :meth:`Series.str.decode` has gained the argument ``dtype`` to control the dtype of the result (:issue:`60940`)
 - The :meth:`~Series.cumsum`, :meth:`~Series.cummin`, and :meth:`~Series.cummax` reductions are now implemented for ``StringDtype`` columns when backed by PyArrow (:issue:`60633`)
 - The :meth:`~Series.sum` reduction is now implemented for ``StringDtype`` columns (:issue:`59853`)
-- The :meth:`Series.str.decode` has gained the argument ``dtype`` to control the dtype of the result (:issue:`???`)
 
 .. ---------------------------------------------------------------------------
 .. _whatsnew_230.notable_bug_fixes:

pandas/core/strings/accessor.py

@@ -2122,6 +2122,8 @@ def decode(self, encoding, errors: str = "strict", dtype: str | DtypeObj = None)
             object dtype. When ``None``, the dtype of the result is determined by
             ``pd.options.future.infer_string``.
 
+            .. versionadded:: 2.3.0
+
         Returns
         -------
         Series or Index

pandas/tests/strings/test_strings.py

@@ -602,20 +602,23 @@ def test_decode_errors_kwarg():
 
 
 def test_decode_string_dtype(string_dtype):
+    # https://github.com/pandas-dev/pandas/pull/60940
     ser = Series([b"a", b"b"])
     result = ser.str.decode("utf-8", dtype=string_dtype)
     expected = Series(["a", "b"], dtype=string_dtype)
     tm.assert_series_equal(result, expected)
 
 
 def test_decode_object_dtype(object_dtype):
+    # https://github.com/pandas-dev/pandas/pull/60940
     ser = Series([b"a", rb"\ud800"])
     result = ser.str.decode("utf-8", dtype=object_dtype)
     expected = Series(["a", r"\ud800"], dtype=object_dtype)
     tm.assert_series_equal(result, expected)
 
 
 def test_decode_bad_dtype():
+    # https://github.com/pandas-dev/pandas/pull/60940
     ser = Series([b"a", b"b"])
     msg = "dtype must be string or object, got dtype='int64'"
     with pytest.raises(ValueError, match=msg):