add propertiesFrom method

Author: michael-rubel

src/Traits/LoopFunctions.php

@@ -10,6 +10,22 @@ trait LoopFunctions
 {
     use HelpsLoopFunctions;
 
+    /**
+     * Choose proper strategy to loop over the data.
+     *
+     * @param Model|array|null $data
+     * @param mixed|null       $rescue
+     *
+     * @return void
+     */
+    public function propertiesFrom(Model|array|null $data = null, mixed $rescue = null): void
+    {
+        match (true) {
+            is_array($data)        => $this->arrayToProperties($data, $rescue),
+            $data instanceof Model => $this->attributesToProperties($data, $rescue),
+        };
+    }
+
     /**
      * Maps your model attributes to local class properties.
      *

tests/ArrayMappingTest.php

@@ -101,4 +101,19 @@ public function testCollectionAssignmentIsOk()
         $this->assertArrayHasKey('test', $this->supportCollection->toArray());
         $this->assertTrue($this->supportCollection->toArray()['test']);
     }
+
+    /** @test */
+    public function testCanMapUsingPropertiesFrom()
+    {
+        $array = [
+            'test'            => true,
+            'additional_data' => [
+                'next' => 'test',
+            ],
+        ];
+
+        $this->propertiesFrom($array);
+
+        $this->assertArrayHasKey('next', $this->additional_data);
+    }
 }

tests/AttributeMappingTest.php

@@ -121,4 +121,21 @@ public function testSetsDefaultValueWithWrongConfig()
         $this->assertFalse((new \ReflectionProperty($this, 'id'))->isInitialized($this));
         $this->assertFalse((new \ReflectionProperty($this, 'password'))->isInitialized($this));
     }
+
+    /** @test */
+    public function testCanMapUsingPropertiesFrom()
+    {
+        $model = new TestModel([
+            'collection' => [
+                0 => true,
+                1 => false,
+            ],
+            'intAsString' => 100,
+        ]);
+
+        $this->propertiesFrom($model);
+
+        $this->assertInstanceOf(Collection::class, $this->collection);
+        $this->assertIsString($this->intAsString);
+    }
 }