fix(ci): drop php 8.4, deps don't support it

* Bump php to ^8.0, add tooling, linting, fixes
* chore: add pull_request to github workflow
* chore: tweak triggers in github workflow

.editorconfig

@@ -0,0 +1,18 @@
+# EditorConfig is awesome: https://editorconfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2

.github/workflows/phpunit.yml

@@ -1,20 +1,69 @@
+---
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
 name: PHPUnit
 
-on: [push]
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
 
 jobs:
   build-test:
     runs-on: ubuntu-latest
 
+    permissions:
+      contents: write
+      statuses: write
+
+    strategy:
+      fail-fast: true
+      matrix:
+        php: [ '8.0', '8.1', '8.2', '8.3' ]
+
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
-      - uses: php-actions/composer@v5
+      - name: Setup PHP
-
+        uses: shivammathur/setup-php@v2
-      - name: PHPUnit Tests
-        uses: php-actions/phpunit@v2
         with:
-          php_extensions: xdebug mbstring
+          php-version: ${{ matrix.php }}
-          bootstrap: vendor/autoload.php
+          tools: composer
-          configuration: phpunit.xml
+          extensions: json, dom, curl, libxml, mbstring
-          args: --coverage-text
+          coverage: xdebug
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get composer cache directory
+        id: composer-cache-dir
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Get composer.lock or composer.json hash for caching
+        id: hash
+        shell: bash
+        run: |
+          if [ -f composer.lock ]; then
+            echo "lock=${{ hashFiles('**/composer.lock') }}" >> $GITHUB_OUTPUT
+          else
+            echo "lock=${{ hashFiles('**/composer.json') }}" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Cache Composer packages
+        id: composer-cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.composer-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-php-${{ matrix.php }}-${{ steps.hash.outputs.lock }}
+          restore-keys: |
+            ${{ runner.os }}-php-${{ matrix.php }}-${{ steps.hash.outputs.lock }}
+            ${{ runner.os }}-php-${{ matrix.php }}-
+            ${{ runner.os }}-php-
+
+      - name: Install Dependencies (prefer-${{ matrix.stability }})
+        run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress
+
+      - name: Configure matchers
+        uses: mheap/phpunit-matcher-action@v1
+
+      - name: Execute composer test (Unit and Feature tests)
+        run: composer test:ci

.gitignore

@@ -12,4 +12,5 @@ Homestead.yaml
 npm-debug.log
 yarn-error.log
 .env
-.phpunit.result.cache
+*.cache
+composer.lock

.travis.yml

@@ -7,11 +7,14 @@ env:
 matrix:
   fast_finish: true
   include:
-    - php: 7.2
+    - php: 8.0
-    - php: 7.2
+    - php: 8.0
       env: setup=lowest
-    - php: 7.3
+    - php: 8.1
-    - php: 7.3
+    - php: 8.1
+      env: setup=lowest
+    - php: 8.2
+    - php: 8.2
       env: setup=lowest
 
 sudo: false

composer.json

@@ -8,21 +8,35 @@
             "email": "jani@nullincorporated.com"
         }
     ],
+    "scripts": {
+        "lint": "pint --test",
+        "lint:fix": "pint --repair",
+        "psalm": "psalm",
+        "psalm:fix": "psalm --alter --issues=MissingReturnType,MissingParamType",
+        "test": "phpunit --coverage-text",
+        "test:ci": "phpunit --teamcity"
+    },
     "require": {
         "ext-json": "*",
         "php": "^8.0"
     },
     "require-dev": {
-        "orchestra/testbench": "^7.0"
+        "orchestra/testbench": "^7|^8",
+        "rector/rector": "^1",
+        "ergebnis/composer-normalize": "^2",
+        "vimeo/psalm": "^5",
+        "psalm/plugin-laravel": "^2",
+        "laravel/pint": "^1"
     },
     "autoload": {
-        "psr-4" : {
+        "psr-4": {
             "nullthoughts\\LaravelDataSync\\": "src/"
         }
     },
     "autoload-dev": {
-        "psr-4" : {
+        "psr-4": {
-            "nullthoughts\\LaravelDataSync\\Tests\\": "tests/"
+            "nullthoughts\\LaravelDataSync\\Tests\\": "tests/",
+            "nullthoughts\\LaravelDataSync\\Tests\\Fakes\\": "tests/fakes/"
         }
     },
     "extra": {
@@ -31,5 +45,10 @@
                 "nullthoughts\\LaravelDataSync\\DataSyncBaseServiceProvider"
             ]
         }
+    },
+    "config": {
+        "allow-plugins": {
+            "ergebnis/composer-normalize": true
+        }
     }
 }

