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

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.

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

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"

This is the contents of the published config file:

return [
    /**
     * The directory where the tests will be generated in.
     */
    'directory_name' => env('FILAMENT_TESTS_DIRECTORY_NAME', 'tests/Feature'),

    /**
     * Whether to separate the tests into folders based on the resource name.
     */
    'separate_tests_into_folders' => env('FILAMENT_TESTS_SEPARATE_TESTS_INTO_FOLDERS', false),
];

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 packages installed as well:

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

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

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

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

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.

Resources

• [x] It can render page
• [x] It can render create page
• [x] It can render edit page
• [x] It can not render page
• [x] It can sort column
• [x] It can render column
• [x] It can search column
• [x] It has column
• [x] It has the correct descriptions
• [x] It has extra attributes
• [x] It has the correct options (SelectColumn)
• [x] It can delete records
• [x] It can soft delete records
• [x] It can bulk delete records
• [x] It can bulk soft delete records
• [x] It can restore records
• [x] It can bulk restore records
• [x] It can replicate records
• [x] It can force delete records
• [x] It can bulk force delete records
• [x] It can reset table filters
• [x] It has table actions
• [x] It has the correct URL for table action
• [x] It has the correct URL and opens in a new tab for table action
• [x] It has table bulk actions
• [X] It has header actions on the index page
• [X] It cannot render header actions on the index page
• [X] It can render header actions on the index page
• [x] It has the correct table heading
• [x] It has the correct table description
• [ ] It can filter table records
• [ ] It can remove table filters

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

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.

• CodeWithDennis
• Dissto
• All Contributors

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