add array to properties mapping

Author: michael-rubel

src/Traits/WithModelMapping.php

@@ -12,11 +12,11 @@ trait WithModelMapping
      * Maps your model attributes to local class properties.
      *
      * @param Model|null $model
-     * @param mixed      $failure
+     * @param mixed      $rescue
      *
      * @return void
      */
-    public function mapModelAttributes(?Model $model = null, mixed $failure = null): void
+    public function mapModelAttributes(?Model $model = null, mixed $rescue = null): void
     {
         if (! is_null($model)) {
             $toIgnore = config('model-mapper.ignore_attributes');
@@ -27,15 +27,36 @@ public function mapModelAttributes(?Model $model = null, mixed $failure = null):
 
             collect($model->getAttributes())
                 ->except($ignores)
-                ->each(function ($value, $property) use ($model, $failure) {
+                ->each(function ($value, $property) use ($model,  $rescue) {
                     if (property_exists($this, $property)) {
                         rescue(
                             fn () => $this->{$property} = $model->{$property},
-                            $failure,
+                            $rescue,
                             config('model-mapper.log') ?? false
                         );
                     }
                 });
         }
     }
+
+    /**
+     * Map array data to class properties.
+     *
+     * @param array      $data
+     * @param mixed|null $rescue
+     *
+     * @return void
+     */
+    public function arrayToProperties(array $data, mixed $rescue = null): void
+    {
+        collect($data)->each(function ($value, $key) use ($rescue) {
+            if (property_exists($this, $key)) {
+                rescue(
+                    fn () => $this->{$key} = $value,
+                    $rescue,
+                    config('model-mapper.log') ?? false
+                );
+            }
+        });
+    }
 }

tests/ArrayMappingTest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace MichaelRubel\ModelMapper\Tests;
+
+use MichaelRubel\ModelMapper\Traits\WithModelMapping;
+
+class ArrayMappingTest extends TestCase
+{
+    use WithModelMapping;
+
+    public bool $test;
+    public string $name;
+    public string $password;
+
+    /** @test */
+    public function testCanMapAnArrayToProperties()
+    {
+        $array = [
+            'test'     => true,
+            'name'     => 'Michael Rubel',
+            'password' => 'p@$$w0rd',
+        ];
+
+        $this->arrayToProperties($array);
+
+        $this->assertTrue($this->test);
+        $this->assertStringContainsString('Michael', $this->name);
+        $this->assertStringContainsString('$$', $this->password);
+    }
+}