defstudio / pest-plugin-laravel-expectations

The Pest Laravel Expectations Plugin

This Pest plugin adds Laravel specific expectations to the testing ecosystem

it('can check model exists', function(){
  $user = User::factory()->create();
  
  expect($user)->toExist();
});

Installation

You can install the package via composer:

composer require --dev defstudio/pest-plugin-laravel-11.expectations

The expectations added by this plugin are automatically loaded into Pest's expectation system. They can be used along other expectations.

Documentation

A full documentation with a detailed list of available expectations can be found at:

https://docs.defstudio.it/pest-plugin-laravel-expectations

Autocompletion

For PhpStorm users, a nice Plugin has been developed by Oliver Nybroe. It adds full autocompletion to ours Laravel Expectations, it is worth to take a look: https://github.com/pestphp/pest-intellij

Changelog

All notable changes to this project in our changelog. For a full understanding of what changed and the PR that where merged, see also the releases page

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Credits

• Fabio Ivona
• All Contributors

Please see the contributing guide for details on how to contribute to this plugin.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

License

The MIT License (MIT). Please see License File for more information.

pest-plugin-laravel-expectations's Issues

expect($carbon)->toBeBirthday()

a new expectation could be added to Time category:

$born = Carbon::createFromDate(1987, 4, 23);
$noCake = Carbon::createFromDate(2014, 9, 26);
$yesCake = Carbon::createFromDate(2014, 4, 23);
$overTheHill = Carbon::now()->subYears(50);

expect($born)->toBeBirthday($noCake); // fails
expect($born)->toBeBirthday($yesCake); // passes
expect(overTheHill)->toBeBirthday(); // passes <- by default it is checked against today

using $carbon->isBirthday();

Expect, get/set

expect()->get('/dashboard')->toBeSuccessful()

expect($carbon)->toBeStartOfDay()

a new expectation could be added to Time category:

expect(now())->toBeStartOfDay();

using $carbon->isStartOfDay();

expect($carbon)->toBeYesterday()

a new expectation could be added to Time category:

expect('2021-03-11')->toBeYesterday();

using $carbon->isYesterday();

expect($carbon)->toBeNextWeek()

a new expectation could be added to Time category:

expect('2021-03-11')->toBeNextWeek();

using $carbon->isNextWeek();

expect($carbon)->toBeCurrentMinute()

a new expectation could be added to Time category:

expect(now())->toBeCurrentMinute();

using $carbon->isCurrentMinute();

expect($carbon)->toBeSameSecondAs($anotherCarbon)

a new expectation could be added to Time category:

expect(now())->toBeSameSecondAs($anotherCarbon);

using $carbon->isSameSecond($anotherCarbon);

issue with docs and tags

Hi I keep some pretty massive pest setups which I keep meaning to delegate to a package and it's even better that you are doing it for me! So first off, thanks!

You have a bit of wonkiness in going on in your sem-ver, that can make delegated updates very challenging. you may want to move that 1.0.6 branch t 1.6.0 since you are adding new apis to your package, that makes sense. It may have been a type-o but right now you how have downgraded to 1.0.6 which of course tells composer to skip it in favour of newer and shinier 1.5! I've occasionally noticed that before like people are hoarding numbers 😁. Version 1.327 is fine with me 🎉

expect($carbon)->toBeMidnight()

a new expectation could be added to Time category:

expect(now())->toBeMidnight();

using $carbon->isMidnight();

expect($carbon)->toBeLastWeek()

a new expectation could be added to Time category:

expect('2021-03-11')->toBeLastWeek();

using $carbon->isLastWeek();

expect($carbon)->toBeCurrentHour()

a new expectation could be added to Time category:

expect(now())->toBeCurrentHour();

using $carbon->isCurrentHour();

expect($model)->toBeSameModelAs($anotherModel)

a new expectation could be added to Models category:

expect($model)->toBeSameModelAs($anotherModel);

expect($carbon)->toBeSameMinuteAs($anotherCarbon)

a new expectation could be added to Time category:

expect(now())->toBeSameMinuteAs($carbon);

using $carbon->isSameMinute($anotherCarbon);

expect($carbon)->toBe($anotherCarbon)

a new expectation could be added to Time category:

expect($carbon)->toBe($anotherCarbon);

note

This feature is not possible yet. Will implement it as soon as pestphp v2 will be released with interceptors

example code shoud contain toBeRedirectToSignedRoute() instead toBeRedirect

example code shoud contain toBeRedirectToSignedRoute() instead toBeRedirect in line 59

pest-plugin-laravel-expectations/docs/content/en/expectations/responses.md

Lines 54 to 59 in 3ba9245

	### `toBeRedirectToSignedRoute()`
	Assert whether the response is redirecting to a given signed route.
	```php
	expect(get('/secret/location'))->toBeRedirect('/login');

expect($carbon)->toBeCurrentSecond()

a new expectation could be added to Time category:

expect(now())->toBeCurrentSecond();

using $carbon->isCurrentSecond();

Expect output to contain

Proxy this tool

laravel/framework#40984

As

expect()->output()->toContain('foo', 'bar')

expect($model)->toBe($anotherModel)

a new expectation could be added to Models category:

expect($model)->toBe($anotherModel); //alias for ->toBeSameModelAs()

note

This feature is not possible yet. Will implement it as soon as pestphp v2 will be released with interceptors

expect($carbon)->toBeTomorrow()

a new expectation could be added to Time category:

expect('2021-03-11')->toBeTomorrow();

using $carbon->isTomorrow();

expect($carbon)->toBeEndOfDay()

a new expectation could be added to Time category:

expect(now())->toBeEndOfDay();

using $carbon->isEndOfDay();

expect($carbon)->toBeMidday()

a new expectation could be added to Time category:

expect(now())->toBeMidday();

using $carbon->isMidday();