Merge branch 'main' into iterator-find-map

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- The `list` module gains the `wrap` function.
 - The `iterator.find_map` has been added.
 
 ## v0.37.0 - 2024-04-19

src/gleam/list.gleam

@@ -582,6 +582,26 @@ pub fn new() -> List(a) {
   []
 }
 
+/// Returns the given item wrapped in a list.
+/// 
+/// ## Examples
+/// 
+/// ```gleam
+/// wrap(1)
+/// // -> [1]
+/// 
+/// wrap(["a", "b", "c"])
+/// // -> [["a", "b", "c"]]
+/// 
+/// wrap([[]])
+/// // -> [[[]]]
+/// ```
+/// 
+/// 
+pub fn wrap(item: a) -> List(a) {
+  [item]
+}
+
 /// Joins one list onto the end of another.
 ///
 /// This function runs in linear time, and it traverses and copies the first

test/gleam/list_test.gleam

@@ -255,6 +255,26 @@ pub fn new_test() {
   |> should.equal([])
 }
 
+pub fn wrap_test() {
+  list.wrap([])
+  |> should.equal([[]])
+
+  list.wrap([[]])
+  |> should.equal([[[]]])
+
+  list.wrap(Nil)
+  |> should.equal([Nil])
+
+  list.wrap(1)
+  |> should.equal([1])
+
+  list.wrap([1, 2])
+  |> should.equal([[1, 2]])
+
+  list.wrap([[1, 2, 3]])
+  |> should.equal([[[1, 2, 3]]])
+}
+
 pub fn append_test() {
   list.append([1], [2, 3])
   |> should.equal([1, 2, 3])