add configurable logging

Author: michael-rubel

config/model-mapper.php

@@ -0,0 +1,16 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Model Mapper Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Determine if you want to log failed assignments.
+    |
+    */
+
+    'log' => true,
+
+];

src/ModelMapperServiceProvider.php

@@ -18,6 +18,8 @@ class ModelMapperServiceProvider extends PackageServiceProvider
      */
     public function configurePackage(Package $package): void
     {
-        $package->name('laravel-model-mapper');
+        $package
+            ->name('laravel-model-mapper')
+            ->hasConfigFile();
     }
 }

src/Traits/WithModelMapping.php

@@ -20,7 +20,11 @@ public function mapModelAttributes(?Model $model = null): void
         if (! is_null($model)) {
             collect($model->getAttributes())->each(function ($value, $property) use ($model) {
                 if (property_exists($this, $property)) {
-                    rescue(fn () => $this->{$property} = $model->{$property});
+                    rescue(
+                        fn () => $this->{$property} = $model->{$property},
+                        fn () => null,
+                        config('model-mapper.log') ?? false
+                    );
                 }
             });
         }

tests/LoggingTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace MichaelRubel\ModelMapper\Tests;
+
+use Illuminate\Support\Facades\Log;
+use MichaelRubel\ModelMapper\Tests\Boilerplate\TestModel;
+use MichaelRubel\ModelMapper\Traits\WithModelMapping;
+
+class LoggingTest extends TestCase
+{
+    use WithModelMapping;
+
+    public int $number;
+
+    /** @test */
+    public function testMapperCanLog()
+    {
+        Log::shouldReceive('error')
+            ->once()
+            ->withArgs(function ($message) {
+                return str_contains($message, 'Cannot assign');
+            });
+
+        $model = new TestModel([
+            'number' => false,
+        ]);
+
+        $this->mapModelAttributes($model);
+    }
+
+    /** @test */
+    public function testMapperDoesntLogIfDisabled()
+    {
+        config(['model-mapper.log' => false]);
+
+        Log::shouldReceive('error')->never();
+
+        $model = new TestModel([
+            'number' => false,
+        ]);
+
+        $this->mapModelAttributes($model);
+    }
+}