write unit test for utility methods and fix bugs

Author: dvlpr1996

.gitignore

@@ -1,2 +1,5 @@
 .vscode/
 vendor/
+/.phpunit.cache
+.phpunit.result.cache
+lang/

composer.json

@@ -1,48 +1,49 @@
 {
-"name": "dvlpr1996/php-string-helpers",
-"description": "some useful php string helpers",
-"keywords": [
-"php",
-"string",
-"helpers",
-"php-string-helpers"
-],
-"homepage": "https://github.com/dvlpr1996/php-string-helpers",
-"license": "MIT",
-"type": "library",
-"authors": [
-{
-"name": "Nima",
-"email": "nimajahanbakhshian@gmail.com",
-"role": "Developer"
-}
-],
-"support": {
-"issues": "https://github.com/dvlpr1996/php-string-helpers/issues",
-"source": "https://github.com/dvlpr1996/php-string-helpers"
-},
-"require": {
-"php": "^8.0"
-},
-"require-dev": {
-"symfony/var-dumper": "^6.0",
-"phpunit/phpunit": "^9.5"
-},
-"autoload": {
-"psr-4": {
-"PhpStringHelpers\\": "src/"
-},
-"files": [
-"./src/PhpStringHelpers.php"
-]
-},
-"autoload-dev": {
-"psr-4": {
-"PhpStringHelpers\\Tests\\": "tests/"
-}
-},
-"scripts": {
-"test": "vendor/bin/phpunit",
-"test-coverage": "vendor/bin/phpunit --coverage-html coverage"
-}
+ "name": "dvlpr1996/php-string-helpers",
+ "description": "some useful php string helpers",
+ "keywords": [
+ "php",
+ "string",
+ "helpers",
+ "php-string-helpers"
+ ],
+ "homepage": "https://github.com/dvlpr1996/php-string-helpers",
+ "license": "MIT",
+ "type": "library",
+ "authors": [
+ {
+ "name": "Nima",
+ "email": "nimajahanbakhshian@gmail.com",
+ "role": "Developer"
+ }
+ ],
+ "support": {
+ "issues": "https://github.com/dvlpr1996/php-string-helpers/issues",
+ "source": "https://github.com/dvlpr1996/php-string-helpers"
+ },
+ "require": {
+ "php": "^8.0"
+ },
+ "require-dev": {
+ "symfony/var-dumper": "^6.0",
+ "phpunit/phpunit": "^9.5"
+ },
+ "autoload": {
+ "psr-4": {
+ "PhpStringHelpers\\": "src/"
+ },
+ "files": [
+ "./src/PhpStringHelpers.php"
+ ]
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "PhpStringHelpers\\Tests\\": "tests/"
+ }
+ },
+ "scripts": {
+ "test": "vendor/bin/phpunit",
+ "test-coverage": "vendor/bin/phpunit --coverage-html coverage"
+ },
+ "minimum-stability": "dev"
 }

phpunit.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
+ bootstrap="vendor/autoload.php"
+ cacheResultFile=".phpunit.cache/test-results"
+ executionOrder="depends,defects"
+ forceCoversAnnotation="true"
+ beStrictAboutCoversAnnotation="true"
+ beStrictAboutOutputDuringTests="true"
+ beStrictAboutTodoAnnotatedTests="true"
+ convertDeprecationsToExceptions="true"
+ failOnRisky="true"
+ failOnWarning="true"
+ colors="true"
+ testdox = "true"
+ verbose="true">
+ <testsuites>
+ <testsuite name="default">
+ <directory>tests</directory>
+ </testsuite>
+ </testsuites>
+
+ <coverage cacheDirectory=".phpunit.cache/code-coverage"
+ processUncoveredFiles="true">
+ <include>
+ <directory suffix=".php">src</directory>
+ </include>
+ </coverage>
+</phpunit>

src/PhpStringHelpers.php

@@ -1,5 +1,4 @@
 <?php
-
 declare(strict_types=1);
 
 use PhpStringHelpers\utility\StrUtility as strHelpers;
@@ -81,10 +80,10 @@ function toSlug(string $string): string
  }
 }
 
-if (!function_exists('rmAllBlank')) {
- function rmAllBlank(string $words): string
+if (!function_exists('rmAllBlanks')) {
+ function rmAllBlanks(string $words): string
  {
- return strHelpers::rmAllBlank($words);
+ return strHelpers::rmAllBlanks($words);
  }
 }
 
@@ -109,10 +108,10 @@ function wrapper(int|string $string, int|string $wrapper = '*'): string
  }
 }
 
-if (!function_exists('path')) {
- function path(string $path, string $pathExtension = 'php'): string
+if (!function_exists('filePath')) {
+ function filePath(string $path, string $pathExtension = 'php'): string
  {
- return strHelpers::path($path, $pathExtension);
+ return strHelpers::filePath($path, $pathExtension);
  }
 }
 
@@ -137,17 +136,10 @@ function pureString(string $data): string
  }
 }
 
-if (!function_exists('randomWords')) {
- function randomWords(int $size = 5): string
- {
- return strHelpers::randomWords($size);
- }
-}
-
-if (!function_exists('randomWords')) {
- function randomWords(int $size = 5): string
+if (!function_exists('randomChar')) {
+ function randomChar(int $size = 5): string
  {
- return strHelpers::randomWords($size);
+ return strHelpers::randomChar($size);
  }
 }
 
@@ -266,10 +258,10 @@ function rmLeftChar(string $words, int $num): string
  }
 }
 
-if (!function_exists('rmChar')) {
- function rmChar(string $words, int $num): string
+if (!function_exists('rmBothSideChar')) {
+ function rmBothSideChar(string $words, int $num): string
  {
- return strHelpers::rmChar($words, $num);
+ return strHelpers::rmBothSideChar($words, $num);
  }
 }
 
@@ -329,10 +321,10 @@ function rmBeginningNumbers(string $string): string
  }
 }
 
-if (!function_exists('rmFinalNumbers')) {
- function rmFinalNumbers(string $string): string
+if (!function_exists('rmEndingNumbers')) {
+ function rmEndingNumbers(string $string): string
  {
- return strHelpers::rmFinalNumbers($string);
+ return strHelpers::rmEndingNumbers($string);
  }
 }
 

src/exceptions/FileDoesNotExistsException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace src\exceptions;
+namespace PhpStringHelpers\exceptions;
 
 use Exception;
 

src/exceptions/LanguageFileIsNotArrayException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace PhpStringHelpers\exceptions;
+
+use Exception;
+
+class LanguageFileIsNotArrayException extends Exception
+{
+ public function __construct(string $message, int $statusCode = 500)
+ {
+ parent::__construct($message, $statusCode);
+ }
+}

src/exceptions/UrlIsNotValidException.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace src\exceptions;
+namespace PhpStringHelpers\exceptions;
 
 use Exception;