/vendor/EHER/PHPUnit/src/phpunit/PHPUnit/Framework/Assert.php
PHP | 2619 lines | 1154 code | 253 blank | 1212 comment | 113 complexity | b2390d51f8fe0de4ad59eec87ae58df0 MD5 | raw file
Possible License(s): BSD-3-Clause
Large files files are truncated, but you can click here to view the full file
- <?php
- /**
- * PHPUnit
- *
- * Copyright (c) 2001-2012, Sebastian Bergmann <sebastian@phpunit.de>.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * * Neither the name of Sebastian Bergmann nor the names of his
- * contributors may be used to endorse or promote products derived
- * from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
- * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
- * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
- * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
- * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
- * POSSIBILITY OF SUCH DAMAGE.
- *
- * @package PHPUnit
- * @subpackage Framework
- * @author Sebastian Bergmann <sebastian@phpunit.de>
- * @copyright 2001-2012 Sebastian Bergmann <sebastian@phpunit.de>
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
- * @link http://www.phpunit.de/
- * @since File available since Release 2.0.0
- */
- /**
- * A set of assert methods.
- *
- * @package PHPUnit
- * @subpackage Framework
- * @author Sebastian Bergmann <sebastian@phpunit.de>
- * @copyright 2001-2012 Sebastian Bergmann <sebastian@phpunit.de>
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
- * @version Release: 3.6.10
- * @link http://www.phpunit.de/
- * @since Class available since Release 2.0.0
- */
- abstract class PHPUnit_Framework_Assert
- {
- /**
- * @var integer
- */
- private static $count = 0;
- /**
- * Asserts that an array has a specified key.
- *
- * @param mixed $key
- * @param array $array
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertArrayHasKey($key, array $array, $message = '')
- {
- if (!(is_integer($key) || is_string($key))) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 1, 'integer or string'
- );
- }
- $constraint = new PHPUnit_Framework_Constraint_ArrayHasKey($key);
- self::assertThat($array, $constraint, $message);
- }
- /**
- * Asserts that an array does not have a specified key.
- *
- * @param mixed $key
- * @param array $array
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertArrayNotHasKey($key, array $array, $message = '')
- {
- if (!(is_integer($key) || is_string($key))) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 1, 'integer or string'
- );
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_ArrayHasKey($key)
- );
- self::assertThat($array, $constraint, $message);
- }
- /**
- * Asserts that a haystack contains a needle.
- *
- * @param mixed $needle
- * @param mixed $haystack
- * @param string $message
- * @param boolean $ignoreCase
- * @param boolean $checkForObjectIdentity
- * @since Method available since Release 2.1.0
- */
- public static function assertContains($needle, $haystack, $message = '', $ignoreCase = FALSE, $checkForObjectIdentity = TRUE)
- {
- if (is_array($haystack) ||
- is_object($haystack) && $haystack instanceof Traversable) {
- $constraint = new PHPUnit_Framework_Constraint_TraversableContains(
- $needle, $checkForObjectIdentity
- );
- }
- else if (is_string($haystack)) {
- $constraint = new PHPUnit_Framework_Constraint_StringContains(
- $needle, $ignoreCase
- );
- }
- else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 2, 'array, iterator or string'
- );
- }
- self::assertThat($haystack, $constraint, $message);
- }
- /**
- * Asserts that a haystack that is stored in a static attribute of a class
- * or an attribute of an object contains a needle.
- *
- * @param mixed $needle
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @param boolean $ignoreCase
- * @param boolean $checkForObjectIdentity
- * @since Method available since Release 3.0.0
- */
- public static function assertAttributeContains($needle, $haystackAttributeName, $haystackClassOrObject, $message = '', $ignoreCase = FALSE, $checkForObjectIdentity = TRUE)
- {
- self::assertContains(
- $needle,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message,
- $ignoreCase,
- $checkForObjectIdentity
- );
- }
- /**
- * Asserts that a haystack does not contain a needle.
- *
- * @param mixed $needle
- * @param mixed $haystack
- * @param string $message
- * @param boolean $ignoreCase
- * @param boolean $checkForObjectIdentity
- * @since Method available since Release 2.1.0
- */
- public static function assertNotContains($needle, $haystack, $message = '', $ignoreCase = FALSE, $checkForObjectIdentity = TRUE)
- {
- if (is_array($haystack) ||
- is_object($haystack) && $haystack instanceof Traversable) {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_TraversableContains(
- $needle, $checkForObjectIdentity
- )
- );
- }
- else if (is_string($haystack)) {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_StringContains(
- $needle, $ignoreCase
- )
- );
- }
- else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 2, 'array, iterator or string'
- );
- }
- self::assertThat($haystack, $constraint, $message);
- }
- /**
- * Asserts that a haystack that is stored in a static attribute of a class
- * or an attribute of an object does not contain a needle.
- *
- * @param mixed $needle
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @param boolean $ignoreCase
- * @param boolean $checkForObjectIdentity
- * @since Method available since Release 3.0.0
- */
- public static function assertAttributeNotContains($needle, $haystackAttributeName, $haystackClassOrObject, $message = '', $ignoreCase = FALSE, $checkForObjectIdentity = TRUE)
- {
- self::assertNotContains(
- $needle,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message,
- $ignoreCase,
- $checkForObjectIdentity
- );
- }
- /**
- * Asserts that a haystack contains only values of a given type.
- *
- * @param string $type
- * @param mixed $haystack
- * @param boolean $isNativeType
- * @param string $message
- * @since Method available since Release 3.1.4
- */
- public static function assertContainsOnly($type, $haystack, $isNativeType = NULL, $message = '')
- {
- if (!(is_array($haystack) ||
- is_object($haystack) && $haystack instanceof Traversable)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 2, 'array or iterator'
- );
- }
- if ($isNativeType == NULL) {
- $isNativeType = PHPUnit_Util_Type::isType($type);
- }
- self::assertThat(
- $haystack,
- new PHPUnit_Framework_Constraint_TraversableContainsOnly(
- $type, $isNativeType
- ),
- $message
- );
- }
- /**
- * Asserts that a haystack that is stored in a static attribute of a class
- * or an attribute of an object contains only values of a given type.
- *
- * @param string $type
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param boolean $isNativeType
- * @param string $message
- * @since Method available since Release 3.1.4
- */
- public static function assertAttributeContainsOnly($type, $haystackAttributeName, $haystackClassOrObject, $isNativeType = NULL, $message = '')
- {
- self::assertContainsOnly(
- $type,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $isNativeType,
- $message
- );
- }
- /**
- * Asserts that a haystack does not contain only values of a given type.
- *
- * @param string $type
- * @param mixed $haystack
- * @param boolean $isNativeType
- * @param string $message
- * @since Method available since Release 3.1.4
- */
- public static function assertNotContainsOnly($type, $haystack, $isNativeType = NULL, $message = '')
- {
- if (!(is_array($haystack) ||
- is_object($haystack) && $haystack instanceof Traversable)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 2, 'array or iterator'
- );
- }
- if ($isNativeType == NULL) {
- $isNativeType = PHPUnit_Util_Type::isType($type);
- }
- self::assertThat(
- $haystack,
- new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_TraversableContainsOnly(
- $type, $isNativeType
- )
- ),
- $message
- );
- }
- /**
- * Asserts that a haystack that is stored in a static attribute of a class
- * or an attribute of an object does not contain only values of a given
- * type.
- *
- * @param string $type
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param boolean $isNativeType
- * @param string $message
- * @since Method available since Release 3.1.4
- */
- public static function assertAttributeNotContainsOnly($type, $haystackAttributeName, $haystackClassOrObject, $isNativeType = NULL, $message = '')
- {
- self::assertNotContainsOnly(
- $type,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $isNativeType,
- $message
- );
- }
- /**
- * Asserts the number of elements of an array, Countable or Iterator.
- *
- * @param integer $expectedCount
- * @param mixed $haystack
- * @param string $message
- */
- public static function assertCount($expectedCount, $haystack, $message = '')
- {
- if (!is_int($expectedCount)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'integer');
- }
- if (!$haystack instanceof Countable &&
- !$haystack instanceof Iterator &&
- !is_array($haystack)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'countable');
- }
- self::assertThat(
- $haystack,
- new PHPUnit_Framework_Constraint_Count($expectedCount),
- $message
- );
- }
- /**
- * Asserts the number of elements of an array, Countable or Iterator
- * that is stored in an attribute.
- *
- * @param integer $expectedCount
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @since Method available since Release 3.6.0
- */
- public static function assertAttributeCount($expectedCount, $haystackAttributeName, $haystackClassOrObject, $message = '')
- {
- self::assertCount(
- $expectedCount,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message
- );
- }
- /**
- * Asserts the number of elements of an array, Countable or Iterator.
- *
- * @param integer $expectedCount
- * @param mixed $haystack
- * @param string $message
- */
- public static function assertNotCount($expectedCount, $haystack, $message = '')
- {
- if (!is_int($expectedCount)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'integer');
- }
- if (!$haystack instanceof Countable &&
- !$haystack instanceof Iterator &&
- !is_array($haystack)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'countable');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_Count($expectedCount)
- );
- self::assertThat($haystack, $constraint, $message);
- }
- /**
- * Asserts the number of elements of an array, Countable or Iterator
- * that is stored in an attribute.
- *
- * @param integer $expectedCount
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @since Method available since Release 3.6.0
- */
- public static function assertAttributeNotCount($expectedCount, $haystackAttributeName, $haystackClassOrObject, $message = '')
- {
- self::assertNotCount(
- $expectedCount,
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message
- );
- }
- /**
- * Asserts that two variables are equal.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @param float $delta
- * @param integer $maxDepth
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- */
- public static function assertEquals($expected, $actual, $message = '', $delta = 0, $maxDepth = 10, $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- $constraint = new PHPUnit_Framework_Constraint_IsEqual(
- $expected, $delta, $maxDepth, $canonicalize, $ignoreCase
- );
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that a variable is equal to an attribute of an object.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @param float $delta
- * @param integer $maxDepth
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- */
- public static function assertAttributeEquals($expected, $actualAttributeName, $actualClassOrObject, $message = '', $delta = 0, $maxDepth = 10, $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertEquals(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message,
- $delta,
- $maxDepth,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that two variables are not equal.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @param float $delta
- * @param integer $maxDepth
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- * @since Method available since Release 2.3.0
- */
- public static function assertNotEquals($expected, $actual, $message = '', $delta = 0, $maxDepth = 10, $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_IsEqual(
- $expected, $delta, $maxDepth, $canonicalize, $ignoreCase
- )
- );
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that a variable is not equal to an attribute of an object.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @param float $delta
- * @param integer $maxDepth
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- */
- public static function assertAttributeNotEquals($expected, $actualAttributeName, $actualClassOrObject, $message = '', $delta = 0, $maxDepth = 10, $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertNotEquals(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message,
- $delta,
- $maxDepth,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that a variable is empty.
- *
- * @param mixed $actual
- * @param string $message
- * @throws PHPUnit_Framework_AssertionFailedError
- */
- public static function assertEmpty($actual, $message = '')
- {
- self::assertThat($actual, self::isEmpty(), $message);
- }
- /**
- * Asserts that a static attribute of a class or an attribute of an object
- * is empty.
- *
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeEmpty($haystackAttributeName, $haystackClassOrObject, $message = '')
- {
- self::assertEmpty(
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message
- );
- }
- /**
- * Asserts that a variable is not empty.
- *
- * @param mixed $actual
- * @param string $message
- * @throws PHPUnit_Framework_AssertionFailedError
- */
- public static function assertNotEmpty($actual, $message = '')
- {
- self::assertThat($actual, self::logicalNot(self::isEmpty()), $message);
- }
- /**
- * Asserts that a static attribute of a class or an attribute of an object
- * is not empty.
- *
- * @param string $haystackAttributeName
- * @param mixed $haystackClassOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeNotEmpty($haystackAttributeName, $haystackClassOrObject, $message = '')
- {
- self::assertNotEmpty(
- self::readAttribute($haystackClassOrObject, $haystackAttributeName),
- $message
- );
- }
- /**
- * Asserts that a value is greater than another value.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertGreaterThan($expected, $actual, $message = '')
- {
- self::assertThat($actual, self::greaterThan($expected), $message);
- }
- /**
- * Asserts that an attribute is greater than another value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertAttributeGreaterThan($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertGreaterThan(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that a value is greater than or equal to another value.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertGreaterThanOrEqual($expected, $actual, $message = '')
- {
- self::assertThat(
- $actual, self::greaterThanOrEqual($expected), $message
- );
- }
- /**
- * Asserts that an attribute is greater than or equal to another value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertAttributeGreaterThanOrEqual($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertGreaterThanOrEqual(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that a value is smaller than another value.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertLessThan($expected, $actual, $message = '')
- {
- self::assertThat($actual, self::lessThan($expected), $message);
- }
- /**
- * Asserts that an attribute is smaller than another value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertAttributeLessThan($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertLessThan(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that a value is smaller than or equal to another value.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertLessThanOrEqual($expected, $actual, $message = '')
- {
- self::assertThat($actual, self::lessThanOrEqual($expected), $message);
- }
- /**
- * Asserts that an attribute is smaller than or equal to another value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param string $actualClassOrObject
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertAttributeLessThanOrEqual($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertLessThanOrEqual(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that the contents of one file is equal to the contents of another
- * file.
- *
- * @param string $expected
- * @param string $actual
- * @param string $message
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- * @since Method available since Release 3.2.14
- */
- public static function assertFileEquals($expected, $actual, $message = '', $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertFileExists($expected, $message);
- self::assertFileExists($actual, $message);
- self::assertEquals(
- file_get_contents($expected),
- file_get_contents($actual),
- $message,
- 0,
- 10,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that the contents of one file is not equal to the contents of
- * another file.
- *
- * @param string $expected
- * @param string $actual
- * @param string $message
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- * @since Method available since Release 3.2.14
- */
- public static function assertFileNotEquals($expected, $actual, $message = '', $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertFileExists($expected, $message);
- self::assertFileExists($actual, $message);
- self::assertNotEquals(
- file_get_contents($expected),
- file_get_contents($actual),
- $message,
- 0,
- 10,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that the contents of a string is equal
- * to the contents of a file.
- *
- * @param string $expectedFile
- * @param string $actualString
- * @param string $message
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- * @since Method available since Release 3.3.0
- */
- public static function assertStringEqualsFile($expectedFile, $actualString, $message = '', $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertFileExists($expectedFile, $message);
- self::assertEquals(
- file_get_contents($expectedFile),
- $actualString,
- $message,
- 0,
- 10,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that the contents of a string is not equal
- * to the contents of a file.
- *
- * @param string $expectedFile
- * @param string $actualString
- * @param string $message
- * @param boolean $canonicalize
- * @param boolean $ignoreCase
- * @since Method available since Release 3.3.0
- */
- public static function assertStringNotEqualsFile($expectedFile, $actualString, $message = '', $canonicalize = FALSE, $ignoreCase = FALSE)
- {
- self::assertFileExists($expectedFile, $message);
- self::assertNotEquals(
- file_get_contents($expectedFile),
- $actualString,
- $message,
- 0,
- 10,
- $canonicalize,
- $ignoreCase
- );
- }
- /**
- * Asserts that a file exists.
- *
- * @param string $filename
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertFileExists($filename, $message = '')
- {
- if (!is_string($filename)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_FileExists;
- self::assertThat($filename, $constraint, $message);
- }
- /**
- * Asserts that a file does not exist.
- *
- * @param string $filename
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertFileNotExists($filename, $message = '')
- {
- if (!is_string($filename)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_FileExists
- );
- self::assertThat($filename, $constraint, $message);
- }
- /**
- * Asserts that a condition is true.
- *
- * @param boolean $condition
- * @param string $message
- * @throws PHPUnit_Framework_AssertionFailedError
- */
- public static function assertTrue($condition, $message = '')
- {
- self::assertThat($condition, self::isTrue(), $message);
- }
- /**
- * Asserts that a condition is false.
- *
- * @param boolean $condition
- * @param string $message
- * @throws PHPUnit_Framework_AssertionFailedError
- */
- public static function assertFalse($condition, $message = '')
- {
- self::assertThat($condition, self::isFalse(), $message);
- }
- /**
- * Asserts that a variable is not NULL.
- *
- * @param mixed $actual
- * @param string $message
- */
- public static function assertNotNull($actual, $message = '')
- {
- self::assertThat($actual, self::logicalNot(self::isNull()), $message);
- }
- /**
- * Asserts that a variable is NULL.
- *
- * @param mixed $actual
- * @param string $message
- */
- public static function assertNull($actual, $message = '')
- {
- self::assertThat($actual, self::isNull(), $message);
- }
- /**
- * Asserts that a class has a specified attribute.
- *
- * @param string $attributeName
- * @param string $className
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertClassHasAttribute($attributeName, $className, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($className) || !class_exists($className, FALSE)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'class name');
- }
- $constraint = new PHPUnit_Framework_Constraint_ClassHasAttribute(
- $attributeName
- );
- self::assertThat($className, $constraint, $message);
- }
- /**
- * Asserts that a class does not have a specified attribute.
- *
- * @param string $attributeName
- * @param string $className
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertClassNotHasAttribute($attributeName, $className, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($className) || !class_exists($className, FALSE)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'class name');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_ClassHasAttribute($attributeName)
- );
- self::assertThat($className, $constraint, $message);
- }
- /**
- * Asserts that a class has a specified static attribute.
- *
- * @param string $attributeName
- * @param string $className
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertClassHasStaticAttribute($attributeName, $className, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($className) || !class_exists($className, FALSE)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'class name');
- }
- $constraint = new PHPUnit_Framework_Constraint_ClassHasStaticAttribute(
- $attributeName
- );
- self::assertThat($className, $constraint, $message);
- }
- /**
- * Asserts that a class does not have a specified static attribute.
- *
- * @param string $attributeName
- * @param string $className
- * @param string $message
- * @since Method available since Release 3.1.0
- */
- public static function assertClassNotHasStaticAttribute($attributeName, $className, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($className) || !class_exists($className, FALSE)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'class name');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_ClassHasStaticAttribute(
- $attributeName
- )
- );
- self::assertThat($className, $constraint, $message);
- }
- /**
- * Asserts that an object has a specified attribute.
- *
- * @param string $attributeName
- * @param object $object
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertObjectHasAttribute($attributeName, $object, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_object($object)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'object');
- }
- $constraint = new PHPUnit_Framework_Constraint_ObjectHasAttribute(
- $attributeName
- );
- self::assertThat($object, $constraint, $message);
- }
- /**
- * Asserts that an object does not have a specified attribute.
- *
- * @param string $attributeName
- * @param object $object
- * @param string $message
- * @since Method available since Release 3.0.0
- */
- public static function assertObjectNotHasAttribute($attributeName, $object, $message = '')
- {
- if (!is_string($attributeName)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_object($object)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'object');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_ObjectHasAttribute($attributeName)
- );
- self::assertThat($object, $constraint, $message);
- }
- /**
- * Asserts that two variables have the same type and value.
- * Used on objects, it asserts that two variables reference
- * the same object.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- */
- public static function assertSame($expected, $actual, $message = '')
- {
- if (is_bool($expected) && is_bool($actual)) {
- self::assertEquals($expected, $actual, $message);
- } else {
- $constraint = new PHPUnit_Framework_Constraint_IsIdentical(
- $expected
- );
- self::assertThat($actual, $constraint, $message);
- }
- }
- /**
- * Asserts that a variable and an attribute of an object have the same type
- * and value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param object $actualClassOrObject
- * @param string $message
- */
- public static function assertAttributeSame($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertSame(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that two variables do not have the same type and value.
- * Used on objects, it asserts that two variables do not reference
- * the same object.
- *
- * @param mixed $expected
- * @param mixed $actual
- * @param string $message
- */
- public static function assertNotSame($expected, $actual, $message = '')
- {
- if (is_bool($expected) && is_bool($actual)) {
- self::assertNotEquals($expected, $actual, $message);
- } else {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_IsIdentical($expected)
- );
- self::assertThat($actual, $constraint, $message);
- }
- }
- /**
- * Asserts that a variable and an attribute of an object do not have the
- * same type and value.
- *
- * @param mixed $expected
- * @param string $actualAttributeName
- * @param object $actualClassOrObject
- * @param string $message
- */
- public static function assertAttributeNotSame($expected, $actualAttributeName, $actualClassOrObject, $message = '')
- {
- self::assertNotSame(
- $expected,
- self::readAttribute($actualClassOrObject, $actualAttributeName),
- $message
- );
- }
- /**
- * Asserts that a variable is of a given type.
- *
- * @param string $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertInstanceOf($expected, $actual, $message = '')
- {
- if (is_string($expected)) {
- if (class_exists($expected) || interface_exists($expected)) {
- $constraint = new PHPUnit_Framework_Constraint_IsInstanceOf(
- $expected
- );
- }
- else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 1, 'class or interface name'
- );
- }
- } else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that an attribute is of a given type.
- *
- * @param string $expected
- * @param string $attributeName
- * @param mixed $classOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeInstanceOf($expected, $attributeName, $classOrObject, $message = '')
- {
- self::assertInstanceOf(
- $expected,
- self::readAttribute($classOrObject, $attributeName),
- $message
- );
- }
- /**
- * Asserts that a variable is not of a given type.
- *
- * @param string $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertNotInstanceOf($expected, $actual, $message = '')
- {
- if (is_string($expected)) {
- if (class_exists($expected) || interface_exists($expected)) {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_IsInstanceOf($expected)
- );
- }
- else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(
- 1, 'class or interface name'
- );
- }
- } else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that an attribute is of a given type.
- *
- * @param string $expected
- * @param string $attributeName
- * @param mixed $classOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeNotInstanceOf($expected, $attributeName, $classOrObject, $message = '')
- {
- self::assertNotInstanceOf(
- $expected,
- self::readAttribute($classOrObject, $attributeName),
- $message
- );
- }
- /**
- * Asserts that a variable is of a given type.
- *
- * @param string $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertInternalType($expected, $actual, $message = '')
- {
- if (is_string($expected)) {
- $constraint = new PHPUnit_Framework_Constraint_IsType(
- $expected
- );
- } else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that an attribute is of a given type.
- *
- * @param string $expected
- * @param string $attributeName
- * @param mixed $classOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeInternalType($expected, $attributeName, $classOrObject, $message = '')
- {
- self::assertInternalType(
- $expected,
- self::readAttribute($classOrObject, $attributeName),
- $message
- );
- }
- /**
- * Asserts that a variable is not of a given type.
- *
- * @param string $expected
- * @param mixed $actual
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertNotInternalType($expected, $actual, $message = '')
- {
- if (is_string($expected)) {
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_IsType($expected)
- );
- } else {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that an attribute is of a given type.
- *
- * @param string $expected
- * @param string $attributeName
- * @param mixed $classOrObject
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertAttributeNotInternalType($expected, $attributeName, $classOrObject, $message = '')
- {
- self::assertNotInternalType(
- $expected,
- self::readAttribute($classOrObject, $attributeName),
- $message
- );
- }
- /**
- * Asserts that a string matches a given regular expression.
- *
- * @param string $pattern
- * @param string $string
- * @param string $message
- */
- public static function assertRegExp($pattern, $string, $message = '')
- {
- if (!is_string($pattern)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_PCREMatch($pattern);
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string does not match a given regular expression.
- *
- * @param string $pattern
- * @param string $string
- * @param string $message
- * @since Method available since Release 2.1.0
- */
- public static function assertNotRegExp($pattern, $string, $message = '')
- {
- if (!is_string($pattern)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_PCREMatch($pattern)
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Assert that the size of two arrays (or `Countable` or `Iterator` objects)
- * is the same.
- *
- * @param array|Countable|Iterator $expected
- * @param array|Countable|Iterator $actual
- * @param string $message
- */
- public function assertSameSize($expected, $actual, $message = '')
- {
- if (!$expected instanceof Countable &&
- !$expected instanceof Iterator &&
- !is_array($expected)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'countable');
- }
- if (!$actual instanceof Countable &&
- !$actual instanceof Iterator &&
- !is_array($actual)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'countable');
- }
- self::assertThat(
- $actual,
- new PHPUnit_Framework_Constraint_SameSize($expected),
- $message
- );
- }
- /**
- * Assert that the size of two arrays (or `Countable` or `Iterator` objects)
- * is not the same.
- *
- * @param array|Countable|Iterator $expected
- * @param array|Countable|Iterator $actual
- * @param string $message
- */
- public function assertNotSameSize($expected, $actual, $message = '')
- {
- if (!$expected instanceof Countable &&
- !$expected instanceof Iterator &&
- !is_array($expected)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'countable');
- }
- if (!$actual instanceof Countable &&
- !$actual instanceof Iterator &&
- !is_array($actual)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'countable');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_SameSize($expected)
- );
- self::assertThat($actual, $constraint, $message);
- }
- /**
- * Asserts that a string matches a given format string.
- *
- * @param string $format
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertStringMatchesFormat($format, $string, $message = '')
- {
- if (!is_string($format)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_StringMatches($format);
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string does not match a given format string.
- *
- * @param string $format
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertStringNotMatchesFormat($format, $string, $message = '')
- {
- if (!is_string($format)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_StringMatches($format)
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string matches a given format file.
- *
- * @param string $formatFile
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertStringMatchesFormatFile($formatFile, $string, $message = '')
- {
- self::assertFileExists($formatFile, $message);
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_StringMatches(
- file_get_contents($formatFile)
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string does not match a given format string.
- *
- * @param string $formatFile
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.5.0
- */
- public static function assertStringNotMatchesFormatFile($formatFile, $string, $message = '')
- {
- self::assertFileExists($formatFile, $message);
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_StringMatches(
- file_get_contents($formatFile)
- )
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string starts with a given prefix.
- *
- * @param string $prefix
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.4.0
- */
- public static function assertStringStartsWith($prefix, $string, $message = '')
- {
- if (!is_string($prefix)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_StringStartsWith(
- $prefix
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string starts not with a given prefix.
- *
- * @param string $prefix
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.4.0
- */
- public static function assertStringStartsNotWith($prefix, $string, $message = '')
- {
- if (!is_string($prefix)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_Not(
- new PHPUnit_Framework_Constraint_StringStartsWith($prefix)
- );
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string ends with a given prefix.
- *
- * @param string $suffix
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.4.0
- */
- public static function assertStringEndsWith($suffix, $string, $message = '')
- {
- if (!is_string($suffix)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(1, 'string');
- }
- if (!is_string($string)) {
- throw PHPUnit_Util_InvalidArgumentHelper::factory(2, 'string');
- }
- $constraint = new PHPUnit_Framework_Constraint_StringEndsWith($suffix);
- self::assertThat($string, $constraint, $message);
- }
- /**
- * Asserts that a string ends not with a given prefix.
- *
- * @param string $suffix
- * @param string $string
- * @param string $message
- * @since Method available since Release 3.4.0
- */
- public static function assertStringEndsNotWith($suffix, $string, $message = '')
- {
- …
Large files files are truncated, but you can click here to view the full file