test: convert LIST unit tests from CMock to Ztest framework

.github/workflows/zephyr-unit-tests.yml

@@ -0,0 +1,61 @@
+---
+name: "Unit tests"
+# yamllint disable-line rule:truthy
+on:
+  pull_request:
+    branches:
+      - 'main'
+
+permissions:
+  contents: read
+
+# Specifies group name that stops previous workflows if the name matches
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  zephyr-utests:
+    name: Zephyr Unit Tests (ZTest)
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+
+    steps:
+      - name: Install build tools
+        run: |
+          sudo apt-get update
+          sudo apt-get -y install clang llvm ninja-build device-tree-compiler \
+           python3-pyelftools
+          # Install multilib packages required for native_sim i386 target
+          sudo apt-get install gcc-multilib g++-multilib
+
+      - name: Checkout SOF repository
+        uses: actions/checkout@v4
+        with:
+          path: ./workspace/sof
+          fetch-depth: 2
+          filter: 'tree:0'
+
+      - name: West update
+        run: |
+          cd workspace/sof
+          pip3 install west
+          west init -l
+          west update --narrow --fetch-opt=--filter=tree:0
+
+      - name: Install Python dependencies
+        run: |
+          cd workspace/zephyr
+          pip3 install --user -r scripts/requirements.txt
+
+      - name: Build and run unit tests
+        run: |
+          cd workspace
+          export ZEPHYR_TOOLCHAIN_VARIANT=llvm
+          west twister --testsuite-root sof/test/ztest/unit/ --platform native_sim --verbose \
+           --inline-logs
+  # This part is commented out because it is not needed at the moment.
+  #    - name: Install Zephyr SDK
+  #      run: |
+  #        cd workspace/zephyr
+  #        west sdk install --version 0.16.9 -t xtensa-intel_ace30_ptl_zephyr-elf

test/ztest/unit/list/CMakeLists.txt

@@ -0,0 +1,10 @@
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(test_list)
+
+set(SOF_ROOT "${PROJECT_SOURCE_DIR}/../../../..")
+
+target_include_directories(app PRIVATE ${SOF_ROOT}/src/include)
+
+target_sources(app PRIVATE test_list_ztest.c)

test/ztest/unit/list/prj.conf

@@ -0,0 +1 @@
+CONFIG_ZTEST=y

test/ztest/unit/list/test_list_ztest.c

