Version 1

[yaffs-website] / vendor / phpunit / phpunit / src / Framework / Constraint / ArraySubset.php

diff --git a/vendor/phpunit/phpunit/src/Framework/Constraint/ArraySubset.php b/vendor/phpunit/phpunit/src/Framework/Constraint/ArraySubset.php
new file mode 100644 (file)
index 0000000..aa67238
--- /dev/null
+++ b/vendor/phpunit/phpunit/src/Framework/Constraint/ArraySubset.php
@@ -0,0 +1,95 @@
+<?php
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+/**
+ * Constraint that asserts that the array it is evaluated for has a specified subset.
+ *
+ * Uses array_replace_recursive() to check if a key value subset is part of the
+ * subject array.
+ *
+ * @since Class available since Release 4.4.0
+ */
+class PHPUnit_Framework_Constraint_ArraySubset extends PHPUnit_Framework_Constraint
+{
+    /**
+     * @var array|ArrayAccess
+     */
+    protected $subset;
+
+    /**
+     * @var bool
+     */
+    protected $strict;
+
+    /**
+     * @param array|ArrayAccess $subset
+     * @param bool              $strict Check for object identity
+     */
+    public function __construct($subset, $strict = false)
+    {
+        parent::__construct();
+        $this->strict = $strict;
+        $this->subset = $subset;
+    }
+
+    /**
+     * Evaluates the constraint for parameter $other. Returns true if the
+     * constraint is met, false otherwise.
+     *
+     * @param array|ArrayAccess $other Array or ArrayAccess object to evaluate.
+     *
+     * @return bool
+     */
+    protected function matches($other)
+    {
+        //type cast $other & $this->subset as an array to allow 
+        //support in standard array functions.
+        if($other instanceof ArrayAccess) {
+            $other = (array) $other;
+        }
+
+        if($this->subset instanceof ArrayAccess) {
+            $this->subset = (array) $this->subset;
+        }
+
+        $patched = array_replace_recursive($other, $this->subset);
+
+        if ($this->strict) {
+            return $other === $patched;
+        } else {
+            return $other == $patched;
+        }
+    }
+
+    /**
+     * Returns a string representation of the constraint.
+     *
+     * @return string
+     */
+    public function toString()
+    {
+        return 'has the subset ' . $this->exporter->export($this->subset);
+    }
+
+    /**
+     * Returns the description of the failure
+     *
+     * The beginning of failure messages is "Failed asserting that" in most
+     * cases. This method should return the second part of that sentence.
+     *
+     * @param mixed $other Evaluated value or object.
+     *
+     * @return string
+     */
+    protected function failureDescription($other)
+    {
+        return 'an array ' . $this->toString();
+    }
+}