diff options
Diffstat (limited to 'vendor/beberlei/assert/lib/Assert/Assert.php')
-rw-r--r-- | vendor/beberlei/assert/lib/Assert/Assert.php | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/vendor/beberlei/assert/lib/Assert/Assert.php b/vendor/beberlei/assert/lib/Assert/Assert.php new file mode 100644 index 000000000..6910258d6 --- /dev/null +++ b/vendor/beberlei/assert/lib/Assert/Assert.php @@ -0,0 +1,96 @@ +<?php + +/** + * Assert + * + * LICENSE + * + * This source file is subject to the MIT license that is bundled + * with this package in the file LICENSE.txt. + * If you did not receive a copy of the license and are unable to + * obtain it through the world-wide-web, please send an email + * to [email protected] so I can send you a copy immediately. + */ + +namespace Assert; + +/** + * AssertionChain factory. + */ +abstract class Assert +{ + /** @var string */ + protected static $lazyAssertionExceptionClass = LazyAssertionException::class; + + /** @var string */ + protected static $assertionClass = Assertion::class; + + /** + * Start validation on a value, returns {@link AssertionChain}. + * + * The invocation of this method starts an assertion chain + * that is happening on the passed value. + * + * @param mixed $value + * @param string|callable|null $defaultMessage + * @param string|null $defaultPropertyPath + * + * @return AssertionChain + * + * @example + * + * Assert::that($value)->notEmpty()->integer(); + * Assert::that($value)->nullOr()->string()->startsWith("Foo"); + * + * The assertion chain can be stateful, that means be careful when you reuse + * it. You should never pass around the chain. + */ + public static function that($value, $defaultMessage = null, string $defaultPropertyPath = null): AssertionChain + { + $assertionChain = new AssertionChain($value, $defaultMessage, $defaultPropertyPath); + + return $assertionChain->setAssertionClassName(static::$assertionClass); + } + + /** + * Start validation on a set of values, returns {@link AssertionChain}. + * + * @param mixed $values + * @param string|callable|null $defaultMessage + * @param string|null $defaultPropertyPath + * + * @return AssertionChain + */ + public static function thatAll($values, $defaultMessage = null, string $defaultPropertyPath = null): AssertionChain + { + return static::that($values, $defaultMessage, $defaultPropertyPath)->all(); + } + + /** + * Start validation and allow NULL, returns {@link AssertionChain}. + * + * @param mixed $value + * @param string|callable|null $defaultMessage + * @param string|null $defaultPropertyPath + * + * @return AssertionChain + */ + public static function thatNullOr($value, $defaultMessage = null, string $defaultPropertyPath = null): AssertionChain + { + return static::that($value, $defaultMessage, $defaultPropertyPath)->nullOr(); + } + + /** + * Create a lazy assertion object. + * + * @return LazyAssertion + */ + public static function lazy(): LazyAssertion + { + $lazyAssertion = new LazyAssertion(); + + return $lazyAssertion + ->setAssertClass(\get_called_class()) + ->setExceptionClass(static::$lazyAssertionExceptionClass); + } +} |