From cdb8114416c1fc7a9d100546c506cd1b2fd21400 Mon Sep 17 00:00:00 2001
From: nelsonic <nelson+github@dwyl.com>
Date: Thu, 7 Sep 2023 11:05:39 +0100
Subject: [PATCH] add test and function definition for update_list_seq/3
 https://github.com/dwyl/mvp/issues/145

---
 src/mvp/16-lists.md | 55 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/src/mvp/16-lists.md b/src/mvp/16-lists.md
index 98e8753..f879ba9 100644
--- a/src/mvp/16-lists.md
+++ b/src/mvp/16-lists.md
@@ -517,4 +517,57 @@ def add_items_to_all_list(person_id) do
     end
   end)
 end
-```
\ No newline at end of file
+```
+
+## Update `list.seq`
+
+In order to _update_ the sequence of `item` `cids` for a given `list`
+we need to define a simple function.
+
+### Test `update_list_seq/3`
+
+Open the `test/app/list_test.exs` file and add the following test:
+
+```elixir
+  test "update_list_seq/3 updates the list.seq for the given list" do
+    person_id = 314
+    all_list = App.List.get_all_list_for_person(person_id)
+
+    # Create a couple of items:
+    assert {:ok, %{model: item1}} =
+        Item.create_item(%{text: "buy land!", person_id: person_id, status: 2})
+    assert {:ok, %{model: item2}} =
+      Item.create_item(%{text: "plant trees & food", person_id: person_id, status: 2})
+    assert {:ok, %{model: item3}} =
+        Item.create_item(%{text: "live best life", person_id: person_id, status: 2})
+
+    # Add the item cids to the list.seq:
+    seq = "#{item1.cid},#{item2.cid},#{item3.cid}"
+
+    # Update the list.seq for the all_list:
+    {:ok, %{model: list}} = App.List.update_list_seq(all_list.cid, person_id, seq)
+    assert list.seq == seq
+
+    # Reorder the cids and update the list.seq
+    updated_seq = "#{item3.cid},#{item2.cid},#{item1.cid}"
+    {:ok, %{model: list}} = App.List.update_list_seq(all_list.cid, person_id, updated_seq)
+    assert list.seq == updated_seq
+  end
+```
+
+Most of this test is setup code to create the `items`.
+The important bit is defining the `seq` and then invoking the `update_list_seq/3` function.
+
+
+### Implement `update_list_seq/3` function
+
+```elixir
+  def update_list_seq(list_cid, person_id, seq) do
+    list = get_list_by_cid!(list_cid)
+    update_list(list, %{seq: seq, person_id: person_id})
+  end
+```
+
+
+With that function in place we have everything we need for updating a `list`. 
+Let's add some interface code to allow `people` to reorder the `items` in their `list`!
\ No newline at end of file