lukeraymonddowning / pest-plugin-larastrap
My awesome plugin
Fund package maintenance!
lukeraymonddowning
Installs: 23 160
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 1
Forks: 2
Open Issues: 3
Requires
- php: ^8.1 || ^8.2
- pestphp/pest-plugin: ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.15
- laravel/framework: ^10.0
- orchestra/testbench: ^8.0
- pestphp/pest: ^2.0
- pestphp/pest-dev-tools: ^2.0
This package is auto-updated.
Last update: 2024-10-29 11:47:28 UTC
README
This is currently a highly experimental project and is subject to large pre-release changes.
Pest PHP is an awesome PHP testing framework. It already has amazing support for Laravel via the Laravel plugin! Occasionally however, you'll come across some quirks when working with Pest and Laravel due to the fact that Laravel hasn't been booted during the Pest compile stage. Take a look at the following example, using Higher Order Tests:
it('points to the correct URL') ->expect(route('dashboard')) ->toBe(config('app.url').'/dashboard');
If you try to run this out of the box, it will fail; we're trying to make use of Laravel's route
and config
helpers, but they require the Laravel application to be booted.
Enter Larastrap. After installing this plugin, the above test will run without issue, and you can carry on testing without any headaches!
Installation
You can install Larastrap via composer:
composer require --dev lukeraymonddowning/pest-plugin-larastrap
It will be automatically registered, so you can start using it right away!
Prerequisites
The only prerequisite for using Larastrap is having a CreatesApplication
trait in your application's tests
folder. You almost certainly already have this,
as it ships out of the box with Laravel. This trait should have a createApplication
method inside it. If you don't know what we're talking about, it likely means
everything is good to go and you can skip this section.
Common use cases
We've already highlighted that Larastrap is super useful in higher order tests.
it('can access the dashboard') ->get(route('dashboard')) ->assertOk();
Somewhere else it comes in handy is datasets. Traditionally, you wouldn't be able to make use of Laravel in your
datasets. With Larastrap, however, you have the full power of Laravel at your fingertips. For example, perhaps you
want to check that all service providers are present in your app.php
config file:
dataset('laravel service providers', function () { yield from config('app.providers'); });
Now, we have access to a dynamically updated array of provider strings that we can make use of in any test.
Perhaps we want a dataset of the middleware registered on a certain route:
dataset('admin panel middleware', function () { return Route::gatherRouteMiddleware(Route::getRoutes()->getByName('admin.dashboard'))); });
You can see how powerful this concept is; it opens up the possibility of completely dynamic datasets that grow with your application automatically.
Caveats
There are a few caveats and limitations you should be aware of when using Larastrap:
You shouldn't use the database outside of the test
Because Larastrap is basically booting its own laravel instance prior to any of your tests running, the database will be reset before your test is run. As such, you should still perform database queries inside each test.