diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index 341f601a..8e345cd7 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -1,5 +1,4 @@ # These are supported funding model platforms -github: [nunomaduro,owenvoke,olivernybroe,octoper] +github: [nunomaduro,owenvoke,olivernybroe,octoper,lukeraymonddowning] patreon: nunomaduro -custom: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=66BYDWAT92N6L diff --git a/CHANGELOG.md b/CHANGELOG.md index ee5a3af9..38a673cf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/). +## [v1.7.0 (2021-06-19)](https://github.com/pestphp/pest/compare/v1.6.0...v1.7.0) +### Added +- Support for non-callable values in the sequence method, which will be passed as `toEqual` ([#323](https://github.com/pestphp/pest/pull/323)) +- Support for nested Higher Order Expectations ([#324](https://github.com/pestphp/pest/pull/324)) + +## [v1.6.0 (2021-06-18)](https://github.com/pestphp/pest/compare/v1.5.0...v1.6.0) +### Added +- Adds a new `json` expectation method to improve testing with JSON strings ([#325](https://github.com/pestphp/pest/pull/325)) +- Adds dot notation support to the `toHaveKey` and `toHaveKeys` expectations ([#322](https://github.com/pestphp/pest/pull/322)) + ## [v1.5.0 (2021-06-15)](https://github.com/pestphp/pest/compare/v1.4.0...v1.5.0) ### Changed - Moves plugins from the `require` section to the core itself ([#317](https://github.com/pestphp/pest/pull/317)), ([#318](https://github.com/pestphp/pest/pull/318)), ([#320](https://github.com/pestphp/pest/pull/320)) diff --git a/phpstan.neon b/phpstan.neon index a32cf76a..35d5f07e 100644 --- a/phpstan.neon +++ b/phpstan.neon @@ -7,6 +7,7 @@ parameters: level: max paths: - src + - scripts checkMissingIterableValueType: true checkGenericClassInNonGenericObjectType: false diff --git a/scripts/compile.php b/scripts/compile.php index 56c3974c..3779c421 100644 --- a/scripts/compile.php +++ b/scripts/compile.php @@ -15,6 +15,7 @@ $globalsFilePath = implode(DIRECTORY_SEPARATOR, [ $compiledFilePath = implode(DIRECTORY_SEPARATOR, [dirname(__DIR__), 'compiled', 'globals.php']); +/* @phpstan-ignore-next-line */ @unlink($compiledFilePath); $replace = function ($contents, $string, $by) { diff --git a/src/Concerns/Expectable.php b/src/Concerns/Expectable.php index 371bf8d4..981e443d 100644 --- a/src/Concerns/Expectable.php +++ b/src/Concerns/Expectable.php @@ -12,9 +12,13 @@ use Pest\Expectation; trait Expectable { /** + * @template TValue + * * Creates a new expectation. * - * @param mixed $value + * @param TValue $value + * + * @return Expectation */ public function expect($value): Expectation { diff --git a/src/Concerns/Extendable.php b/src/Concerns/Extendable.php index 36c39243..ee87f9ab 100644 --- a/src/Concerns/Extendable.php +++ b/src/Concerns/Extendable.php @@ -4,8 +4,8 @@ declare(strict_types=1); namespace Pest\Concerns; +use BadMethodCallException; use Closure; -use Pest\HigherOrderExpectation; /** * @internal @@ -43,7 +43,7 @@ trait Extendable public function __call(string $method, array $parameters) { if (!static::hasExtend($method)) { - return new HigherOrderExpectation($this, $method, $parameters); + throw new BadMethodCallException("$method is not a callable method name."); } /** @var Closure $extend */ diff --git a/src/Concerns/RetrievesValues.php b/src/Concerns/RetrievesValues.php new file mode 100644 index 00000000..a8d832b1 --- /dev/null +++ b/src/Concerns/RetrievesValues.php @@ -0,0 +1,31 @@ +|object $value + * @param TRetrievableValue|null $default + * + * @return TRetrievableValue|null + */ + private function retrieve(string $key, $value, $default = null) + { + if (is_array($value)) { + return $value[$key] ?? $default; + } + + // @phpstan-ignore-next-line + return $value->$key ?? $default; + } +} diff --git a/src/Expectation.php b/src/Expectation.php index 45b52891..e41f21d0 100644 --- a/src/Expectation.php +++ b/src/Expectation.php @@ -6,6 +6,7 @@ namespace Pest; use BadMethodCallException; use Pest\Concerns\Extendable; +use Pest\Concerns\RetrievesValues; use Pest\Support\Arr; use PHPUnit\Framework\Assert; use PHPUnit\Framework\Constraint\Constraint; @@ -15,12 +16,17 @@ use SebastianBergmann\Exporter\Exporter; /** * @internal * + * @template TValue + * * @property Expectation $not Creates the opposite expectation. * @property Each $each Creates an expectation on each element on the traversable value. */ final class Expectation { - use Extendable; + use Extendable { + __call as __extendsCall; + } + use RetrievesValues; /** * The expectation value. @@ -43,7 +49,7 @@ final class Expectation /** * Creates a new expectation. * - * @param mixed $value + * @param TValue $value */ public function __construct($value) { @@ -53,13 +59,23 @@ final class Expectation /** * Creates a new expectation. * - * @param mixed $value + * @param TValue $value + * + * @return Expectation */ public function and($value): Expectation { return new self($value); } + /** + * Creates a new expectation with the decoded JSON value. + */ + public function json(): Expectation + { + return $this->toBeJson()->and(json_decode($this->value, true)); + } + /** * Dump the expectation value and end the script. * @@ -112,7 +128,7 @@ final class Expectation if (is_callable($callback)) { foreach ($this->value as $item) { - $callback(expect($item)); + $callback(new self($item)); } } @@ -121,8 +137,12 @@ final class Expectation /** * Allows you to specify a sequential set of expectations for each item in a iterable "value". + * + * @template TSequenceValue + * + * @param callable(self, self): void|TSequenceValue ...$callbacks */ - public function sequence(callable ...$callbacks): Expectation + public function sequence(...$callbacks): Expectation { if (!is_iterable($this->value)) { throw new BadMethodCallException('Expectation value is not iterable.'); @@ -140,7 +160,12 @@ final class Expectation } foreach ($values as $key => $item) { - call_user_func($callbacks[$key], expect($item), expect($keys[$key])); + if (is_callable($callbacks[$key])) { + call_user_func($callbacks[$key], new self($item), new self($keys[$key])); + continue; + } + + (new self($item))->toEqual($callbacks[$key]); } return $this; @@ -704,6 +729,24 @@ final class Expectation return $this->exporter->export($value); } + /** + * Dynamically handle calls to the class or + * creates a new higher order expectation. + * + * @param array $parameters + * + * @return HigherOrderExpectation|mixed + */ + public function __call(string $method, array $parameters) + { + if (!static::hasExtend($method)) { + /* @phpstan-ignore-next-line */ + return new HigherOrderExpectation($this, $this->value->$method(...$parameters)); + } + + return $this->__extendsCall($method, $parameters); + } + /** * Dynamically calls methods on the class without any arguments * or creates a new higher order expectation. @@ -713,7 +756,7 @@ final class Expectation public function __get(string $name) { if (!method_exists($this, $name) && !static::hasExtend($name)) { - return new HigherOrderExpectation($this, $name); + return new HigherOrderExpectation($this, $this->retrieve($name, $this->value)); } /* @phpstan-ignore-next-line */ diff --git a/src/HigherOrderExpectation.php b/src/HigherOrderExpectation.php index 90044d6a..6e2ed23f 100644 --- a/src/HigherOrderExpectation.php +++ b/src/HigherOrderExpectation.php @@ -5,6 +5,7 @@ declare(strict_types=1); namespace Pest; use Pest\Concerns\Expectable; +use Pest\Concerns\RetrievesValues; /** * @internal @@ -14,6 +15,7 @@ use Pest\Concerns\Expectable; final class HigherOrderExpectation { use Expectable; + use RetrievesValues; /** * @var Expectation @@ -30,6 +32,11 @@ final class HigherOrderExpectation */ private $opposite = false; + /** + * @var bool + */ + private $shouldReset = false; + /** * @var string */ @@ -38,45 +45,12 @@ final class HigherOrderExpectation /** * Creates a new higher order expectation. * - * @param array|null $parameters - * @phpstan-ignore-next-line + * @param mixed $value */ - public function __construct(Expectation $original, string $name, ?array $parameters = null) + public function __construct(Expectation $original, $value) { - $this->original = $original; - $this->name = $name; - - $this->expectation = $this->expect( - is_null($parameters) ? $this->getPropertyValue() : $this->getMethodValue($parameters) - ); - } - - /** - * Retrieves the property value from the original expectation. - * - * @return mixed - */ - private function getPropertyValue() - { - if (is_array($this->original->value)) { - return $this->original->value[$this->name]; - } - - // @phpstan-ignore-next-line - return $this->original->value->{$this->name}; - } - - /** - * Retrieves the value of the method from the original expectation. - * - * @param array $arguments - * - * @return mixed - */ - private function getMethodValue(array $arguments) - { - // @phpstan-ignore-next-line - return $this->original->value->{$this->name}(...$arguments); + $this->original = $original; + $this->expectation = $this->expect($value); } /** @@ -92,12 +66,13 @@ final class HigherOrderExpectation /** * Dynamically calls methods on the class with the given arguments. * - * @param array $arguments + * @param array $arguments */ public function __call(string $name, array $arguments): self { - if (!$this->originalHasMethod($name)) { - return new self($this->original, $name, $arguments); + if (!$this->expectationHasMethod($name)) { + /* @phpstan-ignore-next-line */ + return new self($this->original, $this->getValue()->$name(...$arguments)); } return $this->performAssertion($name, $arguments); @@ -112,8 +87,8 @@ final class HigherOrderExpectation return $this->not(); } - if (!$this->originalHasMethod($name)) { - return new self($this->original, $name); + if (!$this->expectationHasMethod($name)) { + return new self($this->original, $this->retrieve($name, $this->getValue())); } return $this->performAssertion($name, []); @@ -122,25 +97,33 @@ final class HigherOrderExpectation /** * Determines if the original expectation has the given method name. */ - private function originalHasMethod(string $name): bool + private function expectationHasMethod(string $name): bool { return method_exists($this->original, $name) || $this->original::hasExtend($name); } + /** + * Retrieve the applicable value based on the current reset condition. + * + * @return mixed + */ + private function getValue() + { + return $this->shouldReset ? $this->original->value : $this->expectation->value; + } + /** * Performs the given assertion with the current expectation. * - * @param array $arguments + * @param array $arguments */ private function performAssertion(string $name, array $arguments): self { - $expectation = $this->opposite - ? $this->expectation->not() - : $this->expectation; + /* @phpstan-ignore-next-line */ + $this->expectation = ($this->opposite ? $this->expectation->not() : $this->expectation)->{$name}(...$arguments); - $this->expectation = $expectation->{$name}(...$arguments); // @phpstan-ignore-line - - $this->opposite = false; + $this->opposite = false; + $this->shouldReset = true; return $this; } diff --git a/src/Pest.php b/src/Pest.php index 759cb913..6fc5894b 100644 --- a/src/Pest.php +++ b/src/Pest.php @@ -6,7 +6,7 @@ namespace Pest; function version(): string { - return '1.5.0'; + return '1.7.0'; } function testDirectory(string $file = ''): string diff --git a/tests/.snapshots/success.txt b/tests/.snapshots/success.txt index 0e2054e8..f5051761 100644 --- a/tests/.snapshots/success.txt +++ b/tests/.snapshots/success.txt @@ -111,9 +111,11 @@ ✓ it works inside of each ✓ it works with sequence ✓ it can compose complex expectations + ✓ it can handle nested method calls PASS Tests\Features\Expect\HigherOrder\methodsAndProperties ✓ it can access methods and properties + ✓ it can handle nested methods and properties PASS Tests\Features\Expect\HigherOrder\properties ✓ it allows properties to be accessed from the value @@ -124,6 +126,7 @@ ✓ it works with sequence ✓ it can compose complex expectations ✓ it works with objects + ✓ it works with nested properties PASS Tests\Features\Expect\each ✓ an exception is thrown if the the type is not iterable @@ -140,6 +143,10 @@ ✓ it macros true is true with argument ✓ it macros false is not true with argument + PASS Tests\Features\Expect\json + ✓ it properly parses json string + ✓ fails with broken json string + PASS Tests\Features\Expect\not ✓ not property calls @@ -152,6 +159,8 @@ ✓ loops back to the start if it runs out of sequence items ✓ it works if the number of items in the iterable is smaller than the number of expectations ✓ it works with associative arrays + ✓ it can be passed non-callable values + ✓ it can be passed a mixture of value types PASS Tests\Features\Expect\toBe ✓ strict comparisons @@ -570,5 +579,5 @@ ✓ it is a test ✓ it uses correct parent class - Tests: 4 incompleted, 7 skipped, 356 passed + Tests: 4 incompleted, 7 skipped, 363 passed \ No newline at end of file diff --git a/tests/Features/Expect/HigherOrder/methods.php b/tests/Features/Expect/HigherOrder/methods.php index 7f340f4a..66329b73 100644 --- a/tests/Features/Expect/HigherOrder/methods.php +++ b/tests/Features/Expect/HigherOrder/methods.php @@ -59,6 +59,14 @@ it('can compose complex expectations', function () { ); }); +it('can handle nested method calls', function () { + expect(new HasMethods()) + ->newInstance()->newInstance()->name()->toEqual('Has Methods')->toBeString() + ->newInstance()->name()->toEqual('Has Methods')->not->toBeInt + ->name()->toEqual('Has Methods') + ->books()->each->toBeArray(); +}); + class HasMethods { public function name() @@ -97,4 +105,9 @@ class HasMethods ], ]; } + + public function newInstance() + { + return new static(); + } } diff --git a/tests/Features/Expect/HigherOrder/methodsAndProperties.php b/tests/Features/Expect/HigherOrder/methodsAndProperties.php index 34ce09b4..f75f698a 100644 --- a/tests/Features/Expect/HigherOrder/methodsAndProperties.php +++ b/tests/Features/Expect/HigherOrder/methodsAndProperties.php @@ -14,10 +14,20 @@ it('can access methods and properties', function () { ); }); +it('can handle nested methods and properties', function () { + expect(new HasMethodsAndProperties()) + ->meta->foo->bar->toBeString()->toEqual('baz')->not->toBeInt + ->newInstance()->meta->foo->toBeArray() + ->newInstance()->multiply(2, 2)->toEqual(4)->not->toEqual(5) + ->newInstance()->books()->toBeArray(); +}); + class HasMethodsAndProperties { public $name = 'Has Methods and Properties'; + public $meta = ['foo' => ['bar' => 'baz']]; + public $posts = [ [ 'is_published' => true, @@ -47,4 +57,9 @@ class HasMethodsAndProperties { return $x * $y; } + + public function newInstance() + { + return new static(); + } } diff --git a/tests/Features/Expect/HigherOrder/properties.php b/tests/Features/Expect/HigherOrder/properties.php index c73e3d03..154d17e4 100644 --- a/tests/Features/Expect/HigherOrder/properties.php +++ b/tests/Features/Expect/HigherOrder/properties.php @@ -58,6 +58,12 @@ it('works with objects', function () { ); }); +it('works with nested properties', function () { + expect(new HasProperties()) + ->nested->foo->bar->toBeString()->toEqual('baz') + ->posts->toBeArray()->toHaveCount(2); +}); + class HasProperties { public $name = 'foo'; @@ -72,4 +78,8 @@ class HasProperties 'title' => 'Bar', ], ]; + + public $nested = [ + 'foo' => ['bar' => 'baz'], + ]; } diff --git a/tests/Features/Expect/json.php b/tests/Features/Expect/json.php new file mode 100644 index 00000000..2228fd56 --- /dev/null +++ b/tests/Features/Expect/json.php @@ -0,0 +1,14 @@ +json() + ->name + ->toBe('Nuno'); +}); + +test('fails with broken json string', function () { + expect('{":"Nuno"}')->json(); +})->throws(ExpectationFailedException::class); diff --git a/tests/Features/Expect/sequence.php b/tests/Features/Expect/sequence.php index fe6cb635..b4f82cb5 100644 --- a/tests/Features/Expect/sequence.php +++ b/tests/Features/Expect/sequence.php @@ -44,3 +44,19 @@ test('it works with associative arrays', function () { function ($expectation, $key) { $expectation->toEqual('boom'); $key->toEqual('baz'); }, ); }); + +test('it can be passed non-callable values', function () { + expect(['foo', 'bar', 'baz'])->sequence('foo', 'bar', 'baz'); + + expect(static::getCount())->toBe(3); +}); + +test('it can be passed a mixture of value types', function () { + expect(['foo', 'bar', 'baz'])->sequence( + 'foo', + function ($expectation) { $expectation->toEqual('bar')->toBeString(); }, + 'baz' + ); + + expect(static::getCount())->toBe(4); +});