Add the ability to convert key names to different cases

See #3

Author: Andrey Helldar

README.md

@@ -17,6 +17,18 @@ Simple conversion of an array to a pretty view.
 </p>
 
 
+## Content
+
+* [Installation](#installation)
+* [Introduction](#introduction)
+* [Using](#using)
+    * [Saving numeric keys without alignment](#saving-numeric-keys-without-alignment)
+    * [Saving string keys without alignment](#saving-string-keys-without-alignment)
+    * [Saving numeric keys with alignment](#saving-numeric-keys-with-alignment)
+    * [Saving string keys with alignment](#saving-string-keys-with-alignment)
+* [Copyright and License](#copyright-and-license)
+
+
 ## Installation
 
 To get the latest version of `Pretty Array` package, simply require the project using [Composer](https://getcomposer.org):
@@ -247,6 +259,7 @@ Result:
 ]
 ```
 
+
 ### Saving string keys with alignment
 
 ```php
@@ -281,6 +294,50 @@ Result:
 ```
 
 
+### Change key case
+
+```php
+use Helldar\PrettyArray\Contracts\Caseable;
+use Helldar\PrettyArray\Services\Formatter;
+
+$service = Formatter::make();
+$service->setCase(Caseable::PASCAL_CASE);
+
+return $service->raw($array);
+```
+
+Result:
+```text
+[
+    'Foo' => 1,
+    'Bar' => 2,
+    'Baz' => 3,
+    'QweRty' => 'qaz',
+    'Baq' => [
+        0 => 'qwe',
+        1 => 'rty',
+        'Asd' => 'zxc',
+    ],
+    'AsdFgh' => [
+        'FooBarBaz' => 'qwe',
+        2 => 'rty',
+        'QawSed' => 'zxc',
+    ],
+    2 => 'iop',
+]
+```
+
+The following options are available:
+
+* camelCase (`Helldar\PrettyArray\Contracts\Caseable::CAMEL_CASE`);
+* kebab-case (`Helldar\PrettyArray\Contracts\Caseable::KEBAB_CASE`);
+* PascalCase (`Helldar\PrettyArray\Contracts\Caseable::PASCAL_CASE`);
+* snake_case (`Helldar\PrettyArray\Contracts\Caseable::SNAKE_CASE`);
+* no case (`Helldar\PrettyArray\Contracts\Caseable::NO_CASE`). By default;
+
+`NO_CASE` means that key register processing will not be performed.
+
+
 ### Storing file
 ```php
 use Helldar\PrettyArray\Services\File;

composer.json

@@ -18,7 +18,7 @@
         "php": "^7.1.3",
         "ext-dom": "*",
         "ext-mbstring": "*",
-        "andrey-helldar/support": "^1.15.2"
+        "andrey-helldar/support": "^1.16.0"
     },
     "require-dev": {
         "phpstan/phpstan": "^0.12.7",

composer.lock

@@ -0,0 +1,62 @@
+<?php
+
+namespace Helldar\PrettyArray\Concerns;
+
+use Helldar\PrettyArray\Exceptions\UnknownCaseTypeException;
+use Helldar\Support\Facades\Str;
+
+trait HasCases
+{
+    protected $case = self::NO_CASE;
+
+    /**
+     * @param int $type
+     *
+     * @throws \Helldar\PrettyArray\Exceptions\UnknownCaseTypeException
+     */
+    public function setCase(int $type = self::NO_CASE): void
+    {
+        if ($type < 0 || $type > 4) {
+            throw new UnknownCaseTypeException($type);
+        }
+
+        $this->case = $type;
+    }
+
+    protected function convertKeysCase(array &$array): void
+    {
+        if ($this->case === static::NO_CASE) {
+            return;
+        }
+
+        $result = [];
+
+        array_walk($array, function ($value, $key) use (&$result) {
+            $key = $this->convertKeyCase($key);
+
+            $result[$key] = $value;
+        });
+
+        $array = $result;
+    }
+
+    protected function convertKeyCase($key)
+    {
+        if (! is_string($key)) {
+            return $key;
+        }
+
+        switch ($this->case) {
+            case static::CAMEL_CASE:
+                return Str::camel($key);
+            case static::SNAKE_CASE:
+                return Str::snake($key);
+            case static::KEBAB_CASE:
+                return Str::snake($key, '-');
+            case static::PASCAL_CASE:
+                return Str::studly($key);
+            default:
+                return $key;
+        }
+    }
+}

src/Concerns/HasCases.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Helldar\PrettyArray\Contracts;
+
+interface Caseable
+{
+    const CAMEL_CASE = 1;
+
+    const KEBAB_CASE = 3;
+
+    const NO_CASE = 0;
+
+    const PASCAL_CASE = 4;
+
+    const SNAKE_CASE = 2;
+
+    public function setCase(int $type = self::NO_CASE): void;
+}

src/Contracts/Caseable.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Helldar\PrettyArray\Exceptions;
+
+class UnknownCaseTypeException extends \Exception
+{
+    public function __construct(string $type)
+    {
+        parent::__construct("Unknown conversion type: {$type}", 500);
+    }
+}

src/Exceptions/UnknownCaseTypeException.php

@@ -2,10 +2,14 @@
 
 namespace Helldar\PrettyArray\Services;
 
+use Helldar\PrettyArray\Concerns\HasCases;
+use Helldar\PrettyArray\Contracts\Caseable;
 use Helldar\Support\Facades\Arr;
 
-final class Formatter
+final class Formatter implements Caseable
 {
+    use HasCases;
+
     protected $key_as_string = false;
 
     protected $equals_align = false;
@@ -31,6 +35,8 @@ public function setEqualsAlign(): void
 
     public function raw(array $array, int $pad = 1): string
     {
+        $this->convertKeysCase($array);
+
         $keys_size  = $this->sizeKeys($array);
         $pad_length = $this->pad_length * $pad;
         $formatted  = '[' . $this->line_break;