jasonmccreary / laravel-test-assertions
A set of helpful assertions when testing Laravel applications.
Installs: 2 850 983
Dependents: 22
Suggesters: 5
Security: 0
Stars: 329
Watchers: 8
Forks: 36
Open Issues: 2
Requires
- php: ^8.1
- illuminate/testing: ^11.0|^12.0
- mockery/mockery: ^1.4.4
- phpunit/phpunit: ^10.1|^11.0|^12.0
README
A set of helpful assertions when testing Laravel applications.
Requirements
Your application must be running the Laravel 5.5 or higher and using Laravel's testing harness.
Installation
You may install these additional assertions with Composer by running:
composer require --dev jasonmccreary/laravel-test-assertions
Afterwards, add the trait to your base TestCase
class:
<?php namespace Tests; use JMac\Testing\Traits\AdditionalAssertions; use Illuminate\Foundation\Testing\TestCase as BaseTestCase; abstract class TestCase extends BaseTestCase { use CreatesApplication, AdditionalAssertions; }
Documentation
This package adds several assertions, matchers, and helpers aimed at making testing within Laravel easier.
Assertions
assertActionUsesFormRequest(string $controller, string $method, string $form_request)
Verifies the action for a given controller performs validation using the given form request.
assertActionUsesMiddleware(string $controller, string $method, string|array $middleware)
Verifies the action for a given controller uses the given middleware or set of middleware.
assertRouteUsesFormRequest(string $routeName, string $formRequest)
Verifies that the corresponding action/controller, for a given route name performs the validation using the given form request.
assertRouteUsesMiddleware(string $routeName, array $middlewares, bool $exact)
Verifies the route for a given route name uses all the given middlewares or only the given set of middlewares.
assertValidationRules(array $expected, array $actual)
Verifies the expected subset of validation rules for fields are within a set of validation rules. Rules may be passed as a delimited string or array.
assertExactValidationRules(array $expected, array $actual)
Verifies the expected set of validation rules for fields exactly match a set of validation rules. Rules may be passed as a delimited string or array.
assertValidationRuleContains($rule, string $class)
Verifies the rule or rules contains an instance of the given Rule class.
assertViewHasNull($key)
Verifies the view data $key
has an explicit value of null
. Note: is a TestResponse
assertion. It must be called on the response of a view.
assertNow(CarbonInterface $datetime, ?CarbonInterface $now = null)
Verifies $datetime
is equal to $now
, precise to the second. $now
defaults to Carbon::now()
which can be faked with the freezeNow()
testing helper.
Matchers
LaravelMatchers::isModel(Model $model = null)
Matches an argument is the same as $model
. When called without $model
, will match any argument of type Illuminate\Database\Eloquent\Model
.
LaravelMatchers::isCollection(Collection $collection = null)
Matches an argument equals $collection
. When called without $collection
, will match any argument of type Illuminate\Support\Collection
.
LaravelMatchers::isEloquentCollection(Collection $collection = null)
Matches an argument equals $collection
. When called without $collection
, will match any argument of type \Illuminate\Database\Eloquent\Collection
.
Helpers
createFormRequest(string $class, array $data = [])
Creates an instance of the given Form Request class with the given request data.
freezeNow(bool $subseconds = false)
Similar to Laravel's freezeTime()
helper, but defaults with second precision and returns the frozen time. You may pass true
to freeze with sub-second precision.
Support Policy
Starting with version 2, this package will only support the latest stable version of Laravel (currently Laravel 8). If you need to support older versions of Laravel, you may use version 1 or upgrade your application (try using Shift).
This package still follows semantic versioning. However, it does so with respect to its own code. Any breaking changes will increase its major version number. Otherwise, minor version number increases will contain new features. This includes changes for future versions of Laravel.