Initial Commit

dependencies/league/uri/UriTemplate/VariableBag.php

@@ -0,0 +1,130 @@
+<?php
+
+/**
+ * League.Uri (https://uri.thephpleague.com)
+ *
+ * (c) Ignace Nyamagana Butera <nyamsprod@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+declare (strict_types=1);
+namespace WP_Ultimo\Dependencies\League\Uri\UriTemplate;
+
+use ArrayAccess;
+use Closure;
+use Countable;
+use IteratorAggregate;
+use Stringable;
+use Traversable;
+use function array_filter;
+use function is_bool;
+use function is_scalar;
+use const ARRAY_FILTER_USE_BOTH;
+/**
+ * @internal The class exposes the internal representation of variable bags
+ *
+ * @phpstan-type InputValue string|bool|int|float|array<string|bool|int|float>
+ *
+ * @implements ArrayAccess<string, InputValue>
+ * @implements IteratorAggregate<string, InputValue>
+ */
+final class VariableBag implements ArrayAccess, Countable, IteratorAggregate
+{
+    /**
+     * @var array<string,string|array<string>>
+     */
+    private array $variables = [];
+    /**
+     * @param iterable<array-key, InputValue> $variables
+     */
+    public function __construct(iterable $variables = [])
+    {
+        foreach ($variables as $name => $value) {
+            $this->assign((string) $name, $value);
+        }
+    }
+    public function count() : int
+    {
+        return \count($this->variables);
+    }
+    public function getIterator() : Traversable
+    {
+        yield from $this->variables;
+    }
+    public function offsetExists(mixed $offset) : bool
+    {
+        return \array_key_exists($offset, $this->variables);
+    }
+    public function offsetUnset(mixed $offset) : void
+    {
+        unset($this->variables[$offset]);
+    }
+    public function offsetSet(mixed $offset, mixed $value) : void
+    {
+        $this->assign($offset, $value);
+        /* @phpstan-ignore-line */
+    }
+    public function offsetGet(mixed $offset) : mixed
+    {
+        return $this->fetch($offset);
+    }
+    /**
+     * Tells whether the bag is empty or not.
+     */
+    public function isEmpty() : bool
+    {
+        return [] === $this->variables;
+    }
+    /**
+     * Tells whether the bag is empty or not.
+     */
+    public function isNotEmpty() : bool
+    {
+        return [] !== $this->variables;
+    }
+    /**
+     * Fetches the variable value if none found returns null.
+     *
+     * @return null|string|array<string>
+     */
+    public function fetch(string $name) : null|string|array
+    {
+        return $this->variables[$name] ?? null;
+    }
+    /**
+     * @param Stringable|InputValue $value
+     */
+    public function assign(string $name, Stringable|string|bool|int|float|array|null $value) : void
+    {
+        $this->variables[$name] = $this->normalizeValue($value, $name, \true);
+    }
+    /**
+     * @param Stringable|InputValue $value
+     *
+     * @throws TemplateCanNotBeExpanded if the value contains nested list
+     */
+    private function normalizeValue(Stringable|string|float|int|bool|array|null $value, string $name, bool $isNestedListAllowed) : array|string
+    {
+        return match (\true) {
+            is_bool($value) => \true === $value ? '1' : '0',
+            null === $value || is_scalar($value) || $value instanceof Stringable => (string) $value,
+            !$isNestedListAllowed => throw TemplateCanNotBeExpanded::dueToNestedListOfValue($name),
+            default => \array_map(fn($var): array|string => self::normalizeValue($var, $name, \false), $value),
+        };
+    }
+    /**
+     * Replaces elements from passed variables into the current instance.
+     */
+    public function replace(VariableBag $variables) : self
+    {
+        return new self($this->variables + $variables->variables);
+    }
+    /**
+     * Filters elements using the closure.
+     */
+    public function filter(Closure $fn) : self
+    {
+        return new self(array_filter($this->variables, $fn, ARRAY_FILTER_USE_BOTH));
+    }
+}