chore(result): move Async\reflect to Result\reflect

CHANGELOG.md

@@ -66,4 +66,4 @@
 * **BC** - function `Psl\Password\algorithms()` have been removed.
 * **BC** - `Psl\Result\ResultInterface::getException()` method has been renamed to `Psl\Result\ResultInterface::getThrowable()`
 * **BC** - `Psl\Result\wrap` function now catches all `Throwable`s instead of only `Exception`s
-
+* introduced a new `Psl\Result\reflect` function

docs/component/async.md

@@ -19,7 +19,6 @@
 - [first](./../../src/Psl/Async/first.php#L20)
 - [later](./../../src/Psl/Async/later.php#L14)
 - [main](./../../src/Psl/Async/main.php#L18)
-- [reflect](./../../src/Psl/Async/reflect.php#L25)
 - [run](./../../src/Psl/Async/run.php#L19)
 - [series](./../../src/Psl/Async/series.php#L21)
 - [sleep](./../../src/Psl/Async/sleep.php#L10)

docs/component/result.md

@@ -12,6 +12,7 @@
 
 #### `Functions`
 
+- [reflect](./../../src/Psl/Result/reflect.php#L24)
 - [wrap](./../../src/Psl/Result/wrap.php#L20)
 
 #### `Interfaces`

src/Psl/Internal/Loader.php

@@ -433,7 +433,7 @@ final class Loader
         'Psl\Async\main',
         'Psl\Async\run',
         'Psl\Async\concurrently',
-        'Psl\Async\reflect',
+        'Psl\Result\reflect',
         'Psl\Async\series',
         'Psl\Async\await',
         'Psl\Async\any',

src/Psl/Result/reflect.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Psl\Result;
+
+use Closure;
+use Throwable;
+
+/**
+ * Wraps the given operation in another operation that always completes with a {@see Success},
+ * or {@see Failure} if the closure throws an {@see Throwable}.
+ *
+ * @template T
+ *
+ * @param Closure(): T $task
+ *
+ * @return Closure(): ResultInterface<T>
+ *
+ * @see wrap()
+ *
+ * @pure
+ */
+function reflect(Closure $task): Closure
+{
+    return static fn() => wrap($task);
+}

tests/unit/Async/ReflectTest.php

@@ -14,12 +14,12 @@ final class ReflectTest extends TestCase
     public function testReflectParallel(): void
     {
         [$one, $two] = Async\concurrently([
-            Async\reflect(static function (): void {
+            Result\reflect(static function (): void {
                 Async\sleep(0.0001);
 
                 throw new Exception('failure');
             }),
-            Async\reflect(static function (): string {
+            Result\reflect(static function (): string {
                 return 'success';
             }),
         ]);