[ENH] Undeprecate pivot_wider()

AUTHORS.md

@@ -114,3 +114,4 @@ Contributors
 - [@joranbeasley](https://github.com/joranbeasley) | [contributions](https://github.com/pyjanitor-devs/pyjanitor/issues?q=is%3Aclosed+mentions%joranbeasley)
 -[@kianmeng](https://github.com/kianmeng) | [contributions](https://github.com/pyjanitor-devs/pyjanitor/pull/1290#issue-1906020324)
 - [@lbeltrame](https://github.com/lbeltrame) | [contributions](https://github.com/pyjanitor-devs/pyjanitor/pull/1401)
+- [@derekpowell](https://github.com/derekpowell) | [contributions](https://github.com/pyjanitor-devs/pyjanitor/issues?q=is%3Aclosed+mentions%3Aderekpowell)

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## [Unreleased]
 -   [ENH] Added `row_count` parameter for janitor.conditional_join - Issue #1269 @samukweku
+-   [ENG] Reverse deprecation of `pivot_wider()` -- Issue #1464
 ## [v0.31.0] - 2025-03-07
 
 -   [ENH] Added support for pd.Series.select - Issue #1394 @samukweku

janitor/functions/pivot.py

@@ -19,7 +19,7 @@
     _select_index,
     get_index_labels,
 )
-from janitor.utils import check, refactored_function
+from janitor.utils import check
 
 
 @pf.register_dataframe_method
@@ -1863,12 +1863,6 @@ def _names_transform(
 
 
 @pf.register_dataframe_method
-@refactored_function(
-    message=(
-        "This function will be deprecated in a 1.x release. "
-        "Please use `pd.DataFrame.pivot` instead."
-    )
-)
 def pivot_wider(
     df: pd.DataFrame,
     index: list | str = None,
@@ -1883,11 +1877,6 @@ def pivot_wider(
 ) -> pd.DataFrame:
     """Reshapes data from *long* to *wide* form.
 
-    !!!note
-
-        This function will be deprecated in a 1.x release.
-        Please use `pd.DataFrame.pivot` instead.
-
     The number of columns are increased, while decreasing
     the number of rows. It is the inverse of the
     [`pivot_longer`][janitor.functions.pivot.pivot_longer]

tests/functions/test_pivot_wider.py

@@ -522,7 +522,7 @@ def test_names_expand(df_expand):
     expected = df_expand.pivot_wider(
         "year", "id", "percentage", names_expand=True, flatten_levels=False
     )
-    assert_frame_equal(actual, expected)
+    assert_frame_equal(actual, expected, check_dtype=False)
 
 
 def test_names_expand_flatten_levels(df_expand):
@@ -536,7 +536,7 @@ def test_names_expand_flatten_levels(df_expand):
     expected = df_expand.pivot_wider(
         "year", "id", "percentage", names_expand=True, flatten_levels=True
     )
-    assert_frame_equal(actual, expected)
+    assert_frame_equal(actual, expected, check_dtype=False)
 
 
 def test_index_expand(df_expand):
@@ -564,7 +564,9 @@ def test_index_expand_flatten_levels(df_expand):
     assert_frame_equal(actual, expected)
 
 
-@pytest.mark.xfail(reason="pivot_wider function slated for deprecation.")
+@pytest.mark.xfail(
+    reason="pivot_wider function WAS slated for deprecation. -- additional fixes are needed."
+)
 def test_expand_multiple_levels(df_expand):
     """Test output for names_expand for multiple names_from."""
     expected = df_expand.pivot_wider(
@@ -580,7 +582,9 @@ def test_expand_multiple_levels(df_expand):
     assert_frame_equal(actual, expected)
 
 
-@pytest.mark.xfail(reason="pivot_wider function slated for deprecation.")
+@pytest.mark.xfail(
+    reason="pivot_wider function WAS slated for deprecation. -- additional fixes are needed."
+)
 def test_expand_multiple_levels_flatten_levels(df_expand):
     """Test output for names_expand for multiple names_from."""
     expected = df_expand.pivot_wider(