Download the PHP package dejwcake/testing-kit without Composer
On this page you can find all versions of the php package dejwcake/testing-kit. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package testing-kit
Testing Kit
Testing Kit is a Laravel package that provides reusable testing infrastructure for Craftable-based projects. It supplies:
- A
TestCasebase (database refresh, translator mocking, dummy CSRF, snapshot helpers, download assertions, declarative actor resolution from PHP attributes) HttpTestCase,WebTestCase,ApiTestCasefor HTTP / web / API integration testsContextPHP attribute for declarativecustomer | admin-user | anonymoussetup per test method or classUserFactoryandAdminUserFactorywith the underlying model class pluggable via config (constructor-injectedHasher);AdminUserFactoryalso assigns the configured admin role- HTML snapshot driver and
SnapshotAssertstrait for view snapshot testing OpenApiValidationTraitand helperUtilfor asserting responses against an OpenAPI spec
This package is part of Craftable (dejwCake/craftable), an administration starter kit for Laravel.
Install
Add the path repository (or a Packagist version) and require as a dev dependency in your application:
The TestingKitServiceProvider is auto-discovered by Laravel.
Publish the config (optional) to override the user models, default emails, role name, or the OpenAPI spec path:
Config
config/testing-kit.php (after publishing):
| Key | Default | Purpose |
|---|---|---|
user_model |
App\Models\User |
Model class used by UserFactory |
admin_user_model |
Brackets\AdminAuth\Models\AdminUser |
Model class used by AdminUserFactory |
authenticated_user_id |
123 |
Default id used by actingAsCustomer() / actingAsAdminUser() when none is passed |
dummy_csrf_token |
'csrf-token-mock' |
Token put into the test session |
default_locale |
'en' |
Locale set in createApplication() |
default_user_email |
'[email protected]' |
Email pinned on customer fixtures |
default_admin_user_email |
'[email protected]' |
Email pinned on admin user fixtures |
default_admin_role |
'Administrator' |
Role assigned to admin user fixtures via Spatie HasRoles |
openapi.spec_path |
storage_path('api-docs/openapi.json') |
Spec file used by ApiTestCase |
openapi.regenerate_command |
'l5-swagger:generate' |
Artisan command to regenerate the spec |
openapi.regenerate_on_init |
true |
Whether ApiTestCase::setUp regenerates the spec |
Usage
Web test (HTML snapshot + download assertion)
API test (OpenAPI validation)
Acting as an admin
#[Context(user: 'admin-user')] resolves the guard from admin-auth.defaults.guard (Spatie HasRoles then sees the admin guard, so the role lookup matches the admin-auth installation migration). The fixture admin user has id = testing-kit.authenticated_user_id.
Issues
If something is not working as expected, please open an issue in the main repository https://github.com/dejwCake/craftable.
How to develop this project
Composer
Update dependencies:
Composer normalization:
Run tests
Run tests with pcov:
To regenerate snapshots use:
To switch between postgresql and mariadb change in docker-compose.yml DB_CONNECTION environmental variable:
Run code analysis tools (php-qa)
PHP compatibility:
Code style:
Fix style issues:
Static analysis (phpstan):
Mess detector (phpmd):
All versions of testing-kit with dependencies
ext-dom Version *
ext-libxml Version *
illuminate/support Version ^13.0
league/openapi-psr7-validator Version ^0.24
mockery/mockery Version ^1.6
nyholm/psr7 Version ^1.8
spatie/phpunit-snapshot-assertions Version ^5.4
symfony/psr-http-message-bridge Version ^8.1
zircote/swagger-php Version ^6.5