v2.0.1: add new String and Array Helpers

Author: efureev

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog][keepachangelog] and this project adheres to [Semantic Versioning][semver].
+
+## v2.0.1
+
+### Added
+
+- Add `CHANGELOG.md`
+- Add new Array helpers:
+    + `get` Get an item from an array using "dot" notation.
+- Add new String helpers:
+    + `toSnake` Converts a string to `snake_case`
+    + `toScreamingSnake` Converts a string to `SCREAMING_SNAKE_CASE`
+    + `toKebab` Converts a string to `kebab-case`
+    + `toCamel` Converts a string to `CamelCase`
+    + `toLowerCamel` Converts a string to `lowerCamelCase`
+    + `removeMultiSpace` Converts all multi-spaced characters to once
+    
+## v2.0.0
+
+### Reformat
+
+[keepachangelog]:https://keepachangelog.com/en/1.0.0/
+[semver]:https://semver.org/spec/v2.0.0.html

candidates/Helpers/Arr.php

@@ -4,8 +4,6 @@
 
 namespace Php\Support\Candidates\Helpers;
 
-use ArrayAccess;
-
 /**
  * Class Arr
  *
@@ -43,59 +41,6 @@ private static function itemReplaceByTemplate(&$item, array $replace): void
         }
     }
 
-    /**
-     * Remove elements from array by value
-     *
-     * @param array $array
-     * @param mixed $val
-     */
-    public static function removeByValue(array &$array, $val): void
-    {
-        if (($key = array_search($val, $array, false)) !== false) {
-            unset($array[$key]);
-        }
-    }
-
-
-    /**
-     * Get an item from an array using "dot" notation.
-     *
-     * @param ArrayAccess|array $array
-     * @param null|string $key
-     * @param mixed $default
-     *
-     * @return mixed
-     */
-    public static function get($array, ?string $key, $default = null)
-    {
-        if (!static::accessible($array)) {
-            return value($default);
-        }
-
-        if ($key === null) {
-            return $array;
-        }
-
-        if (static::exists($array, $key)) {
-            return $array[$key];
-        }
-
-        if (strpos($key, '.') === false) {
-            return $array[$key] ?? value($default);
-        }
-
-        foreach (explode('.', $key) as $segment) {
-            if (static::accessible($array) && static::exists($array, $segment)) {
-                $array = $array[$segment];
-            } else {
-                return value($default);
-            }
-        }
-
-        return $array;
-    }
-
-
     /**
      * @param string|null $s
      * @param int $start

candidates/Helpers/Str.php

@@ -4,28 +4,13 @@
 
 namespace Php\Support\Candidates\Helpers;
 
-use function mb_strtolower;
-use function preg_replace;
-
 /**
  * Class Str
  *
  * @package Php\Support\Helpers
  */
 class Str
 {
-    /**
-     * The cache of studly-cased words.
-     *
-     * @var array
-     */
-    protected static $studlyCache = [];
-    /**
-     * The cache of snake-cased words.
-     *
-     * @var array
-     */
-    protected static $snakeCache = [];
 
     /**
      * Replace templates into string
@@ -41,50 +26,4 @@ public static function stringReplaceByTemplate(string $str, array $replace)
     {
         return str_replace(array_keys($replace), array_values($replace), $str);
     }
-
-    /**
-     * Convert a value to studly caps case.
-     *
-     * @param string $value
-     *
-     * @return string
-     */
-    public static function studly($value): string
-    {
-        $key = $value;
-
-        if (isset(static::$studlyCache[$key])) {
-            return static::$studlyCache[$key];
-        }
-
-        $value = ucwords(str_replace(['-', '_'], ' ', $value));
-
-        return static::$studlyCache[$key] = str_replace(' ', '', $value);
-    }
-
-    /**
-     * Convert a string to snake case.
-     *
-     * @param string $value
-     * @param string $delimiter
-     *
-     * @return string
-     */
-    public static function snake($value, $delimiter = '_'): string
-    {
-        $key = $value;
-
-        if (isset(static::$snakeCache[$key][$delimiter])) {
-            return static::$snakeCache[$key][$delimiter];
-        }
-
-        if (!ctype_lower($value)) {
-            $value = preg_replace('/\s+/u', '', ucwords($value));
-
-            $value = preg_replace('/(.)(?=[A-Z])/u', '$1' . $delimiter, (string)$value);
-            $value = mb_strtolower((string)$value, 'UTF-8');
-        }
-
-        return static::$snakeCache[$key][$delimiter] = $value;
-    }
 }

readme.md

@@ -2,7 +2,7 @@
 ![](https://img.shields.io/badge/php->=7.2-blue.svg)
 [![Latest Stable Version](https://poser.pugx.org/efureev/support/v/stable?format=flat)](https://packagist.org/packages/efureev/support)
 
-[![Build Status](https://travis-ci.org/efureev/php-support.svg?branch=master)](https://travis-ci.org/efureev/php-support)
+[![Build Status](https://travis-ci.org/efureev/php-support.svg?branch=v2)](https://travis-ci.org/efureev/php-support/tree/v2)
 [![Maintainability](https://api.codeclimate.com/v1/badges/a7cf8708bf58fa7e5096/maintainability)](https://codeclimate.com/github/efureev/php-support/maintainability)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/a7cf8708bf58fa7e5096/test_coverage)](https://codeclimate.com/github/efureev/php-support/test_coverage)
 [![codecov](https://codecov.io/gh/efureev/php-support/branch/master/graph/badge.svg)](https://codecov.io/gh/efureev/php-support)

src/Exceptions/ConfigException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/Exception.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/InvalidArgumentException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/InvalidCallException.php

@@ -1,4 +1,5 @@
 <?php
+declare(strict_types=1);
 
 namespace Php\Support\Exceptions;
 

src/Exceptions/InvalidConfigException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/InvalidParamException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/InvalidValueException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/JsonException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/MethodNotAllowedException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/MissingClassException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/MissingConfigException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/MissingPropertyException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/NotSupportedException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/UnknownMethodException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Exceptions/UnknownPropertyException.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 namespace Php\Support\Exceptions;

src/Helpers/Arr.php

@@ -204,4 +204,42 @@ public static function toIndexedArray(array $array): array
 
         return $array;
     }
+
+    /**
+     * Get an item from an array using "dot" notation.
+     *
+     * @param mixed $array
+     * @param null|string $key
+     * @param mixed $default
+     *
+     * @return mixed
+     */
+    public static function get($array, ?string $key, $default = null)
+    {
+        if (!static::accessible($array)) {
+            return value($default);
+        }
+
+        if ($key === null) {
+            return $array;
+        }
+
+        if (static::exists($array, $key)) {
+            return $array[$key];
+        }
+
+        if (strpos($key, '.') === false) {
+            return $array[$key] ?? value($default);
+        }
+
+        foreach (explode('.', $key) as $segment) {
+            if (static::accessible($array) && static::exists($array, $segment)) {
+                $array = $array[$segment];
+            } else {
+                return value($default);
+            }
+        }
+
+        return $array;
+    }
 }