https://github.com/dillingham/nova-assertions
Laravel Nova assertions for your tests
https://github.com/dillingham/nova-assertions
laravel laravel-nova testing
Last synced: about 1 year ago
JSON representation
Laravel Nova assertions for your tests
- Host: GitHub
- URL: https://github.com/dillingham/nova-assertions
- Owner: dillingham
- License: mit
- Created: 2019-07-14T00:14:58.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-09-15T10:52:55.000Z (almost 3 years ago)
- Last Synced: 2024-04-30T07:45:24.575Z (about 2 years ago)
- Topics: laravel, laravel-nova, testing
- Language: PHP
- Homepage:
- Size: 85 KB
- Stars: 78
- Watchers: 3
- Forks: 16
- Open Issues: 10
-
Metadata Files:
- Readme: readme.md
- License: license.md
Awesome Lists containing this project
README
# Nova Assertions
[](https://packagist.org/packages/dillingham/nova-assertions)
[](https://packagist.org/packages/dillingham/nova-assertions) [](https://twitter.com/im_brian_d)
Nova requests & assertions for Laravel tests - [View examples](https://github.com/dillingham/nova-assertions/tree/master/examples)
Assert:
[Policies](https://github.com/dillingham/nova-assertions#assert-policies) |
[Cards](https://github.com/dillingham/nova-assertions#assert-cards) |
[Actions](https://github.com/dillingham/nova-assertions#assert-actions) |
[Filters](https://github.com/dillingham/nova-assertions#assert-filters) |
[Lenses](https://github.com/dillingham/nova-assertions#assert-lenses) |
[Resources](https://github.com/dillingham/nova-assertions#assert-resources) |
[Fields](https://github.com/dillingham/nova-assertions#assert-fields) |
[Relations](https://github.com/dillingham/nova-assertions#assert-relations)
---
### Installation
```
composer require dillingham/nova-assertions --dev
```
Enable by adding the `NovaAssertions` to a test
```php
use NovaTesting\NovaAssertions;
class UserTest extends TestCase
{
use NovaAssertions;
}
```
---
### Authentication
Log in a user that **[has access to Nova](https://nova.laravel.com/docs/2.0/installation.html#authorizing-nova)**
```php
$this->be(factory(User::class)->create());
```
### Nova Requests
Request using a resource's uriKey to perform assertions:
```php
$response = $this->novaIndex('users');
$response = $this->novaDetail('users', $user->id);
$response = $this->novaCreate('users');
$response = $this->novaEdit('users', $user->id);
$response = $this->novaLens('users', Lens::class);
```
### Request Filters
You may also pass filters & their values to indexes & lenses
```php
$response = $this->novaIndex('users', [
StatusFilter::class => 'active'
]);
```
```php
$response = $this->novaLens('users', Lens::class, [
StatusFilter::class => 'active'
]);
```
### Assert Http
You can call **[http response methods](https://laravel.com/docs/5.8/http-tests#available-assertions)** as usual:
```php
$response->assertOk();
```
### Assert Resources
```php
$response->assertResourceCount(3);
```
```php
$response->assertResources(function($resources) {
return $resources->count() > 0;
});
```
### Assert Cards
```php
$response->assertCardCount(5);
```
```php
$response->assertCardsInclude(Card::class);
```
```php
$response->assertCardsExclude(Card::class);
```
```php
$response->assertCards(function($cards) {
return $cards->count() > 0;
});
```
### Assert Actions
```php
$response->assertActionCount(5);
```
```php
$response->assertActionsInclude(Action::class);
```
```php
$response->assertActionsExclude(Action::class);
```
```php
$response->assertActions(function($actions) {
return $actions->count() > 0;
});
```
### Assert Filters
```php
$response->assertFilterCount(5);
```
```php
$response->assertFiltersInclude(Filter::class);
```
```php
$response->assertFiltersExclude(Filter::class);
```
```php
$response->assertFilters(function($filters) {
return $filters->count() > 0;
});
```
### Assert Lenses
```php
$response->assertLensCount(5);
```
```php
$response->assertLensesInclude(Lens::class);
```
```php
$response->assertLensesExclude(Lens::class);
```
```php
$response->assertLenses(function($lenses) {
return $lenses->count() > 0;
});
```
### Assert Fields
```php
$response->assertFieldCount(5);
```
Assert a specific field exists
```php
$response->assertFieldsInclude('id');
```
Assert a specific field contains a value
```php
$response->assertFieldsInclude('id', $user->id);
```
Assert multiple fields exist
```php
$response->assertFieldsInclude(['id', 'email']);
```
Assert multiple fields with specific values exist
```php
$response->assertFieldsInclude(['id' => 1, 'email' => 'example']);
```
Assert multiple values for one field exist
```php
$response->assertFieldsInclude('id', $users->pluck('id'));
```
Make assertions against a collection of fields
```php
$response->assertFields(function($fields) {
return $fields->count() > 0;
});
```
Also `exclude` works in all of these scenarios
```php
$response->assertFieldsExclude(['id' => 1, 'email' => 'example']);
```
### Assert Relations
```php
// App\Nova\Post
// BelongsTo::make('Category'),
```
```php
$response = $this->novaCreate('posts');
$response->assertRelation('categories', function($categories) {
//
});
```
```php
// App\Nova\Category
// HasMany::make('Posts'),
```
```php
$response = $this->novaDetail('categories');
$response->assertRelation('posts', function($posts) {
//
});
```
### Assert Policies
Assert **[Nova's use of policies](https://nova.laravel.com/docs/2.0/resources/authorization.html#authorization)** & the authed user:
```php
$response->assertCanView();
$response->assertCanCreate();
$response->assertCanUpdate();
$response->assertCanDelete();
$response->assertCanForceDelete();
$response->assertCanRestore();
```
Also can assert `cannot` for each:
```php
$response->assertCannotView();
```
---
# Author
Hi 👋, Im Brian Dillingham, creator of this Nova package [and others](https://novapackages.com/collaborators/dillingham)
Hope you find it useful. Feel free to reach out with feedback.
Follow me on twitter: [@im_brian_d](https://twitter.com/im_brian_d)