deprecate flip

Author: giacomocavalieri

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Unreleased
 
 - The performance of `dict.is_empty` has been improved.
+- The `flip` function in the `function` module has been deprecated.
 
 ## v0.54.0 - 2025-02-04
 

src/gleam/function.gleam

@@ -1,6 +1,7 @@
 /// Takes a function that takes two arguments and returns a new function that
 /// takes the same two arguments, but in reverse order.
 ///
+@deprecated("This function has been deprecated. Use a function literal instead: `fn(a, b) { fun(b, a) }`")
 pub fn flip(fun: fn(a, b) -> c) -> fn(b, a) -> c {
   fn(b, a) { fun(a, b) }
 }