init

2022-08-21 21:39:06 +02:00
commit 27c1969aaa
7354 changed files with 897064 additions and 0 deletions
--- a/vendor/fakerphp/faker/src/Faker/Container/Container.php
+++ b/vendor/fakerphp/faker/src/Faker/Container/Container.php
@@ -0,0 +1,145 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Container;
+
+use Faker\Extension\Extension;
+
+/**
+ * A simple implementation of a container.
+ *
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Container implements ContainerInterface
+{
+    /**
+     * @var array<string, callable|object|string>
+     */
+    private $definitions;
+
+    private $services = [];
+
+    /**
+     * Create a container object with a set of definitions. The array value MUST
+     * produce an object that implements Extension.
+     *
+     * @param array<string, callable|object|string> $definitions
+     */
+    public function __construct(array $definitions)
+    {
+        $this->definitions = $definitions;
+    }
+
+    /**
+     * Retrieve a definition from the container.
+     *
+     * @param string $id
+     *
+     * @throws \InvalidArgumentException
+     * @throws \RuntimeException
+     * @throws ContainerException
+     * @throws NotInContainerException
+     */
+    public function get($id): Extension
+    {
+        if (!is_string($id)) {
+            throw new \InvalidArgumentException(sprintf(
+                'First argument of %s::get() must be string',
+                self::class
+            ));
+        }
+
+        if (array_key_exists($id, $this->services)) {
+            return $this->services[$id];
+        }
+
+        if (!$this->has($id)) {
+            throw new NotInContainerException(sprintf(
+                'There is not service with id "%s" in the container.',
+                $id
+            ));
+        }
+
+        $definition = $this->definitions[$id];
+
+        $service = $this->services[$id] = $this->getService($id, $definition);
+
+        if (!$service instanceof Extension) {
+            throw new \RuntimeException(sprintf(
+                'Service resolved for identifier "%s" does not implement the %s" interface.',
+                $id,
+                Extension::class
+            ));
+        }
+
+        return $service;
+    }
+
+    /**
+     * Get the service from a definition.
+     *
+     * @param callable|object|string $definition
+     */
+    private function getService($id, $definition)
+    {
+        if (is_callable($definition)) {
+            try {
+                return $definition();
+            } catch (\Throwable $e) {
+                throw new ContainerException(
+                    sprintf('Error while invoking callable for "%s"', $id),
+                    0,
+                    $e
+                );
+            }
+        } elseif (is_object($definition)) {
+            return $definition;
+        } elseif (is_string($definition)) {
+            if (class_exists($definition)) {
+                try {
+                    return new $definition();
+                } catch (\Throwable $e) {
+                    throw new ContainerException(sprintf('Could not instantiate class "%s"', $id), 0, $e);
+                }
+            }
+
+            throw new ContainerException(sprintf(
+                'Could not instantiate class "%s". Class was not found.',
+                $id
+            ));
+        } else {
+            throw new ContainerException(sprintf(
+                'Invalid type for definition with id "%s"',
+                $id
+            ));
+        }
+    }
+
+    /**
+     * Check if the container contains a given identifier.
+     *
+     * @param string $id
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function has($id): bool
+    {
+        if (!is_string($id)) {
+            throw new \InvalidArgumentException(sprintf(
+                'First argument of %s::get() must be string',
+                self::class
+            ));
+        }
+
+        return array_key_exists($id, $this->definitions);
+    }
+
+    /**
+     * Get the bindings between Extension interfaces and implementations.
+     */
+    public function getDefinitions(): array
+    {
+        return $this->definitions;
+    }
+}