LaravelPackages.net
Acme Inc.
Toggle sidebar
roundly-consulting/testing-for-laravel

Dev-only test machinery for Laravel packages and apps: base test cases, a structural migration-order pin, and Pest expectations that can always fail

5.539
5
2.1.0
About roundly-consulting/testing-for-laravel

roundly-consulting/testing-for-laravel is a Laravel package for dev-only test machinery for laravel packages and apps: base test cases, a structural migration-order pin, and pest expectations that can always fail. It currently has 5 GitHub stars and 5.539 downloads on Packagist (latest version 2.1.0). Install it with composer require roundly-consulting/testing-for-laravel. Discover more Laravel packages by roundly-consulting or browse all Laravel packages to compare alternatives.

Last updated

Testing for Laravel — Roundly open source

Latest release Tests Code style Donate Patreon Crypto

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 13 and Pest 5.

composer require --dev roundly-consulting/testing-for-laravel phpunit/phpunit:^13.0 --with-all-dependencies

A fresh Laravel 13 app requires PHPUnit 12; naming phpunit/phpunit:^13.0 moves it to the PHPUnit 13 that Pest 5 needs. A project already on Pest 5 needs only the package.

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.

Donate to Roundly open source Become a patron on Patreon Donate crypto: BTC, ETH, BNB or SOL

License

MIT. See LICENSE.md.

Comments
Affiliate link

Get paid by clients abroad

Wise gives you local bank details in several currencies and converts at the mid-market rate. Useful when your invoices are not in your own currency.

Try Wise

Star History Chart

Get the next ones by email

New Laravel packages worth a look, once a month. No spam, one-click unsubscribe.