roundly-consulting/testing-for-laravel

Testing for Laravel

The test suite that can't lie to you. A dev-only package — install it with --dev, it never ships to production — with test machinery for Laravel packages and applications: base test cases, a structural migration-order pin, a both-directions config contract, a secret-safe about capture and architecture presets, each built so it can always fail.

Installation

Requires PHP 8.4, Laravel 12 or 13, and Pest 4 (or Pest 5 on Laravel 13).

composer require --dev roundly-consulting/testing-for-laravel --with-all-dependencies

--with-all-dependencies lets Composer move the phpunit/phpunit version a fresh Laravel app locks to one your Pest major supports (PHPUnit 12 for Pest 4, PHPUnit 13 for Pest 5).

Usage

Point your package's tests/TestCase.php at the base case (in-memory SQLite, foreign keys on, migrations loaded by provider class):

use RoundlyConsulting\Testing\PackageTestCase;
use RoundlyConsulting\Wallet\WalletServiceProvider;

abstract class TestCase extends PackageTestCase
{
    protected function packageProviders(): array
    {
        return [WalletServiceProvider::class];
    }

    protected function migrationSources(): array
    {
        return [WalletServiceProvider::class];
    }
}

Then pin what the package ships — every assertion fails over an empty parse instead of passing:

use RoundlyConsulting\Testing\Arch\ArchPresets;

it('has a runnable migration order', function (): void {
    expect(__DIR__.'/../../database/migrations')
        ->toHaveRunnableMigrationOrder(foreignKeys: 3, externalTables: ['users']);
});

it('ships exactly the config keys it reads', function (): void {
    expect(__DIR__.'/../../config/wallet.php')->toSatisfyConfigContract(__DIR__.'/../../src');
});

ArchPresets::strictTypes('RoundlyConsulting\Wallet');
ArchPresets::finalByDefault('RoundlyConsulting\Wallet');
ArchPresets::noDebuggingLeftovers();

Documentation

The full documentation — configuration, every feature and its API, and testing — lives on our website: roundly-consulting.com/open-source/docs/testing-for-laravel

Release notes are in CHANGELOG.md. To contribute, see the contributing guide.

Support our work

This package is free and open source, built and maintained by Roundly Consulting. If it saves you time, please consider supporting our open-source work — a one-time donation, a monthly pledge on Patreon or a crypto donation helps fund maintenance, new features and new packages.

License

MIT. See LICENSE.md.