config/data-sync.php

@@ -1,7 +1,7 @@
 <?php
 
 return [
-    'path'  => base_path('sync'),
+    'path' => base_path('sync'),
     'order' => [
         //
     ],

pint.json

@@ -0,0 +1,3 @@
+{
+    "preset": "laravel"
+}

psalm.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<psalm
+    errorLevel="7"
+    resolveFromConfigFile="true"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="https://getpsalm.org/schema/config"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+    findUnusedBaselineEntry="true"
+    findUnusedCode="true"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+</psalm>

readme.md

@@ -8,6 +8,34 @@
 
 Laravel utility to keep records synchronized between environments through source control
 
+## [V3.1 branch](https://github.com/nullthoughts/laravel-data-sync/tree/v3.1) Notes (Work in progress)
+- Adds support for Laravel 8+ models directory in `config/data-sync.php`:
+```
+'namespace' => '\\App\\Models\\',
+```
+
+- Adds ability to export existing Models to data sync files:
+```
+php artisan data:export User --criteria=name --criteria=email --except=id
+```
+
+which generates
+
+```json
+[
+    {
+        "_name": "Cameron Frye",
+        "properties->title": "Best Friend",
+        "phone_numbers->mobile": "555-555-5556",
+        "_email": "noreply@buellerandco.com",
+    }
+]
+```
+
+- Further work is required to support remote disks. For testing & development of new V3.1 features, use `composer require nullthoughts/laravel-data-sync:v3.1.x-dev`
+
+---
+
 ## Installation 
 You can install this package via composer:
 ```bash

rector.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+
+return RectorConfig::configure()
+    ->withPaths([
+        __DIR__.'/config',
+        __DIR__.'/src',
+        __DIR__.'/tests',
+    ])
+    ->withPhpSets()
+    ->withPreparedSets(deadCode: true, codeQuality: true)
+    ->withImportNames(removeUnusedImports: true)
+    ->withTypeCoverageLevel(0);

scratch.md

@@ -1,12 +1,14 @@
 # Dev
-- Check if null return from json decode (invalid JSON)
+
-- Check if updateOrCreate returns anything
+-   Check if null return from json decode (invalid JSON)
+-   Check if updateOrCreate returns anything
 
 # Usage
-- Must have the columsn you are updating as fillable
-- In config, specify disk to use (string)
-- Document Forge example
 
+-   Must have the columsn you are updating as fillable
+-   In config, specify disk to use (string)
+-   Document Forge example
 
 # Troubleshooting
-- Make sure columns are fillable in model
+
+-   Make sure columns are fillable in model

src/Console/Commands/Sync.php

@@ -2,8 +2,8 @@
 
 namespace nullthoughts\LaravelDataSync\Console\Commands;
 
-use nullthoughts\LaravelDataSync\Updater;
 use Illuminate\Console\Command;
+use nullthoughts\LaravelDataSync\Updater;
 
 class Sync extends Command
 {
@@ -11,7 +11,8 @@ class Sync extends Command
 
     protected $description = 'Update Models with respective sync data files';
 
-    public function handle()
+    /** @psalm-api */
+    public function handle(): void
     {
         $path = $this->option('path');
         $model = $this->option('model');

src/DataSyncBaseServiceProvider.php

@@ -3,10 +3,12 @@
 namespace nullthoughts\LaravelDataSync;
 
 use Illuminate\Support\ServiceProvider;
+use nullthoughts\LaravelDataSync\Console\Commands\Sync;
 
+/** @psalm-api */
 class DataSyncBaseServiceProvider extends ServiceProvider
 {
-    public function boot()
+    public function boot(): void
     {
         if ($this->app->runningInConsole()) {
             $this->registerPublishing();
@@ -16,11 +18,11 @@ class DataSyncBaseServiceProvider extends ServiceProvider
     public function register()
     {
         $this->commands([
-            Console\Commands\Sync::class,
+            Sync::class,
         ]);
     }
 
-    protected function registerPublishing()
+    protected function registerPublishing(): void
     {
         $this->publishes([
             __DIR__.'/../config/data-sync.php' => config_path('data-sync.php'),

src/Exceptions/ErrorUpdatingModelException.php

@@ -7,7 +7,7 @@ use Throwable;
 
 class ErrorUpdatingModelException extends Exception
 {
-    public function __construct(string $message = '', int $code = 0, Throwable $previous = null)
+    public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
     {
         parent::__construct($message, $code, $previous);
 

src/Exceptions/NoRecordsInvalidJSONException.php

@@ -7,7 +7,7 @@ use Throwable;
 
 class NoRecordsInvalidJSONException extends Exception
 {
-    public function __construct(string $message = '', int $code = 0, Throwable $previous = null)
+    public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
     {
         parent::__construct($message, $code, $previous);
 

src/Updater.php

@@ -14,37 +14,21 @@ use stdClass;
 
 class Updater
 {
-    /**
+    private string $directory;
-     * @var string
-     */
-    private $directory;
 
-    /**
+    private Collection $files;
-     * @var \Illuminate\Support\Collection
-     */
-    private $files;
 
-    /**
+    private bool $remote;
-     * @var bool
-     */
-    private $remote;
 
-    /**
+    private string $disk;
-     * @var string
-     */
-    private $disk;
 
-    /**
+    private string $baseNamespace = '\\App\\';
-     * @var string
-     */
-    private $baseNamespace = '\\App\\';
 
     /**
      * Get files in sync directory.
      *
      * @param  string|null  $path
      * @param  string|null  $model
-     *
      * @param  bool  $remote
      * @param  string  $disk
      *
@@ -62,17 +46,25 @@ class Updater
     /**
      * Override the default namespace for the class.
      *
-     * @param $namespace
+     * @psalm-api
      */
-    public function setNamespace($namespace)
+    public function setNamespace(string $namespace): void
     {
         $this->baseNamespace = $namespace;
     }
 
     /**
-     * Execute syncModel for each file.
+     * Override the default directory for the class.
      *
-     * @return mixed
+     * @psalm-api
+     */
+    public function setDirectory(string $directory): void
+    {
+        $this->directory = $directory;
+    }
+
+    /**
+     * Execute syncModel for each file.
      */
     public function run()
     {
@@ -81,7 +73,7 @@ class Updater
         return $files->map(function ($file) {
             try {
                 return $this->syncModel($file);
-            } catch (\ErrorException $e) {
+            } catch (\ErrorException) {
                 $model = pathinfo($file, PATHINFO_FILENAME);
 
                 throw new ErrorUpdatingModelException(ucwords($model));
@@ -92,9 +84,9 @@ class Updater
     /**
      * Parse each record for criteria/values and update/create model.
      *
-     * @param  string  $file
      *
      * @return \Illuminate\Support\Collection
+     *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      * @throws \nullthoughts\LaravelDataSync\Exceptions\NoRecordsInvalidJSONException
      */
@@ -121,29 +113,28 @@ class Updater
     /**
      * Get directory path for sync files.
      *
-     * @param $path
-     *
-     * @throws \nullthoughts\LaravelDataSync\Exceptions\FileDirectoryNotFoundException
      *
      * @return string
+     *
+     * @throws \nullthoughts\LaravelDataSync\Exceptions\FileDirectoryNotFoundException
      */
-    protected function getDirectory($path)
+    protected function getDirectory(?string $path)
     {
         $directory = $path ?? config('data-sync.path', base_path('sync'));
 
         if ($this->directoryMissingLocally($directory) || $this->directoryMissingRemotely($directory)) {
-            throw new FileDirectoryNotFoundException();
+            throw new FileDirectoryNotFoundException;
         }
 
-        return $directory;
+        $this->directory = $directory;
+
+        return $this->directory;
     }
 
     /**
      * Get list of files in directory.
      *
-     * @param string      $directory
+     * @param  string|null  $model
-     * @param string|null $model
-     *
      * @return \Illuminate\Support\Collection
      */
     protected function getFiles(string $directory, $model = null)
@@ -170,7 +161,6 @@ class Updater
     /**
      * Sort Models by pre-configured order.
      *
-     * @param \Illuminate\Support\Collection $files
      *
      * @return \Illuminate\Support\Collection
      */
@@ -195,11 +185,10 @@ class Updater
     /**
      * Filter record criteria.
      *
-     * @param stdClass $record
-     *
-     * @throws \nullthoughts\LaravelDataSync\Exceptions\NoCriteriaException
      *
      * @return \Illuminate\Support\Collection
+     *
+     * @throws \nullthoughts\LaravelDataSync\Exceptions\NoCriteriaException
      */
     protected function getCriteria(stdClass $record)
     {
@@ -208,7 +197,7 @@ class Updater
         });
 
         if ($criteria->count() == 0) {
-            throw new NoCriteriaException();
+            throw new NoCriteriaException;
         }
 
         return $criteria->mapWithKeys(function ($value, $key) {
@@ -219,7 +208,6 @@ class Updater
     /**
      * Filter record values.
      *
-     * @param stdClass $record
      *
      * @return \Illuminate\Support\Collection
      */
@@ -241,7 +229,6 @@ class Updater
     /**
      * Returns model name for file.
      *
-     * @param string $name
      *
      * @return string
      */
@@ -253,9 +240,9 @@ class Updater
     /**
      * Parses JSON from file and returns collection.
      *
-     * @param  string  $file
      *
      * @return \Illuminate\Support\Collection
+     *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      * @throws \nullthoughts\LaravelDataSync\Exceptions\NoRecordsInvalidJSONException
      */
@@ -275,8 +262,7 @@ class Updater
     /**
      * Check if column is criteria for a condition match.
      *
-     * @param string $key
+     * @param  string  $key
-     *
      * @return bool
      */
     protected function isCriteria($key)
@@ -287,8 +273,6 @@ class Updater
     /**
      * Return ID for nested key-value pairs.
      *
-     * @param string $key
-     * @param stdClass $values
      *
      * @return array
      */
@@ -310,7 +294,6 @@ class Updater
     /**
      * Detect nested objects and resolve them.
      *
-     * @param \Illuminate\Support\Collection $record
      *
      * @return array
      */
@@ -327,21 +310,19 @@ class Updater
 
     /**
      * @param  \Illuminate\Config\Repository  $directory
-     *
      * @return bool
      */
     protected function directoryMissingLocally($directory)
     {
-        return !$this->remote && !file_exists($directory);
+        return ! $this->remote && ! file_exists($directory);
     }
 
     /**
      * @param  \Illuminate\Config\Repository  $directory
-     *
      * @return bool
      */
     protected function directoryMissingRemotely($directory)
     {
-        return $this->remote && !Storage::disk($this->disk)->exists($directory);
+        return $this->remote && ! Storage::disk($this->disk)->exists($directory);
     }
 }

tests/Roles.php

@@ -3,6 +3,7 @@
 namespace nullthoughts\LaravelDataSync\Tests;
 
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Roles extends Model
 {
@@ -10,7 +11,7 @@ class Roles extends Model
 
     protected $guarded = [];
 
-    public function supervisor()
+    public function supervisor(): BelongsTo
     {
         return $this->belongsTo(Supervisor::class);
     }

tests/Supervisor.php

@@ -3,6 +3,7 @@
 namespace nullthoughts\LaravelDataSync\Tests;
 
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Supervisor extends Model
 {
@@ -10,7 +11,7 @@ class Supervisor extends Model
 
     protected $guarded = [];
 
-    public function roles()
+    public function roles(): HasMany
     {
         return $this->hasMany(Roles::class);
     }

tests/TestCase.php

@@ -7,25 +7,30 @@ use Illuminate\Support\Facades\Schema;
 
 class TestCase extends \Orchestra\Testbench\TestCase
 {
-    protected function getEnvironmentSetUp($app)
+    /** @psalm-suppress PropertyNotSetInConstructor */
+    public string $testDataPath;
+
+    protected function getEnvironmentSetUp($app): void
     {
         $app['config']->set('database.default', 'testdb');
         $app['config']->set('database.connections.testdb', [
-            'driver'   => 'sqlite',
+            'driver' => 'sqlite',
             'database' => ':memory:',
         ]);
+
+        $this->testDataPath = __DIR__.'/test-data';
     }
 
     protected function setUp(): void
     {
         parent::setUp();
 
-        Schema::create('supervisors', function (Blueprint $table) {
+        Schema::create('supervisors', static function (Blueprint $table): void {
             $table->increments('id');
             $table->string('name');
         });
 
-        Schema::create('roles', function (Blueprint $table) {
+        Schema::create('roles', static function (Blueprint $table): void {
             $table->increments('id');
             $table->string('slug');
             $table->unsignedInteger('supervisor_id')->nullable();

tests/Unit/UpdaterRemoteTest.php

@@ -1,12 +1,15 @@
 <?php
 
-namespace nullthoughts\LaravelDataSync\Tests;
+namespace nullthoughts\LaravelDataSync\Tests\Unit;
 
+use Exception;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Storage;
 use nullthoughts\LaravelDataSync\Exceptions\ErrorUpdatingModelException;
-use nullthoughts\LaravelDataSync\Tests\fakes\UpdaterFake;
+use nullthoughts\LaravelDataSync\Tests\Fakes\UpdaterFake;
-use Exception;
+use nullthoughts\LaravelDataSync\Tests\Roles;
+use nullthoughts\LaravelDataSync\Tests\Supervisor;
+use nullthoughts\LaravelDataSync\Tests\TestCase;
 
 class UpdaterRemoteTest extends TestCase
 {
@@ -81,9 +84,10 @@ class UpdaterRemoteTest extends TestCase
 
     /**
      * @test
+     *
      * @group current
      */
-    public function exception_is_thrown_if_the_directory_does_not_exists()
+    public function exception_is_thrown_if_the_directory_does_not_exists(): void
     {
         try {
             new UpdaterFake(null, null, true, 's3');
@@ -95,7 +99,7 @@ class UpdaterRemoteTest extends TestCase
     }
 
     /** @test */
-    public function invalid_json_throws_an_exception_in_remote()
+    public function invalid_json_throws_an_exception_in_remote(): void
     {
         try {
             $updater = new UpdaterFake('test-data/invalid-json', null, true, 's3');
@@ -108,7 +112,7 @@ class UpdaterRemoteTest extends TestCase
     }
 
     /** @test */
-    public function the_json_must_contain_a_key_with_an_underscore_in_remote()
+    public function the_json_must_contain_a_key_with_an_underscore_in_remote(): void
     {
         try {
             $updater = new UpdaterFake('test-data/no-criteria', null, true, 's3');
@@ -121,7 +125,7 @@ class UpdaterRemoteTest extends TestCase
     }
 
     /** @test */
-    public function order_of_imports_can_be_defined_in_config_in_remote()
+    public function order_of_imports_can_be_defined_in_config_in_remote(): void
     {
         config()->set('data-sync.order', [
             'Supervisor',
@@ -136,7 +140,7 @@ class UpdaterRemoteTest extends TestCase
     }
 
     /** @test */
-    public function exception_is_thrown_if_imports_are_in_incorrect_order_in_remote()
+    public function exception_is_thrown_if_imports_are_in_incorrect_order_in_remote(): void
     {
         config()->set('data-sync.order', [
             'Roles',
@@ -150,7 +154,7 @@ class UpdaterRemoteTest extends TestCase
     }
 
     /** @test */
-    public function it_ignores_non_json_files_in_remote()
+    public function it_ignores_non_json_files_in_remote(): void
     {
         $updater = new UpdaterFake('test-data/not-json', null, true, 's3');
         $updater->run();

tests/Unit/UpdaterTest.php

@@ -1,17 +1,20 @@
 <?php
 
-namespace nullthoughts\LaravelDataSync\Tests;
+namespace nullthoughts\LaravelDataSync\Tests\Unit;
 
+use Exception;
 use nullthoughts\LaravelDataSync\Exceptions\ErrorUpdatingModelException;
 use nullthoughts\LaravelDataSync\Tests\fakes\UpdaterFake;
-use Exception;
+use nullthoughts\LaravelDataSync\Tests\Roles;
+use nullthoughts\LaravelDataSync\Tests\Supervisor;
+use nullthoughts\LaravelDataSync\Tests\TestCase;
 
 class UpdaterTest extends TestCase
 {
     /** @test */
-    public function it_adds_roles_to_the_database()
+    public function it_adds_roles_to_the_database(): void
     {
-        $updater = new UpdaterFake(__DIR__.'/../test-data', 'roles');
+        $updater = new UpdaterFake($this->testDataPath, 'roles');
 
         $updater->run();
 
@@ -23,9 +26,9 @@ class UpdaterTest extends TestCase
     /** @test */
     public function it_can_default_to_configuration()
     {
-        config()->set('data-sync.path', __DIR__.'/../test-data');
+        config()->set('data-sync.path', $this->testDataPath);
 
-        $updater = new UpdaterFake();
+        $updater = new UpdaterFake;
 
         $updater->run();
 
@@ -37,11 +40,11 @@ class UpdaterTest extends TestCase
     /** @test */
     public function it_can_update_an_existing_record()
     {
-        config()->set('data-sync.path', __DIR__.'/../test-data');
+        config()->set('data-sync.path', $this->testDataPath);
-        (new UpdaterFake())->run();
+        (new UpdaterFake)->run();
 
-        config()->set('data-sync.path', __DIR__.'/../test-data/valid');
+        config()->set('data-sync.path', $this->testDataPath.'/valid');
-        (new UpdaterFake())->run();
+        (new UpdaterFake)->run();
 
         $this->assertDatabaseHas('roles', ['category' => 'changed']);
         $this->assertDatabaseHas('roles', ['category' => 'changed']);
@@ -49,24 +52,24 @@ class UpdaterTest extends TestCase
     }
 
     /** @test */
-    public function it_can_update_the_relationship()
+    public function it_can_update_the_relationship(): void
     {
         $supervisor = Supervisor::create([
             'name' => 'CEO',
         ]);
 
-        config()->set('data-sync.path', __DIR__.'/../test-data/relationship', 'roles');
+        config()->set('data-sync.path', $this->testDataPath.'/relationship', 'roles');
-        (new UpdaterFake())->run();
+        (new UpdaterFake)->run();
 
         $this->assertEquals($supervisor->id, Roles::first()->supervisor_id);
         $this->assertTrue($supervisor->is(Roles::first()->supervisor));
     }
 
     /** @test */
-    public function exception_is_thrown_if_the_directory_does_not_exists()
+    public function exception_is_thrown_if_the_directory_does_not_exists(): void
     {
         try {
-            new UpdaterFake();
+            new UpdaterFake;
 
             $this->fail('exception was thrown');
         } catch (Exception $e) {
@@ -75,10 +78,10 @@ class UpdaterTest extends TestCase
     }
 
     /** @test */
-    public function invalid_json_throws_an_exception()
+    public function invalid_json_throws_an_exception(): void
     {
         try {
-            $updater = new UpdaterFake(__DIR__.'/../test-data/invalid-json');
+            $updater = new UpdaterFake($this->testDataPath.'/invalid-json');
             $updater->run();
 
             $this->fail('exception was thrown');
@@ -88,10 +91,10 @@ class UpdaterTest extends TestCase
     }
 
     /** @test */
-    public function the_json_must_contain_a_key_with_an_underscore()
+    public function the_json_must_contain_a_key_with_an_underscore(): void
     {
         try {
-            $updater = new UpdaterFake(__DIR__.'/../test-data/no-criteria');
+            $updater = new UpdaterFake($this->testDataPath.'/no-criteria');
             $updater->run();
 
             $this->fail('exception was thrown');
@@ -101,22 +104,21 @@ class UpdaterTest extends TestCase
     }
 
     /** @test */
-    public function order_of_imports_can_be_defined_in_config()
+    public function order_of_imports_can_be_defined_in_config(): void
     {
         config()->set('data-sync.order', [
             'Supervisor',
             'Roles',
         ]);
 
-        $updater = new UpdaterFake(__DIR__.'/../test-data/ordered');
+        $updater = new UpdaterFake($this->testDataPath.'/ordered');
         $updater->run();
 
         $this->assertDatabaseHas('roles', ['slug' => 'update-student-records']);
         $this->assertDatabaseHas('supervisors', ['name' => 'CEO']);
     }
 
-    /** @test */
+    public function exception_is_thrown_if_imports_are_in_incorrect_order(): void
-    public function exception_is_thrown_if_imports_are_in_incorrect_order()
     {
         config()->set('data-sync.order', [
             'Roles',
@@ -125,14 +127,14 @@ class UpdaterTest extends TestCase
 
         $this->expectException(ErrorUpdatingModelException::class);
 
-        $updater = new UpdaterFake(__DIR__.'/../test-data/ordered');
+        $updater = new UpdaterFake($this->testDataPath.'/ordered');
         $updater->run();
     }
 
     /** @test */
-    public function it_ignores_non_json_files()
+    public function it_ignores_non_json_files(): void
     {
-        $updater = new UpdaterFake(__DIR__.'/../test-data/not-json');
+        $updater = new UpdaterFake($this->testDataPath.'/not-json');
         $updater->run();
 
         $this->assertDatabaseMissing('roles', ['slug' => 'update-student-records']);

tests/fakes/UpdaterFake.php

@@ -2,15 +2,15 @@
 
 namespace nullthoughts\LaravelDataSync\Tests\Fakes;
 
-use nullthoughts\LaravelDataSync\Updater;
 use Illuminate\Support\Str;
+use nullthoughts\LaravelDataSync\Updater;
 
 class UpdaterFake extends Updater
 {
     protected function getModel(string $name)
     {
         return '\\nullthoughts\\LaravelDataSync\\Tests\\'.Str::studly(
-                pathinfo($name, PATHINFO_FILENAME)
+            pathinfo($name, PATHINFO_FILENAME)
-            );
+        );
     }
-}
+}

tests/test-data/invalid-json/invalid.json

@@ -1,3 +1 @@
-[
+[]
-
-]

tests/test-data/no-criteria/no-criteria.json

@@ -2,4 +2,4 @@
     {
         "string": "update-student-records"
     }
-]
+]

tests/test-data/not-json/roles.txt

@@ -6,4 +6,4 @@
             "name": "CEO"
         }
     }
-]
+]

tests/test-data/ordered/roles.json

@@ -6,4 +6,4 @@
             "name": "CEO"
         }
     }
-]
+]

tests/test-data/ordered/supervisor.json

@@ -2,4 +2,4 @@
     {
         "_name": "CEO"
     }
-]
+]

tests/test-data/relationship/roles.json

@@ -6,4 +6,4 @@
             "name": "CEO"
         }
     }
-]
+]

tests/test-data/roles.json

@@ -11,4 +11,4 @@
         "_slug": "destroy-ferrari",
         "category": "cars"
     }
-]
+]

tests/test-data/valid/roles.json

@@ -11,4 +11,4 @@
         "_slug": "destroy-ferrari",
         "category": "changed"
     }
-]
+]