[ENH] pivot_longer_spec

CHANGELOG.md

@@ -2,13 +2,15 @@
 
 ## [Unreleased]
 
+- [ENH] Improve `pivot_longer` when `sort_by_appearance` is True. Added `pivot_longer_spec` for more control on how the dataframe should be unpivoted. -@samukweku #1361
 - [ENH] Added a `complete` method for polars. - Issue #1352 @samukweku
-- [ENH] `read_commandline` function now supports polars - Issue #1352
-- [ENH] Improved performance for non-equi joins when using numba - @samukweku PR #1341
-- [ENH] Added a `clean_names` method for polars - it can be used to clean the column names, or clean column values . Issue #1343 @samukweku
+- [ENH] Added a `pivot_longer` method, and a `pivot_longer_spec` function for polars - Issue #1352 @samukweku
+- [ENH] Added a `row_to_names` method for polars. Issue #1352 @samukweku
+- [ENH] `read_commandline` function now supports polars - Issue #1352 @samukweku
 - [ENH] `xlsx_cells` function now supports polars - Issue #1352 @samukweku
 - [ENH] `xlsx_table` function now supports polars - Issue #1352 @samukweku
-- [ENH] Added a `pivot_longer` method, and a `pivot_longer_spec` function for polars - Issue #1352 @samukweku
+- [ENH] Added a `clean_names` method for polars - it can be used to clean the column names, or clean column values . Issue #1343 @samukweku
+- [ENH] Improved performance for non-equi joins when using numba - @samukweku PR #1341
 - [ENH] pandas Index,Series, DataFrame now supported in the `complete` method. - PR #1369 @samukweku
 
 ## [v0.27.0] - 2024-03-21

janitor/functions/__init__.py

@@ -57,7 +57,7 @@
 from .limit_column_characters import limit_column_characters
 from .min_max_scale import min_max_scale
 from .move import move
-from .pivot import pivot_longer, pivot_wider
+from .pivot import pivot_longer, pivot_longer_spec, pivot_wider
 from .process_text import process_text
 from .remove_columns import remove_columns
 from .remove_empty import remove_empty
@@ -132,6 +132,7 @@
     "min_max_scale",
     "move",
     "pivot_longer",
+    "pivot_longer_spec",
     "pivot_wider",
     "process_text",
     "remove_columns",