Add: Anonymous array

Author: Яценко Андрей

.editorconfig

@@ -0,0 +1,17 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+trim_trailing_whitespace = false
+
+[*.{php, inc}]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2

.gitignore

@@ -5,3 +5,5 @@ vendor
 .phpunit.cache/code-coverage/
 
 .phpunit.cache/
+
+.DS_Store

README.md

@@ -1,4 +1,5 @@
 ## Class-transformer helper
+
 ![Packagist Version](https://img.shields.io/packagist/v/yzen.dev/plain-to-class?color=blue&label=version)
 ![GitHub Workflow Status](https://img.shields.io/github/workflow/status/yzen-dev/plain-to-class/Run%20tests?label=tests&logo=github)
 [![Coverage](https://codecov.io/gh/yzen-dev/plain-to-class/branch/master/graph/badge.svg?token=QAO8STLPMI)](https://codecov.io/gh/yzen-dev/plain-to-class)
@@ -9,23 +10,34 @@
 > Alas, I do not speak English, and the documentation was compiled through google translator :(
 > I will be glad if you can help me describe the documentation more correctly :)
 
-This package will help you transform any dataset into a structured object. This is very convenient when values obtained from a query, database, or any other place can be easily cast to the object you need. But what exactly is this convenient?
+This package will help you transform any dataset into a structured object. This is very convenient when values obtained
+from a query, database, or any other place can be easily cast to the object you need. But what exactly is this
+convenient?
 
-When writing code, it is very important to separate logic, adhere to the principle of single responsibility, reduce dependence on other services, and much more.
+When writing code, it is very important to separate logic, adhere to the principle of single responsibility, reduce
+dependence on other services, and much more.
 
-When creating a new service to create a user, you only need the necessary data set - name, email and phone. Why do you need to check around separately arrays, separately objects, check for the presence of keys through isset. It is much more convenient to make a DTO model with which the service will already work.
+When creating a new service to create a user, you only need the necessary data set - name, email and phone. Why do you
+need to check around separately arrays, separately objects, check for the presence of keys through isset. It is much
+more convenient to make a DTO model with which the service will already work.
 
-This approach guarantees that the service will work with the data it needs, full typing, there is no need to check for the presence of keys if it is an array.
+This approach guarantees that the service will work with the data it needs, full typing, there is no need to check for
+the presence of keys if it is an array.
 
 ## :scroll: **Installation**
+
 The package can be installed via composer:
+
 ```
 composer require yzen.dev/plain-to-class
 ```
 
 ## :scroll: **Usage**
+
 Common use case:
 
+### :scroll: **Base**
+
 ```php
 namespace DTO;
 
@@ -44,7 +56,9 @@ $data = [
 $dto = ClassTransformer::transform(CreateUserDTO::class,$data);
 var_dump($dto);
 ```
+
 Result:
+
 ```php
 object(\LoginDTO)
   'email' => string(13) "test@mail.com"
@@ -62,10 +76,16 @@ $dto = ClassTransformer::transform(CreateUserDTO::class,
 
 If the property is not of a scalar type, but a class of another DTO is allowed, it will also be automatically converted.
 
-If you have an array of objects of a certain class, then you must specify the ConvertArray attribute to it, passing it to which class you need to cast the elements.
+### :scroll: **Collection**
+
+If you have an array of objects of a certain class, then you must specify the ConvertArray attribute to it, passing it
+to which class you need to cast the elements.
+
+It is also possible to specify the class in PHP DOC, but then you need to write the full path to this
+class `array <\ DTO \ ProductDTO>`. This is done in order to know exactly which instance you need to create. Since
+Reflection does not provide out-of-the-box functions for getting the `use *` file. Besides `use *`, you can specify an
+alias, and it will be more difficult to trace it. Example:
 
-It is also possible to specify the class in PHP DOC, but then you need to write the full path to this class `array <\ DTO \ ProductDTO>`. This is done in order to know exactly which instance you need to create. Since Reflection does not provide out-of-the-box functions for getting the `use *` file. Besides `use *`, you can specify an alias, and it will be more difficult to trace it.
-Example:
 ```php
 
 class ProductDTO
@@ -122,9 +142,93 @@ object(PurchaseDTO)[345]
       public float 'balance' => float 10012.23
 ```
 
+### :scroll: **Anonymous array**
+
+In case you need to convert an array of data into an array of class objects, you can implement this through an anonymous
+array. To do this, you just need to wrap the class in **[]**
+
+```php
+$data = [
+        ['id' => 1, 'name' => 'phone'],
+        ['id' => 2, 'name' => 'bread'],
+    ];
+$products = ClassTransformer::transform([ProductDTO::class], $data);
+```
+
+The result of this execution you will get an array of objects ProductDTO
+
+```php
+array(2) {
+  [0]=>
+      object(ProductDTO) {
+        ["id"]=> int(1)
+        ["name"]=> string(5) "phone"
+      }
+  [1]=>
+      object(ProductDTO) {
+        ["id"]=> int(2)
+        ["name"]=> string(5) "bread"
+      }
+} 
+```
+
+You may also need an element-by-element array transformation. In such a case, you can pass an array of classes, which
+can then be easily unpacked
+
+```php
+    $userData = ['id' => 1, 'email' => 'test@test.com', 'balance' => 10012.23];
+    $purchaseData = [
+        'products' => [
+            ['id' => 1, 'name' => 'phone',],
+            ['id' => 2, 'name' => 'bread',],
+        ],
+        'user' => ['id' => 3, 'email' => 'fake@mail.com', 'balance' => 10012.23,],
+    ];
+
+    $result = ClassTransformer::transform([UserDTO::class, PurchaseDTO::class], [$userData, $purchaseData]);
+    
+    [$user, $purchase] = $result;
+    var_dump($user);
+    var_dump($purchase);
+```
+
+Result:
+
+```php
+object(UserDTO) (3) {
+  ["id"] => int(1)
+  ["email"]=> string(13) "test@test.com"
+  ["balance"]=> float(10012.23)
+}
+
+object(PurchaseDTO) (2) {
+  ["products"]=>
+  array(2) {
+    [0]=>
+    object(ProductDTO)#349 (3) {
+      ["id"]=> int(1)
+      ["name"]=> string(5) "phone"
+    }
+    [1]=>
+    object(ProductDTO)#348 (3) {
+      ["id"]=> int(2)
+      ["name"]=> string(5) "bread"
+    }
+  }
+  ["user"]=>
+  object(UserDTO)#332 (3) {
+    ["id"]=> int(3)
+    ["email"]=> string(13) "fake@mail.com"
+    ["balance"]=> float(10012.23)
+  }
+}
+```
+
 ### :scroll: **Writing style**
 
-A constant problem with the style of writing, for example, in the database it is snake_case, and in the camelCase code. And they constantly need to be transformed somehow. The package takes care of this, you just need to specify the WritingStyle attribute on the property:
+A constant problem with the style of writing, for example, in the database it is snake_case, and in the camelCase code.
+And they constantly need to be transformed somehow. The package takes care of this, you just need to specify the
+WritingStyle attribute on the property:
 
 ```php
 class WritingStyleSnakeCaseDTO
@@ -144,6 +248,7 @@ class WritingStyleSnakeCaseDTO
 $model = ClassTransformer::transform(WritingStyleSnakeCaseDTO::class, $data);
 var_dump($model);
 ```
+
 ```php
 RESULT:
 

composer.json

@@ -1,6 +1,6 @@
 {
   "name": "yzen.dev/plain-to-class",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Class-transformer to transform your dataset into a structured object",
   "minimum-stability": "dev",
   "prefer-stable": true,
@@ -12,6 +12,10 @@
       "email": "yzen.dev@gmail.com"
     }
   ],
