feature: getTypedArray

closes #59

Author: g105b

src/Cache.php

@@ -73,6 +73,58 @@ public function getArray(string $name, callable $callback):array {
 		return $value;
 	}
 
+	/**
+	 * @template T
+	 * @param class-string<T> $className
+	 * @return array<T>
+	 */
+	public function getTypedArray(string $name, string $className, callable $callback):array {
+		$array = $this->get($name, $callback);
+		if(!is_array($array)) {
+			throw new TypeError("Value with key '$name' is not an array");
+		}
+
+		foreach($array as $key => $value) {
+			if($className === "int" || $className === "integer") {
+				if(!is_int($value)) {
+					if(is_numeric($value)) {
+						$array[$key] = (int)$value;
+					}
+					else {
+						throw new TypeError("Array value at key '$key' is not an integer");
+					}
+				}
+			}
+			elseif($className === "float" || $className === "double") {
+				if(!is_float($value)) {
+					if(is_numeric($value)) {
+						$array[$key] = (float)$value;
+					}
+					else {
+						throw new TypeError("Array value at key '$key' is not a float");
+					}
+				}
+			}
+			elseif($className === "string") {
+				if(!is_string($value)) {
+					$array[$key] = (string)$value;
+				}
+			}
+			elseif($className === "bool" || $className === "boolean") {
+				if(!is_bool($value)) {
+					$array[$key] = (bool)$value;
+				}
+			}
+			else {
+				if(!$value instanceof $className) {
+					throw new TypeError("Array value at key '$key' is not an instance of $className");
+				}
+			}
+		}
+
+		return $array;
+	}
+
 	/**
 	 * @template T
 	 * @param class-string<T> $className

test/phpunit/CacheTest.php

@@ -4,7 +4,10 @@
 use Gt\FileCache\Cache;
 use Gt\FileCache\FileAccess;
 use PHPUnit\Framework\TestCase;
+use SplFileInfo;
+use SplFixedArray;
 use stdClass;
+use TypeError;
 
 class CacheTest extends TestCase {
 	public function tearDown():void {
@@ -105,12 +108,94 @@ public function testGetArray():void {
 		self::assertSame($value, $sut->getArray("numbers", fn() => []));
 	}
 
+	public function testGetTypedArray_int():void {
+		$value = [1, "2", 3.000];
+		$sut = $this->getSut([
+			"numbers" => $value,
+		]);
+		$typedArray = $sut->getTypedArray("numbers", "int", fn() => []);
+		foreach($typedArray as $value) {
+			self::assertIsInt($value);
+		}
+	}
+
+	public function testGetTypedArray_intFailure():void {
+		$value = [1, "2", 3.000, "four"];
+		$sut = $this->getSut([
+			"numbers" => $value,
+		]);
+		self::expectException(TypeError::class);
+		$sut->getTypedArray("numbers", "int", fn() => []);
+	}
+
+	public function testGetTypedArray_float():void {
+		$value = [1, "2", 3.000];
+		$sut = $this->getSut([
+			"numbers" => $value,
+		]);
+		$typedArray = $sut->getTypedArray("numbers", "float", fn() => []);
+		foreach($typedArray as $value) {
+			self::assertIsFloat($value);
+		}
+	}
+
+	public function testGetTypedArray_floatFailure():void {
+		$value = [1, "2", 3.000, "four"];
+		$sut = $this->getSut([
+			"numbers" => $value,
+		]);
+		self::expectException(TypeError::class);
+		$sut->getTypedArray("numbers", "float", fn() => []);
+	}
+
+	public function testGetTypedArray_string():void {
+		$value = [1, "2", 3.000, "four"];
+		$sut = $this->getSut([
+			"numbers" => $value,
+		]);
+		$typedArray= $sut->getTypedArray("numbers", "string", fn() => []);
+		foreach($typedArray as $value) {
+			self::assertIsString($value);
+		}
+	}
+
+	public function testGetTypedArray_bool():void {
+		$value = [0, "1", false, true, [], new StdClass()];
+		$sut = $this->getSut([
+			"booleans" => $value,
+		]);
+		$typedArray= $sut->getTypedArray("booleans", "bool", fn() => []);
+		foreach($typedArray as $i => $value) {
+			self::assertSame((bool)($i % 2), $value, $i);
+		}
+	}
+
+	public function testGetTypedArray_class():void {
+		$value = [new SplFileInfo(__FILE__), new SplFileInfo(__DIR__)];
+		$sut = $this->getSut([
+			"files" => $value,
+		]);
+		$typedArray= $sut->getTypedArray("files", SplFileInfo::class, fn() => []);
+		foreach($typedArray as $value) {
+			self::assertInstanceOf(SplFileInfo::class, $value);
+		}
+	}
+
+	public function testGetTypedArray_classError():void {
+		$value = [new SplFileInfo(__FILE__), new SplFixedArray(), new SplFileInfo(__DIR__)];
+		$sut = $this->getSut([
+			"files" => $value,
+		]);
+		self::expectException(TypeError::class);
+		$sut->getTypedArray("files", SplFileInfo::class, fn() => []);
+	}
+
 	public function testGetArray_notArray():void {
 		$value = (object)[1, 2, 3];
 		$sut = $this->getSut([
 			"numbers" => $value,
 		]);
-		self::expectException(\TypeError::class);
+		self::expectException(TypeError::class);
 		self::expectExceptionMessage("Value with key 'numbers' is not an array");
 		$sut->getArray("numbers", fn() => []);
 	}