phpnomad/tests is the shared PHPUnit base that PHPNomad packages use for their own unit tests. It provides a TestCase wired up with Mockery-PHPUnit integration and two reflection traits for reaching into protected or private state. If you're writing application code against PHPNomad, you don't need this package. If you're contributing to a PHPNomad package, its tests/ directory almost certainly already depends on it.
composer require --dev phpnomad/testsPull it in as a dev dependency only. It isn't meant for production code paths.
PHPNomad\Tests\TestCaseextendsPHPUnit\Framework\TestCaseand mixes inMockeryPHPUnitIntegration, so Mockery expectations are verified and containers cleaned up automatically between tests.PHPNomad\Tests\Traits\WithInaccessibleMethodsprovidescallInaccessibleMethod()for invoking protected or private methods through reflection.PHPNomad\Tests\Traits\WithInaccessiblePropertiesprovidesgetProtectedProperty(),getProtectedPropertyValue(), andsetProtectedProperty()for reading and writing protected or private properties through reflection.
Each PHPNomad package defines its own package-local TestCase that extends the shared one. That gives the package its own namespace root under Tests/ while inheriting the PHPUnit and Mockery plumbing.
<?phpnamespaceMyPackage\Tests;
usePHPNomad\Tests\TestCaseasPHPNomadTestCase;
class TestCase extends PHPNomadTestCase
{
}Concrete unit tests then extend the package-local TestCase and mix in whichever traits they need.
<?phpnamespaceMyPackage\Tests\Unit;
useMyPackage\Services\WidgetBuilder;
useMyPackage\Tests\TestCase;
usePHPNomad\Tests\Traits\WithInaccessibleMethods;
class WidgetBuilderTest extends TestCase
{
use WithInaccessibleMethods;
publicfunctiontestNormalizeHandlesEmptyInput(): void
{
$builder = newWidgetBuilder();
$result = $this->callInaccessibleMethod($builder, 'normalize', '');
$this->assertSame('', $result);
}
}Framework-wide documentation lives at phpnomad.com.
MIT. See LICENSE.txt.