add classString, classStringOrNull, classStringOf, classStringOfOrNull

Author: MartkCz

src/Traits/ArrayTypeAssertTrait.php

@@ -7,6 +7,46 @@
 trait ArrayTypeAssertTrait
 {
 
+	/**
+	 * @template T of object
+	 * @param mixed[] $array
+	 * @param class-string<T> $type
+	 * @return class-string<T>
+	 */
+	public static function classStringOf(array $array, string|int $key, string $type): string
+	{
+		return TypeAssert::classStringOf(self::get($array, $key), $type);
+	}
+
+	/**
+	 * @template T of object
+	 * @param mixed[] $array
+	 * @param class-string<T> $type
+	 * @return class-string<T>|null
+	 */
+	public static function classStringOfOrNull(array $array, string|int $key, string $type): ?string
+	{
+		return TypeAssert::classStringOfOrNull(self::get($array, $key), $type);
+	}
+
+	/**
+	 * @param mixed[] $array
+	 * @return class-string
+	 */
+	public static function classString(array $array, string|int $key): string
+	{
+		return TypeAssert::classString(self::get($array, $key));
+	}
+
+	/**
+	 * @param mixed[] $array
+	 * @return class-string|null
+	 */
+	public static function classStringOrNull(array $array, string|int $key): ?string
+	{
+		return TypeAssert::classStringOrNull(self::get($array, $key));
+	}
+
 	/**
 	 * @template T of object
 	 * @param mixed[] $array

src/Traits/TypeAssertTrait.php

@@ -9,6 +9,58 @@
 trait TypeAssertTrait
 {
 
+	/**
+	 * @template T of object
+	 * @param class-string<T> $type
+	 * @return class-string<T>
+	 */
+	public static function classStringOf(mixed $value, string $type): string
+	{
+		if (!is_string($value) || !class_exists($value) || !is_a($value, $type, true)) {
+			throw new AssertionFailedException(self::createErrorMessage($value, sprintf('class-string<%s>', $type)));
+		}
+
+		return $value;
+	}
+
+	/**
+	 * @template T of object
+	 * @param class-string<T> $type
+	 * @return class-string<T>|null
+	 */
+	public static function classStringOfOrNull(mixed $value, string $type): ?string
+	{
+		if ($value !== null && (!is_string($value) || !class_exists($value) || !is_a($value, $type, true))) {
+			throw new AssertionFailedException(self::createErrorMessage($value, sprintf('class-string<%s>', $type)));
+		}
+
+		return $value;
+	}
+
+	/**
+	 * @return class-string
+	 */
+	public static function classString(mixed $value): string
+	{
+		if (!is_string($value) || !class_exists($value)) {
+			throw new AssertionFailedException(self::createErrorMessage($value, 'class-string'));
+		}
+
+		return $value;
+	}
+
+	/**
+	 * @return class-string|null
+	 */
+	public static function classStringOrNull(mixed $value): ?string
+	{
+		if ($value !== null && (!is_string($value) || !class_exists($value))) {
+			throw new AssertionFailedException(self::createErrorMessage($value, 'class-string|null'));
+		}
+
+		return $value;
+	}
+
 	/**
 	 * @template T of object
 	 * @param class-string<T> $type

tests/TypeAssert.classString.phpt

@@ -0,0 +1,21 @@
+<?php
+
+use Tester\Assert;
+use Utilitte\Asserts\Exceptions\AssertionFailedException;
+use Utilitte\Asserts\TypeAssert;
+
+require __DIR__ . '/_bootstrap.php';
+
+class A {}
+
+class B extends A {}
+
+TypeAssert::classString(A::class);
+TypeAssert::classStringOrNull(null);
+
+Assert::exception(fn () => TypeAssert::classString('foo'), AssertionFailedException::class);
+
+TypeAssert::classStringOf(A::class, A::class);
+TypeAssert::classStringOfOrNull(null, A::class);
+
+Assert::exception(fn () => TypeAssert::classStringOf(A::class, B::class), AssertionFailedException::class);