fix

CHANGELOG.md

@@ -5,6 +5,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 <!-- ## [Unreleased] -->
 
+## [4.0.0] - 2025-01-01
+
+Bugfix release of 3.0.2 but containing breaking change:
+
+- `given.ok_in` has the labels switched, before:
+
+   ```gleam
+   pub fn ok_in(
+     result rslt: Result(a, e),
+     else_return consequence: fn(a) -> c,
+     return alternative: fn(e) -> c,
+   ) -> c
+   ```
+
+   after:
+
+   ```gleam
+   pub fn ok_in(
+     result rslt: Result(a, e),
+     else_return alternative: fn(e) -> c,
+     return consequence: fn(a) -> c,
+   ) -> c
+   ```
+
 ## [3.0.2] - 2024-12-16
 
 - Fix readme.

gleam.toml

@@ -1,5 +1,5 @@
 name = "given"
-version = "3.0.2"
+version = "4.0.0"
 
 # Fill out these fields if you intend to generate HTML documentation or publish
 # your project to the Hex package manager.

src/given.gleam

@@ -70,8 +70,8 @@ pub fn not_given(
 ///
 pub fn ok_in(
   result rslt: Result(a, e),
-  else_return consequence: fn(a) -> c,
-  return alternative: fn(e) -> c,
+  else_return alternative: fn(e) -> c,
+  return consequence: fn(a) -> c,
 ) -> c {
   case rslt {
     Ok(val) -> consequence(val)

test/given_test.gleam

@@ -69,6 +69,24 @@ pub fn given_ok_in_test() {
   |> should.equal(woof)
 }
 
+pub fn given_ok_in_unusual_usage_test() {
+  {
+    let result = Ok(great)
+    use error_value <- given.ok_in(result, return: fn(ok_value) { ok_value })
+    // …user handles Error value here…
+    error_value
+  }
+  |> should.equal(great)
+
+  {
+    let result = Error(woof)
+    use error_value <- given.ok_in(result, return: fn(ok_value) { ok_value })
+    // …user handles Error value here…
+    error_value
+  }
+  |> should.equal(woof)
+}
+
 pub fn given_error_in_test() {
   {
     let result = Error(woof)