+  "support": {
+    "issues": "https://github.com/yzen-dev/plain-to-class/issues",
+    "source": "https://github.com/yzen-dev/plain-to-class"
+  },
   "config": {
     "sort-packages": true
   },
@@ -28,6 +32,12 @@
   "require": {
     "php": "^8.0"
   },
+  "require-dev": {
+    "phpstan/phpstan": "^0.12.82",
+    "mockery/mockery": "^1.0",
+    "phpunit/phpunit": "^9.3",
+    "squizlabs/php_codesniffer": "*"
+  },
   "scripts": {
     "phpunit": [
       "./vendor/phpunit/phpunit/phpunit --configuration ./phpunit.xml"
@@ -45,14 +55,10 @@
       "./vendor/phpunit/phpunit/phpunit --configuration ./phpunit.xml --coverage-html public/coverage --coverage-text"
     ]
   },
-  "require-dev": {
-    "phpstan/phpstan": "^0.12.82",
-    "mockery/mockery": "^1.0",
-    "phpunit/phpunit": "^9.3",
-    "squizlabs/php_codesniffer": "*"
-  },
-  "support": {
-    "issues": "https://github.com/yzen-dev/plain-to-class/issues",
-    "source": "https://github.com/yzen-dev/plain-to-class"
+  "scripts-descriptions": {
+    "phpunit": "Run tests",
+    "coverage": "Checking code coverage",
+    "phpstan": "Run static analyze",
+    "phpcs": "Checking codestyle"
   }
 }