When you extend TestCase
, you're booting the whole framework for each test in your suite.
It's likely that you're not using all the features for each test, slowing down your
test suite considerably.
This package allows you to "opt in" to boot just the Laravel features you need for your test to pass. Your test will run much quicker as a result.
You can install the package via composer:
composer require morrislaptop/laravel-boot-maker --dev
Create the following trait in tests/CreatesPartialApplication.php
<?php
namespace Tests;
trait CreatesPartialApplication
{
/**
* Creates the application.
*
* @return \Illuminate\Foundation\Application
*/
public function createApplication()
{
$app = require __DIR__.'/../bootstrap/app.php';
return $app;
}
}
Create a base partial test class which uses this trait at tests/PartialTestCase.php
<?php
namespace Tests;
use Morrislaptop\LaravelBootMaker\PartialTestCase as BasePartialTestCase;
abstract class PartialTestCase extends BasePartialTestCase
{
use CreatesPartialApplication;
}
It's recommended to get the tests passing using the full TestCase
first, and then
drop down to PartialTestCase
and select only the Laravel features you need.
This approach ensures you're only using the Laravel features you think are using, which might be useful if trying to decouple from the framework bit.
<?php
namespace Tests\Feature;
use App\Events\QuestionCreated;
use App\Listeners\AskQuestion;
use Illuminate\Support\Facades\Event;
use Morrislaptop\LaravelBootMaker\Concerns\Events;
use Tests\PartialTestCase;
class QuestionCreatedTest extends PartialTestCase
{
use Events;
/**
* A basic feature test example.
*
* @return void
*/
public function test_example()
{
Event::fake();
Event::assertListening(QuestionCreated::class, AskQuestion::class);
}
}
For a full list of features to enable, see src/Concerns;
You can easily create your own Concerns by including it in a TestCase and ensuring
it has the setUpXXXX
and tearDownXXXX
methods.
composer test
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
Inspired by @ekvedaras at @gosuperscript
The MIT License (MIT). Please see License File for more information.
- Installer to create
CreatesPartialApplication
andPartialTestCase
- Listener to determine what Laravel features are used