Initial commit

Author: nabeghe

.gitignore

@@ -0,0 +1,3 @@
+.idea
+.phpunit.result.cache
+/vendor/

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Hadi Akbarzadeh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,104 @@
+# Stringer (String Helper for PHP)
+
+> An array helper for PHP. It includes some useful methods and possibly other features.
+
+Some of the methods from the Arr class of the Laravel framework are also included in this library;
+however, some of them have been modified.
+
+<hr>
+
+## 🫡 Usage
+
+### 🚀 Installation
+
+You can install the package via composer:
+
+```bash
+composer require nabeghe/arrayer
+```
+
+<hr>
+
+### Str Class
+
+The main class that includes the useful methods is `Nabegh\String\Arr`.
+
+#### Example:
+
+```php
+use Nabeghe\Stringer\Arr;
+
+use Nabeghe\Arrayer\Arr;
+
+$data1 = ['key_1' => 'value_1', 'key_3' => ['key_3_1' => 'value_3_1']];
+
+$data2 = ['key_2' => 'value_2'];
+
+$data3 = ['key_3' => ['key_3_2' => 'value_3_2']];
+
+$merged = Arr::merge($data1, $data2, $data3);
+
+print_r($merged);
+
+/*
+    Array
+    (
+        [key_1] => value_1
+        [key_3] => Array
+            (
+                [key_3_1] => value_3_1
+                [key_3_2] => value_3_2
+            )
+    
+        [key_2] => value_2
+    )
+ */
+```
+
+<hr>
+
+### Arrayer Class
+
+An array class.
+
+Accepts any value, converts it to an array via `Arr::cast`, stores it, and returns it via `data` property.
+
+It is possible to access the methods of the `Arr` class through the `Arrayer` object as well, with the difference that the main array parameter is no longer present.
+
+Additionally, the `ArrayAccess` and `JsonSerializable` interfaces have also been implemented on `Arrayer` class.
+
+```php
+use Nabeghe\Arrayer\Arrayer;
+
+$data1 = ['key_1' => 'value_1', 'key_3' => ['key_3_1' => 'value_3_1']];
+
+$data2 = ['key_2' => 'value_2'];
+
+$data3 = ['key_3' => ['key_3_2' => 'value_3_2']];
+
+$arrayer = new Arrayer();
+
+print_r($arrayer->merge($data1, $data2, $data3)->data);
+
+/*
+    Array
+    (
+        [key_1] => value_1
+        [key_3] => Array
+            (
+                [key_3_1] => value_3_1
+                [key_3_2] => value_3_2
+            )
+    
+        [key_2] => value_2
+    )
+ */
+```
+
+<hr>
+
+## 📖 License
+
+Copyright (c) 2024 Hadi Akbarzadeh
+
+Licensed under the MIT license, see [LICENSE.md](LICENSE.md) for details.

composer.json

@@ -0,0 +1,31 @@
+{
+  "name": "nabeghe/arrayer",
+  "description": "An array helper for PHP. It includes some useful methods and possibly other features.",
+  "keywords": [
+    "array", "array helper", "array utils", "array merge", "library", "helper", "support"
+  ],
+  "type": "library",
+  "version": "1.0.0",
+  "homepage": "https://github.com/nabeghe/arrayer-php",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Nabeghe\\Arrayer\\": "src/"
+    }
+  },
+  "authors": [
+    {
+      "name": "Hadi Akbarzadeh",
+      "email": "hadicoder@gmail.com"
+    }
+  ],
+  "require": {
+    "php": ">=7.4",
+    "ext-json": "*",
+    "nabeghe/cally": "*",
+    "nabeghe/stringer": "*"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "9.6"
+  }
+}