README

A package that creates PEST tests specifically tailored for your Filament components.

Important

The project is currently on hold as both active maintainers are unable to dedicate time due to work commitments and other responsibilities. However, we encourage anyone in the community to contribute and help keep the project alive. Your efforts would make a big difference in maintaining its momentum.

Early development

This package is still in early development. Some features may not be available yet or may not work as expected. If you encounter any issues, please create an issue on this repository.

Caution

This package is not production-ready yet, use it at your own risk. ⚠️

Installation

You can install the package via composer:

composer require codewithdennis/filament-tests --dev

You can publish the config file with:

php artisan vendor:publish --tag="filament-tests-config"

Requirements

This package requires Filament v3 or later to run.

This package generates PestPHP tests, make sure you have it installed in your project. You can install it by running the following command:

composer require pestphp/pest --dev --with-all-dependencies

Make sure you have the following plugins installed as well:

composer require pestphp/pest-plugin-livewire --dev

composer require pestphp/pest-plugin-laravel --dev

Usage

You can create a new test for a resource by running the following command:

The following name formats are supported: blog, Blog, BlogResource

php artisan make:filament-test BlogResource

You can also pass a comma-separated list of resource names to create tests for multiple resources at once:

php artisan make:filament-test "BlogResource, PostResource"

If you don't specify a resource name, you will be prompted to choose one or more resources to create tests for interactively.

php artisan make:filament-test

Options

Tests

Tests are generated on demand and are tailored to the component that you're generating tests for. For example, if the resource component doesn't have any sortable columns, then the tests for sorting won't be generated.

Available Tests

List of available tests (46) ✔️

it can render the registration page
it can render the password reset page
it can render the login page
it can render the create page
it has create form
has a disabled field on create form
it has a field on create form
it has a hidden field on create form
it can render the edit page
it can render the relation manager on the edit page
it has the correct table heading on the relation manager on the edit page
it has the correct table description on the relation manager on the edit page
it can render column on the relation manager on the edit page
it cannot render column on the relation manager on the edit page
it has the correct descriptions above on the relation manager on the edit page
it has the correct descriptions below on the relation manager on the edit page
it has a field on edit form
it has a hidden field on edit form
it has column on the relation manager on the edit page
it has extra attributes on the relation manager on the edit page
it can search column on the relation manger on the edit page
it can (individually) search column on the relation manger on the edit page
it has select column with correct options on the relation manager on the edit page
it can sort column on the relation manager on the edit page
it can list records on the index page on the relation manager on the edit page
it can list records on the index page on the relation manager on the edit page with pagination
it can render the view page
it can render the relation manager on the view page
it has the correct table heading on the relation manager on the view page
it has the correct table description on the relation manager on the view page
it can render column on the relation manager on the view page
it cannot render column on the relation manager on the view page
it has the correct descriptions above on the relation manager on the view page
it has the correct descriptions below on the relation manager on the view page
it has a field on view form
it has a hidden field on view form
it has column on the relation manager on the view page
it has extra attributes on the relation manager on the view page
it can search column on the relation manger on the view page
it can (individually) search column on the relation manger on the view page
it has select column with correct options on the relation manager on the view page
it can sort column on the relation manager on the view page
it can list records on the index page on the relation manager on the view page
it can list records on the index page on the relation manager on the view page with pagination
it has edit form
it has header actions on the index page
it cannot render header actions on the index page
it can render header actions on the index page
it can list records on the index page
it can list records on the index page with pagination
it can render the index page
it cannot display trashed records by default
it has the correct table description
it has the correct table heading
it can delete records
it can force delete records
it can soft delete records
it has table action
it can replicate records
it can restore records
it has the correct URL for table action
it has the correct URL and opens in a new tab for table action
it can bulk delete records
it can bulk force delete records
it can bulk delete records
it has table bulk action
it can bulk restore records
it can bulk soft delete records
it cannot render column
it has the correct descriptions above
it has the correct descriptions below
it has column
it has extra attributes
it can render column
it can search column
it can individually search by column
it has the correct options
it can sort column
it can reset table filters
it can render the view page

Publishing Stubs

You can customize the stubs by publishing them to your project:

php artisan vendor:publish --tag="filament-tests-stubs"

Running the package tests

💡 Please make sure to uncomment Illuminate\Foundation\Testing\RefreshDatabase::class in tests/Pest.php before running the tests.

Additionally, make sure to have a .env.testing file with a valid database connection or uncomment the DB_CONNECTION and DB_DATABASE values in the phpunit.xml file.

You can run your tests normally by running the following command:

vendor/bin/pest

You can choose to only run the tests for this package by running the following command:

vendor/bin/pest --group=filament-tests

You can also run all your tests except the ones for this package by running the following command:

vendor/bin/pest --exclude-group=filament-tests

Additional grouping options

You can add any of those above groups to either --exclude-group or --group to include or exclude them from the test run. You can comma-separate multiple groups.

Credits

License

The MIT License (MIT). Please see License File for more information.

codewithdennis / filament-tests

Maintainers

Details