Adding Tappable trait

README.md

@@ -97,3 +97,37 @@ return tap(new Psr7Response(), function ($response) {
     $response->getBody()->write('foo');
 });
 ```
+
+## Traits
+
+### SlimFacades\Traits\Tappable
+
+```php
+use SlimFacades\Support\Traits\Tappable;
+
+class TappableClass
+{
+    use Tappable;
+
+    private $name;
+
+    public static function make()
+    {
+        return new static;
+    }
+
+    public function setName($name)
+    {
+        $this->name = $name;
+    }
+
+    public function getName()
+    {
+        return $this->name;
+    }
+}
+
+$name = TappableClass::make()->tap(function ($tappable) {
+    $tappable->setName('MyName');
+})->getName();
+```

src/Support/Traits/Tappable.php

@@ -0,0 +1,17 @@
+<?php declare(strict_types=1);
+
+namespace SlimFacades\Support\Traits;
+
+trait Tappable
+{
+    /**
+     * Call the given Closure with this instance then return the instance.
+     *
+     * @param  callable|null  $callback
+     * @return $this|\Illuminate\Support\HigherOrderTapProxy
+     */
+    public function tap($callback = null)
+    {
+        return tap($this, $callback);
+    }
+}

tests/Support/Traits/TappableTest.php

@@ -0,0 +1,73 @@
+<?php declare(strict_types=1);
+
+use SlimFacades\Support\Traits\Tappable;
+use PHPUnit\Framework\TestCase;
+
+class TappableTest extends TestCase
+{
+    public function testTappableClassWithCallback()
+    {
+        $name = TappableClass::make()->tap(function ($tappable) {
+            $tappable->setName('MyName');
+        })->getName();
+
+        $this->assertSame('MyName', $name);
+    }
+
+    public function testTappableClassWithInvokableClass()
+    {
+        $name = TappableClass::make()->tap(new class
+        {
+            public function __invoke($tappable)
+            {
+                $tappable->setName('MyName');
+            }
+        })->getName();
+
+        $this->assertSame('MyName', $name);
+    }
+
+    public function testTappableClassWithNoneInvokableClass()
+    {
+        $this->expectException('Error');
+
+        $name = TappableClass::make()->tap(new class
+        {
+            public function setName($tappable)
+            {
+                $tappable->setName('MyName');
+            }
+        })->getName();
+
+        $this->assertSame('MyName', $name);
+    }
+
+    public function testTappableClassWithoutCallback()
+    {
+        $name = TappableClass::make()->tap()->setName('MyName')->getName();
+
+        $this->assertSame('MyName', $name);
+    }
+}
+
+class TappableClass
+{
+    use Tappable;
+
+    private $name;
+
+    public static function make()
+    {
+        return new static;
+    }
+
+    public function setName($name)
+    {
+        $this->name = $name;
+    }
+
+    public function getName()
+    {
+        return $this->name;
+    }
+}