feat: add mapValue

Author: Fureev Eugene

CHANGELOG.md

@@ -4,6 +4,12 @@ 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].
 
+## v4.15.0
+
+### Added
+
+- Add global method `mapValue` Returns an array containing the results of applying func to the items of the $collection
+
 ## v4.14.0
 
 ### Added

src/Global/base.php

@@ -17,6 +17,19 @@ function value(mixed $value, mixed ...$args): mixed
     }
 }
 
+if (!function_exists('mapValue')) {
+    function mapValue(callable $fn, iterable $collection, mixed ...$args): array
+    {
+        $result = [];
+
+        foreach ($collection as $key => $value) {
+            $result[$key] = $fn($value, $key, ...$args);
+        }
+
+        return $result;
+    }
+}
+
 if (!function_exists('when')) {
     /**
      * Returns a value when a condition is truthy.
@@ -222,7 +235,8 @@ function remoteStaticCallOrTrow(object|string|null $class, string $method, mixed
             return $class::$method(...$params);
         }
 
-        throw new \Php\Support\Exceptions\MissingMethodException("$class::$method");
+        $strClass = is_object($class) ? $class::class : $class;
+        throw new \Php\Support\Exceptions\MissingMethodException("$strClass::$method");
     }
 }
 

tests/Global/BaseTest.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Php\Support\Tests;
+namespace Php\Support\Tests\Global;
 
 use Php\Support\Types\Point;
 use PHPUnit\Framework\TestCase;

tests/Global/MapValueTest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Php\Support\Tests\Global;
+
+use PHPUnit\Framework\TestCase;
+
+final class MapValueTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function mapValue(): void
+    {
+        $fnColl = static fn(string $value) => mb_strtoupper($value);
+        $result = mapValue($fnColl, ['test', 'app']);
+        $expect = [
+            'TEST',
+            'APP',
+        ];
+        self::assertEquals($expect, $result);
+    }
+
+    /**
+     * @test
+     */
+    public function mapValueWithParams(): void
+    {
+        $fnColl = static fn(string $value, $key, string $prefix, string $suffix) =>
+            $prefix . mb_strtoupper($value) . $suffix;
+        $result = mapValue($fnColl, ['test', 'app'], '- ', '.');
+        $expect = [
+            '- TEST.',
+            '- APP.',
+        ];
+        self::assertEquals($expect, $result);
+    }
+}