@@ -0,0 +1,165 @@
+// SPDX-License-Identifier: BSD-3-Clause
+//
+// Copyright(c) 2025 Intel Corporation. All rights reserved.
+//
+// These contents may have been developed with support from one or more Intel-operated
+// generative artificial intelligence solutions.
+
+#include <zephyr/ztest.h>
+#include <sof/list.h>
+
+/**
+ * @brief Test list_init functionality
+ *
+ * Tests that list.prev and list.next point to the list itself after initialization
+ */
+ZTEST(sof_list_suite, test_list_init)
+{
+	struct list_item list = {.prev = NULL, .next = NULL};
+
+	list_init(&list);
+
+	/* Verify that prev and next pointers point to the list itself after initialization */
+	zassert_equal(&list, list.prev, "list.prev should point to itself after list_init");
+	zassert_equal(&list, list.next, "list.next should point to itself after list_init");
+}
+
+/**
+ * @brief Test list_is_empty functionality
+ *
+ * Tests that list_is_empty returns true for empty lists and false for non-empty lists
+ */
+ZTEST(sof_list_suite, test_list_is_empty)
+{
+	struct list_item list;
+	struct list_item item;
+
+	/* Test when list is empty */
+	list_init(&list);
+	zassert_true(list_is_empty(&list), "list_is_empty should return true for empty list");
+
+	/* Test when list is not empty */
+	list_item_append(&item, &list);
+	zassert_false(list_is_empty(&list), "list_is_empty should return false for non-empty list");
+}
+
+/**
+ * @brief Test list_item_append functionality
+ *
+ * Tests that list_item_append correctly appends an item to the end of the list
+ */
+ZTEST(sof_list_suite, test_list_item_append)
+{
+	struct list_item head;
+	struct list_item item1;
+	struct list_item item2;
+
+	/* Initialize list */
+	list_init(&head);
+
+	/* Append first item */
+	list_item_append(&item1, &head);
+	zassert_equal(&item1, head.next, "head->next should point to item1");
+	zassert_equal(&item1, head.prev, "head->prev should point to item1");
+	zassert_equal(&head, item1.next, "item1->next should point to head");
+	zassert_equal(&head, item1.prev, "item1->prev should point to head");
+
+	/* Append second item */
+	list_item_append(&item2, &head);
+	zassert_equal(&item1, head.next, "head->next should still point to item1");
+	zassert_equal(&item2, head.prev, "head->prev should now point to item2");
+	zassert_equal(&item2, item1.next, "item1->next should now point to item2");
+	zassert_equal(&head, item1.prev, "item1->prev should still point to head");
+	zassert_equal(&head, item2.next, "item2->next should point to head");
+	zassert_equal(&item1, item2.prev, "item2->prev should point to item1");
+}
+
+/**
+ * @brief Test list_item_prepend functionality
+ *
+ * Tests that list_item_prepend correctly prepends an item to the beginning of the list
+ */
+ZTEST(sof_list_suite, test_list_item_prepend)
+{
+	struct list_item head;
+	struct list_item item1;
+	struct list_item item2;
+
+	/* Initialize list */
+	list_init(&head);
+
+	/* Prepend first item */
+	list_item_prepend(&item1, &head);
+	zassert_equal(&item1, head.next, "head->next should point to item1");
+	zassert_equal(&item1, head.prev, "head->prev should point to item1");
+	zassert_equal(&head, item1.next, "item1->next should point to head");
+	zassert_equal(&head, item1.prev, "item1->prev should point to head");
+
+	/* Prepend second item */
+	list_item_prepend(&item2, &head);
+	zassert_equal(&item2, head.next, "head->next should now point to item2");
+	zassert_equal(&item1, head.prev, "head->prev should still point to item1");
+	zassert_equal(&item1, item2.next, "item2->next should point to item1");
+	zassert_equal(&head, item2.prev, "item2->prev should point to head");
+	zassert_equal(&head, item1.next, "item1->next should still point to head");
+	zassert_equal(&item2, item1.prev, "item1->prev should now point to item2");
+}
+
+/**
+ * @brief Test list_item_del functionality
+ *
+ * Tests that list_item_del correctly removes an item from a list
+ */
+ZTEST(sof_list_suite, test_list_item_del)
+{
+	struct list_item head;
+	struct list_item item1;
+	struct list_item item2;
+
+	/* Initialize list */
+	list_init(&head);
+
+	/* Add items to list */
+	list_item_append(&item1, &head);
+	list_item_append(&item2, &head);
+
+	/* Remove first item */
+	list_item_del(&item1);
+
+	/* Check that item1 is properly removed and initialized */
+	zassert_equal(&item1, item1.next, "item1->next should point to itself after deletion");
+	zassert_equal(&item1, item1.prev, "item1->prev should point to itself after deletion");
+
+	/* Check that head and item2 are properly linked */
+	zassert_equal(&item2, head.next, "head->next should point to item2");
+	zassert_equal(&item2, head.prev, "head->prev should point to item2");
+	zassert_equal(&head, item2.next, "item2->next should point to head");
+	zassert_equal(&head, item2.prev, "item2->prev should point to head");
+}
+
+/**
+ * @brief Test list_item_is_last functionality
+ *
+ * Tests that list_item_is_last correctly identifies the last item in a list
+ */
+ZTEST(sof_list_suite, test_list_item_is_last)
+{
+	struct list_item head;
+	struct list_item item1;
+	struct list_item item2;
+
+	/* Initialize list */
+	list_init(&head);
+
+	/* Add items to list */
+	list_item_append(&item1, &head);
+	list_item_append(&item2, &head);
+
+	/* Check item positions */
+	zassert_false(list_item_is_last(&item1, &head),
+		      "item1 should not be the last item in the list");
+	zassert_true(list_item_is_last(&item2, &head),
+		     "item2 should be the last item in the list");
+}
+
+ZTEST_SUITE(sof_list_suite, NULL, NULL, NULL, NULL, NULL);

test/ztest/unit/list/testcase.yaml

@@ -0,0 +1,12 @@
+# SPDX-License-Identifier: BSD-3-Clause
+#
+# Copyright(c) 2025 Intel Corporation. All rights reserved.
+#
+# These contents may have been developed with support from one or more Intel-operated
+# generative artificial intelligence solutions.
+
+tests:
+  sof.list:
+    platform_allow: native_sim
+    harness: ztest
+    tags: unit