Add tests using PHPUnit

Tests generated by Junie AI. Might not have the best possible quality
but at least we got something, and if it turns out to be complete
rubbish, we can just throw it out again without any issues, as this is
independent of the actual code base.

1 files changed, 91 insertions, 0 deletions

diff --git a/tests/Inc/ArrayUtilTest.php b/tests/Inc/ArrayUtilTest.php
new file mode 100644
index 00000000..0423e6da
--- /dev/null
+++ b/tests/Inc/ArrayUtilTest.php
@@ -0,0 +1,91 @@
+<?php
+
+use PHPUnit\Framework\TestCase;
+
+class ArrayUtilTest extends TestCase
+{
+	public function testFlattenByKeyBasicAndMissingKeys(): void
+	{
+		$in = [
+			['id' => 1, 'name' => 'a'],
+			['id' => 2, 'name' => 'b', 'x' => 5],
+			['name' => 'c'], // missing 'id' -> skipped by array_column()
+		];
+		$this->assertSame([1, 2], ArrayUtil::flattenByKey($in, 'id'));
+	}
+
+	public function testMergeByKeyMergesAcrossSubArrays(): void
+	{
+		$in = [
+			'a' => ['k1' => 1, 'k2' => 2],
+			'b' => ['k1' => 3],
+		];
+		$expected = [
+			'k1' => ['a' => 1, 'b' => 3],
+			'k2' => ['a' => 2, 'b' => false],
+		];
+		$this->assertSame($expected, ArrayUtil::mergeByKey($in));
+	}
+
+	public function testSortByColumnAscendingAndDescending(): void
+	{
+		$rows = [
+			['n' => 'b', 'v' => 2],
+			['n' => 'a', 'v' => 3],
+			['n' => 'c', 'v' => 1],
+		];
+		$copy = $rows;
+		ArrayUtil::sortByColumn($rows, 'v', SORT_ASC);
+		$this->assertSame([
+			['n' => 'c', 'v' => 1],
+			['n' => 'b', 'v' => 2],
+			['n' => 'a', 'v' => 3],
+		], $rows);
+
+		ArrayUtil::sortByColumn($copy, 'n', SORT_DESC, SORT_STRING);
+		$this->assertSame([
+			['n' => 'c', 'v' => 1],
+			['n' => 'b', 'v' => 2],
+			['n' => 'a', 'v' => 3],
+		], $copy);
+	}
+
+	public function testHasAllKeys(): void
+	{
+		$arr = ['a' => 1, 'b' => 2];
+		$this->assertTrue(ArrayUtil::hasAllKeys($arr, ['a', 'b']));
+		$this->assertFalse(ArrayUtil::hasAllKeys($arr, ['a', 'c']));
+		$this->assertTrue(ArrayUtil::hasAllKeys($arr, []));
+	}
+
+	public function testIsOnlyPrimitiveTypes(): void
+	{
+		$this->assertTrue(ArrayUtil::isOnlyPrimitiveTypes([1, 'x', 1.2, null, true, false, 0]));
+		$this->assertFalse(ArrayUtil::isOnlyPrimitiveTypes([[]]));
+		$this->assertFalse(ArrayUtil::isOnlyPrimitiveTypes([new stdClass()]));
+
+		$h = fopen('php://memory', 'r');
+		try {
+			$this->assertFalse(ArrayUtil::isOnlyPrimitiveTypes([$h]));
+		} finally {
+			if (is_resource($h))
+				fclose($h);
+		}
+	}
+
+	public function testForceTypeMutatesArrayInPlace(): void
+	{
+		$arr = ['1', '2', '3'];
+		ArrayUtil::forceType($arr, 'int');
+		$this->assertSame([1, 2, 3], $arr);
+
+		$arr = ['0', '1', '', 'foo'];
+		ArrayUtil::forceType($arr, 'bool');
+		// In PHP, (bool) '0' is false; non-empty strings except '0' are true; empty string is false
+		$this->assertSame([false, true, false, true], $arr);
+
+		$arr = [1, 2, 3];
+		ArrayUtil::forceType($arr, 'string');
+		$this->assertSame(['1', '2', '3'], $arr);
+	}
+}