Add Wrap and Unwrap operations.

docs/pages/api.rst

@@ -912,6 +912,22 @@ Signature: ``Collection::until(callable ...$callbacks);``
             return 1 === $number;
         });
 
+unwrap
+~~~~~~
+
+Unwrap every collection element.
+
+Interface: `Unwrapable`_
+
+Signature: ``Collection::unwrap();``
+
+.. code-block:: php
+
+     $data = [['a' => 'A'], ['b' => 'B'], ['c' => 'C']];
+
+     $collection = Collection::with($data)
+        ->unwrap();
+
 walk
 ~~~~
 
@@ -949,6 +965,22 @@ Signature: ``Collection::window(int ...$length);``
         ->window(2, 3)
         ->all();
 
+wrap
+~~~~
+
+Wrap every element into an array.
+
+Interface: `Wrapable`_
+
+Signature: ``Collection::wrap();``
+
+.. code-block:: php
+
+     $data = ['a' => 'A', 'b' => 'B', 'c' => 'C'];
+
+     $collection = Collection::with($data)
+        ->wrap();
+
 zip
 ~~~
 
@@ -1099,6 +1131,8 @@ Interface: `Truthyable`_
 .. _Transposeable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Transposeable.php
 .. _Truthyable: https://github.com/loophp/collection/blob/master/src/Contract/Transformation/Truthyable.php
 .. _Untilable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Untilable.php
+.. _Unwrapable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Unwrapable.php
 .. _Walkable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Walkable.php
 .. _Windowable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Windowable.php
+.. _Wrapable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Wrapable.php
 .. _Zipable: https://github.com/loophp/collection/blob/master/src/Contract/Operation/Zipable.php

spec/loophp/collection/CollectionSpec.php

@@ -1599,6 +1599,26 @@ public function it_can_until(): void
             ->shouldIterateAs([5, 16, 8, 4, 2, 1]);
     }
 
+    public function it_can_unwrap()
+    {
+        $this::with([['a' => 'A'], ['b' => 'B'], ['c' => 'C']])
+            ->unwrap()
+            ->shouldIterateAs([
+                'a' => 'A',
+                'b' => 'B',
+                'c' => 'C',
+            ]);
+
+        $this::fromIterable(['foo' => ['a' => 'A'], 'bar' => ['b' => 'B'], 'foobar' => ['c' => 'C', 'd' => 'D']])
+            ->unwrap()
+            ->shouldIterateAs([
+                'a' => 'A',
+                'b' => 'B',
+                'c' => 'C',
+                'd' => 'D',
+            ]);
+    }
+
     public function it_can_use_range(): void
     {
         $this
@@ -1824,6 +1844,17 @@ public function it_can_window(): void
             ]);
     }
 
+    public function it_can_wrap()
+    {
+        $this::with(['a' => 'A', 'b' => 'B', 'c' => 'C'])
+            ->wrap()
+            ->shouldIterateAs([
+                ['a' => 'A'],
+                ['b' => 'B'],
+                ['c' => 'C'],
+            ]);
+    }
+
     public function it_can_zip(): void
     {
         $this

src/Collection.php

@@ -51,8 +51,10 @@
 use loophp\collection\Operation\Times;
 use loophp\collection\Operation\Transpose;
 use loophp\collection\Operation\Until;
+use loophp\collection\Operation\Unwrap;
 use loophp\collection\Operation\Walk;
 use loophp\collection\Operation\Window;
+use loophp\collection\Operation\Wrap;
 use loophp\collection\Operation\Zip;
 use loophp\collection\Transformation\All;
 use loophp\collection\Transformation\Contains;
@@ -444,6 +446,11 @@ public function until(callable ...$callbacks): BaseInterface
         return $this->run(new Until(...$callbacks));
     }
 
+    public function unwrap(): BaseInterface
+    {
+        return $this->run(new Unwrap());
+    }
+
     public function walk(callable ...$callbacks): BaseInterface
     {
         return $this->run(new Walk(...$callbacks));
@@ -462,6 +469,11 @@ public static function with($data = [], ...$parameters): CollectionInterface
         return new self($data, ...$parameters);
     }
 
+    public function wrap(): BaseInterface
+    {
+        return $this->run(new Wrap());
+    }
+
     /**
      * {@inheritdoc}
      */

src/Contract/Collection.php

@@ -50,8 +50,10 @@
 use loophp\collection\Contract\Operation\Timesable;
 use loophp\collection\Contract\Operation\Transposeable;
 use loophp\collection\Contract\Operation\Untilable;
+use loophp\collection\Contract\Operation\Unwrapable;
 use loophp\collection\Contract\Operation\Walkable;
 use loophp\collection\Contract\Operation\Windowable;
+use loophp\collection\Contract\Operation\Wrapable;
 use loophp\collection\Contract\Operation\Zipable;
 use loophp\collection\Contract\Transformation\Allable;
 use loophp\collection\Contract\Transformation\Containsable;
@@ -126,8 +128,10 @@ interface Collection extends
     Transposeable,
     Truthyable,
     Untilable,
+    Unwrapable,
     Walkable,
     Windowable,
+    Wrapable,
     Zipable
 {
     /**

src/Contract/Operation/Unwrapable.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace loophp\collection\Contract\Operation;
+
+use loophp\collection\Contract\Base;
+
+interface Unwrapable
+{
+    public function unwrap(): Base;
+}

src/Contract/Operation/Wrapable.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace loophp\collection\Contract\Operation;
+
+use loophp\collection\Contract\Base;
+
+interface Wrapable
+{
+    public function wrap(): Base;
+}

src/Operation/Unwrap.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace loophp\collection\Operation;
+
+use Closure;
+use Generator;
+use loophp\collection\Contract\Operation;
+
+final class Unwrap extends AbstractOperation implements Operation
+{
+    public function __invoke(): Closure
+    {
+        return static function (iterable $collection): Generator {
+            foreach ($collection as $key => $value) {
+                foreach ((array) $value as $k => $v) {
+                    yield $k => $v;
+                }
+            }
+        };
+    }
+}

src/Operation/Wrap.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace loophp\collection\Operation;
+
+use Closure;
+use Generator;
+use loophp\collection\Contract\Operation;
+
+final class Wrap extends AbstractOperation implements Operation
+{
+    public function __invoke(): Closure
+    {
+        return static function (iterable $collection): Generator {
+            foreach ($collection as $key => $value) {
+                yield [$key => $value];
+            }
+        };
+    }
+}