illuminated/testing-tools

Laravel-specific testing helpers and asserts.

, _(*1)

Laravel Testing Tools

, _(*2)

, _(*3)

, _(*4)

Laravel-specific Testing Helpers and Assertions., _(*5)

Usage

1. Install the package via Composer:, _(*6)

   shell script composer require --dev illuminated/testing-tools, _(*7)

2. Use Illuminated\Testing\TestingTools trait:, _(*8)

   use Illuminated\Testing\TestingTools;
   
   abstract class TestCase extends Illuminate\Foundation\Testing\TestCase
   {
       use TestingTools;
   
       // ...
   }
   

3. Use any of the provided helpers and assertions in your tests:, _(*9)

   class ExampleTest extends TestCase
   {
       /** @test */
       public function it_has_lots_of_useful_assertions()
       {
           $this->assertDatabaseHasMany('posts', [
               ['title' => 'Awesome!'],
               ['title' => 'Check multiple rows'],
               ['title' => 'In one simple assertion 🤟'],
           ]);
       }
   }
   

Available helpers

Feel free to contribute., _(*10)

• ApplicationHelpers
  • emulateLocal
  • emulateProduction
  • emulateEnvironment

Available assertions

Feel free to contribute., _(*11)

• CollectionAsserts
  • assertCollectionsEqual
  • assertCollectionsNotEqual
• DatabaseAsserts
  • assertDatabaseHasTable
  • assertDatabaseMissingTable
  • assertDatabaseHasMany
  • assertDatabaseMissingMany
• FilesystemAsserts
  • assertDirectoryEmpty
  • assertDirectoryNotEmpty
  • assertFilesCount
  • assertNotFilesCount
• LogFileAsserts
  • seeLogFile
  • dontSeeLogFile
  • seeInLogFile
  • dontSeeInLogFile
• ScheduleAsserts
  • seeScheduleCount
  • dontSeeScheduleCount
  • seeInSchedule
  • dontSeeInSchedule

Helpers

ApplicationHelpers

emulateLocal()

Emulate that application is running on the local environment:, _(*12)

$this->emulateLocal();

emulateProduction()

Emulate that application is running on the production environment:, _(*13)

$this->emulateProduction();

emulateEnvironment()

Emulate that application is running on the given environment:, _(*14)

$this->emulateEnvironment('demo');

Assertions

CollectionAsserts

assertCollectionsEqual()

Assert that the given collections are equal based on the specified key:, _(*15)

$this->assertCollectionsEqual($collection1, $collection2, 'id');

assertCollectionsNotEqual()

Assert that the given collections are not equal based on the specified key:, _(*16)

$this->assertCollectionsNotEqual($collection1, $collection2, 'id');

DatabaseAsserts

assertDatabaseHasTable()

Assert that the database has the given table:, _(*17)

$this->assertDatabaseHasTable('users');

assertDatabaseMissingTable()

Assert that the database doesn't have the given table:, _(*18)

$this->assertDatabaseMissingTable('unicorns');

assertDatabaseHasMany()

Assert that the database has all the given rows:, _(*19)

$this->assertDatabaseHasMany('posts', [
    ['title' => 'First Post'],
    ['title' => 'Second Post'],
    ['title' => 'Third Post'],
]);

assertDatabaseMissingMany()

Assert that the database doesn't have all the given rows:, _(*20)

$this->assertDatabaseMissingMany('posts', [
    ['title' => 'Fourth Post'],
    ['title' => 'Fifth Post'],
]);

FilesystemAsserts

assertDirectoryEmpty()

Assert that the given directory is empty:, _(*21)

$this->assertDirectoryEmpty('./my/dir/');

assertDirectoryNotEmpty()

Assert that the given directory is not empty:, _(*22)

$this->assertDirectoryNotEmpty('./my/dir/');

assertFilesCount()

Assert that directory has the given number of files:, _(*23)

$this->assertFilesCount('./my/dir/', 3);

assertNotFilesCount()

Assert that directory doesn't have the given number of files:, _(*24)

$this->assertNotFilesCount('./my/dir/', 5);

LogFileAsserts

seeLogFile()

Assert that the given log file exists., _(*25)

The path is relative to the storage/logs folder:, _(*26)

$this->seeLogFile('example.log');

dontSeeLogFile()

Assert that the given log file doesn't exist., _(*27)

The path is relative to the storage/logs folder:, _(*28)

$this->dontSeeLogFile('foobarbaz.log');

seeInLogFile()

Assert that the log file contains the given message., _(*29)

The path is relative to the storage/logs folder:, _(*30)

$this->seeInLogFile('example.log', 'Sample log message!');

Also, you can specify an array of messages:, _(*31)

$this->seeInLogFile('example.log', [
    'Sample log message 1!',
    'Sample log message 2!',
    'Sample log message 3!',
]);

You can use these placeholders in messages: - %datetime% - any datetime string., _(*32)

$this->seeInLogFile('example.log', '[%datetime%]: Sample log message!');

dontSeeInLogFile()

Assert that the log file doesn't contain the given message., _(*33)

The path is relative to the storage/logs folder:, _(*34)

$this->dontSeeInLogFile('example.log', 'Non-existing log message!');

Also, you can specify an array of messages:, _(*35)

$this->dontSeeInLogFile('example.log', [
    'Non-existing log message 1!',
    'Non-existing log message 2!',
    'Non-existing log message 3!',
]);

ScheduleAsserts

seeScheduleCount()

Assert that schedule count equals to the given value:, _(*36)

$this->seeScheduleCount(3);

dontSeeScheduleCount()

Assert that schedule count doesn't equal to the given value:, _(*37)

$this->dontSeeScheduleCount(5);

seeInSchedule()

Assert that the given command is scheduled:, _(*38)

$this->seeInSchedule('foo', 'everyFiveMinutes');
$this->seeInSchedule('bar', 'hourly');
$this->seeInSchedule('baz', 'twiceDaily');

Also, you can use cron expressions:, _(*39)

$this->seeInSchedule('foo', '*/5 * * * * *');
$this->seeInSchedule('bar', '0 * * * * *');
$this->seeInSchedule('baz', '0 1,13 * * * *');

dontSeeInSchedule()

Assert that the given command is not scheduled:, _(*40)

$this->dontSeeInSchedule('foobarbaz');

Sponsors

, _(*41)

License

Laravel Testing Tools is open-sourced software licensed under the MIT license., _(*42)

 , _(*43)