feat: add make() method

Signed-off-by: Fery Wardiyanto <ferywardiyanto@gmail.com>

src/Container.php

@@ -92,4 +92,18 @@ public function unset(string $id): void
     {
         unset($this->instances[$id]);
     }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function make(string $concrete)
+    {
+        $instance = $this->resolver->resolve($concrete);
+
+        if (is_callable($instance)) {
+            return $this->resolver->handle($instance);
+        }
+
+        return $instance;
+    }
 }

src/Container/ContainerInterface.php

@@ -24,4 +24,12 @@ public function set(string $id, $instance): void;
      * @return void
      */
     public function unset(string $id): void;
+
+    /**
+     * Resolve an instance without adding it to the stack.
+     *
+     * @param string $concrete
+     * @return mixed
+     */
+    public function make(string $concrete);
 }

test/spec/Container.spec.php

@@ -3,7 +3,7 @@
 use Projek\Container;
 use Projek\Container\{ContainerInterface, Exception, NotFoundException };
 use Psr\Container\ContainerInterface as PsrContainer;
-use Stubs\ { Dummy, AbstractFoo, ConcreteBar, ServiceProvider};
+use Stubs\{Dummy, AbstractFoo, ConcreteBar, ServiceProvider};
 use function Kahlan\describe;
 use function Kahlan\expect;
 
@@ -102,6 +102,10 @@
     });
 
     it('Should throw exception when setting incorrect param', function () {
+        expect(function () {
+            $this->c->make(AbstractFoo::class);
+        })->toThrow(Exception::notInstantiable(AbstractFoo::class));
+
         expect(function () {
             $this->c->set('foo', AbstractFoo::class);
         })->toThrow(Exception::notInstantiable(AbstractFoo::class));
@@ -118,4 +122,21 @@
             $this->c->set('foo', null);
         })->toThrow(Exception::unresolvable('NULL'));
     });
+
+    it('Should make an instance without adding to the stack', function () {
+        // Dependencies.
+        $this->c->set('dummy', Dummy::class);
+        $this->c->set(AbstractFoo::class, ConcreteBar::class);
+
+        $instances = [
+            Stubs\CallableClass::class => AbstractFoo::class,
+            Stubs\InstantiableClass::class => Stubs\InstantiableClass::class,
+        ];
+
+        foreach ($instances as $concrete => $instance) {
+            expect($this->c->has($concrete))->toBeFalsy();
+            expect($this->c->make($concrete))->toBeAnInstanceOf($instance);
+            expect($this->c->has($concrete))->toBeFalsy();
+        }
+    });
 });

test/stub/CallableClass.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Stubs;
+
+class CallableClass
+{
+    /**
+     * @var stdClass
+     */
+    public $dummy;
+
+    public function __construct($dummy)
+    {
+        $this->dummy = $dummy;
+    }
+
+    public function __invoke(AbstractFoo $foo)
+    {
+        return $foo;
+    }
+}

test/stub/InstantiableClass.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Stubs;
+
+class InstantiableClass
+{
+    /**
+     * @var stdClass
+     */
+    public $dummy;
+
+    public function __construct($dummy)
+    {
+        $this->dummy = $dummy;
+    }
+}