Add interfaceExists assertion (webmozarts#74)

tomaszhanc · Dec 24, 2018 · d8ea33e · d8ea33e
1 parent 18879ed
commit d8ea33e
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -175,6 +175,7 @@ Method                                                | Description
 ----------------------------------------------------- | --------------------------------------------------
 `classExists($value, $message = '')`                  | Check that a value is an existing class name
 `subclassOf($value, $class, $message = '')`           | Check that a class is a subclass of another
+`interfaceExists($value, $message = '')`              | Check that a value is an existing interface name
 `implementsInterface($value, $class, $message = '')`  | Check that a class implements an interface
 `propertyExists($value, $property, $message = '')`    | Check that a property exists in a class/object
 `propertyNotExists($value, $property, $message = '')` | Check that a property does not exist in a class/object

diff --git a/src/Assert.php b/src/Assert.php
@@ -79,6 +79,7 @@
  * @method static void nullOrWritable($value, $message = '')
  * @method static void nullOrClassExists($value, $message = '')
  * @method static void nullOrSubclassOf($value, $class, $message = '')
+ * @method static void nullOrInterfaceExists($value, $message = '')
  * @method static void nullOrImplementsInterface($value, $interface, $message = '')
  * @method static void nullOrPropertyExists($value, $property, $message = '')
  * @method static void nullOrPropertyNotExists($value, $property, $message = '')
@@ -149,6 +150,7 @@
  * @method static void allWritable($values, $message = '')
  * @method static void allClassExists($values, $message = '')
  * @method static void allSubclassOf($values, $class, $message = '')
+ * @method static void allInterfaceExists($values, $message = '')
  * @method static void allImplementsInterface($values, $interface, $message = '')
  * @method static void allPropertyExists($values, $property, $message = '')
  * @method static void allPropertyNotExists($values, $property, $message = '')
@@ -849,6 +851,16 @@ public static function subclassOf($value, $class, $message = '')
         }
     }
 
+    public static function interfaceExists($value, $message = '')
+    {
+        if (!interface_exists($value)) {
+            static::reportInvalidArgument(sprintf(
+                $message ?: 'Expected an existing interface name. got %s',
+                static::valueToString($value)
+            ));
+        }
+    }
+
     public static function implementsInterface($value, $interface, $message = '')
     {
         if (!in_array($interface, class_implements($value))) {

diff --git a/tests/AssertTest.php b/tests/AssertTest.php
@@ -296,6 +296,8 @@ public function getTests()
             array('classExists', array(__NAMESPACE__.'\Foobar'), false),
             array('subclassOf', array(__CLASS__, 'PHPUnit_Framework_TestCase'), true),
             array('subclassOf', array(__CLASS__, 'stdClass'), false),
+            array('interfaceExists', array('\Countable'), true),
+            array('interfaceExists', array(__CLASS__), false),
             array('implementsInterface', array('ArrayIterator', 'Traversable'), true),
             array('implementsInterface', array(__CLASS__, 'Traversable'), false),
             array('propertyExists', array((object) array('property' => 0), 'property'), true),