create-berna-stencil 1.0.8 → 1.0.10

package/src/api/vendor/vlucas/phpdotenv/src/Store/File/Reader.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Store\File;
+
+use Dotenv\Exception\InvalidEncodingException;
+use Dotenv\Util\Str;
+use PhpOption\Option;
+
+/**
+ * @internal
+ */
+final class Reader
+{
+    /**
+     * This class is a singleton.
+     *
+     * @codeCoverageIgnore
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Read the file(s), and return their raw content.
+     *
+     * We provide the file path as the key, and its content as the value. If
+     * short circuit mode is enabled, then the returned array with have length
+     * at most one. File paths that couldn't be read are omitted entirely.
+     *
+     * @param string[]    $filePaths
+     * @param bool        $shortCircuit
+     * @param string|null $fileEncoding
+     *
+     * @throws \Dotenv\Exception\InvalidEncodingException
+     *
+     * @return array<string, string>
+     */
+    public static function read(array $filePaths, bool $shortCircuit = true, ?string $fileEncoding = null)
+    {
+        $output = [];
+
+        foreach ($filePaths as $filePath) {
+            $content = self::readFromFile($filePath, $fileEncoding);
+            if ($content->isDefined()) {
+                $output[$filePath] = $content->get();
+                if ($shortCircuit) {
+                    break;
+                }
+            }
+        }
+
+        return $output;
+    }
+
+    /**
+     * Read the given file.
+     *
+     * @param string      $path
+     * @param string|null $encoding
+     *
+     * @throws \Dotenv\Exception\InvalidEncodingException
+     *
+     * @return \PhpOption\Option<string>
+     */
+    private static function readFromFile(string $path, ?string $encoding = null)
+    {
+        /** @var Option<string> */
+        $content = Option::fromValue(@\file_get_contents($path), false);
+
+        return $content->flatMap(static function (string $content) use ($encoding) {
+            return Str::utf8($content, $encoding)->mapError(static function (string $error) {
+                throw new InvalidEncodingException($error);
+            })->success();
+        });
+    }
+}

package/src/api/vendor/vlucas/phpdotenv/src/Store/FileStore.php

@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Store;
+
+use Dotenv\Exception\InvalidPathException;
+use Dotenv\Store\File\Reader;
+
+final class FileStore implements StoreInterface
+{
+    /**
+     * The file paths.
+     *
+     * @var string[]
+     */
+    private $filePaths;
+
+    /**
+     * Should file loading short circuit?
+     *
+     * @var bool
+     */
+    private $shortCircuit;
+
+    /**
+     * The file encoding.
+     *
+     * @var string|null
+     */
+    private $fileEncoding;
+
+    /**
+     * Create a new file store instance.
+     *
+     * @param string[]    $filePaths
+     * @param bool        $shortCircuit
+     * @param string|null $fileEncoding
+     *
+     * @return void
+     */
+    public function __construct(array $filePaths, bool $shortCircuit, ?string $fileEncoding = null)
+    {
+        $this->filePaths = $filePaths;
+        $this->shortCircuit = $shortCircuit;
+        $this->fileEncoding = $fileEncoding;
+    }
+
+    /**
+     * Read the content of the environment file(s).
+     *
+     * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
+     *
+     * @return string
+     */
+    public function read()
+    {
+        if ($this->filePaths === []) {
+            throw new InvalidPathException('At least one environment file path must be provided.');
+        }
+
+        $contents = Reader::read($this->filePaths, $this->shortCircuit, $this->fileEncoding);
+
+        if (\count($contents) > 0) {
+            return \implode("\n", $contents);
+        }
+
+        throw new InvalidPathException(
+            \sprintf('Unable to read any of the environment file(s) at [%s].', \implode(', ', $this->filePaths))
+        );
+    }
+}

package/src/api/vendor/vlucas/phpdotenv/src/Store/StoreBuilder.php

@@ -0,0 +1,141 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Store;
+
+use Dotenv\Store\File\Paths;
+
+final class StoreBuilder
+{
+    /**
+     * The of default name.
+     */
+    private const DEFAULT_NAME = '.env';
+
+    /**
+     * The paths to search within.
+     *
+     * @var string[]
+     */
+    private $paths;
+
+    /**
+     * The file names to search for.
+     *
+     * @var string[]
+     */
+    private $names;
+
+    /**
+     * Should file loading short circuit?
+     *
+     * @var bool
+     */
+    private $shortCircuit;
+
+    /**
+     * The file encoding.
+     *
+     * @var string|null
+     */
+    private $fileEncoding;
+
+    /**
+     * Create a new store builder instance.
+     *
+     * @param string[]    $paths
+     * @param string[]    $names
+     * @param bool        $shortCircuit
+     * @param string|null $fileEncoding
+     *
+     * @return void
+     */
+    private function __construct(array $paths = [], array $names = [], bool $shortCircuit = false, ?string $fileEncoding = null)
+    {
+        $this->paths = $paths;
+        $this->names = $names;
+        $this->shortCircuit = $shortCircuit;
+        $this->fileEncoding = $fileEncoding;
+    }
+
+    /**
+     * Create a new store builder instance with no names.
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public static function createWithNoNames()
+    {
+        return new self();
+    }
+
+    /**
+     * Create a new store builder instance with the default name.
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public static function createWithDefaultName()
+    {
+        return new self([], [self::DEFAULT_NAME]);
+    }
+
+    /**
+     * Creates a store builder with the given path added.
+     *
+     * @param string $path
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public function addPath(string $path)
+    {
+        return new self(\array_merge($this->paths, [$path]), $this->names, $this->shortCircuit, $this->fileEncoding);
+    }
+
+    /**
+     * Creates a store builder with the given name added.
+     *
+     * @param string $name
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public function addName(string $name)
+    {
+        return new self($this->paths, \array_merge($this->names, [$name]), $this->shortCircuit, $this->fileEncoding);
+    }
+
+    /**
+     * Creates a store builder with short circuit mode enabled.
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public function shortCircuit()
+    {
+        return new self($this->paths, $this->names, true, $this->fileEncoding);
+    }
+
+    /**
+     * Creates a store builder with the specified file encoding.
+     *
+     * @param string|null $fileEncoding
+     *
+     * @return \Dotenv\Store\StoreBuilder
+     */
+    public function fileEncoding(?string $fileEncoding = null)
+    {
+        return new self($this->paths, $this->names, $this->shortCircuit, $fileEncoding);
+    }
+
+    /**
+     * Creates a new store instance.
+     *
+     * @return \Dotenv\Store\StoreInterface
+     */
+    public function make()
+    {
+        return new FileStore(
+            Paths::filePaths($this->paths, $this->names),
+            $this->shortCircuit,
+            $this->fileEncoding
+        );
+    }
+}

package/src/api/vendor/vlucas/phpdotenv/src/Store/StoreInterface.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Store;
+
+interface StoreInterface
+{
+    /**
+     * Read the content of the environment file(s).
+     *
+     * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
+     *
+     * @return string
+     */
+    public function read();
+}

package/src/api/vendor/vlucas/phpdotenv/src/Store/StringStore.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Store;
+
+final class StringStore implements StoreInterface
+{
+    /**
+     * The file content.
+     *
+     * @var string
+     */
+    private $content;
+
+    /**
+     * Create a new string store instance.
+     *
+     * @param string $content
+     *
+     * @return void
+     */
+    public function __construct(string $content)
+    {
+        $this->content = $content;
+    }
+
+    /**
+     * Read the content of the environment file(s).
+     *
+     * @return string
+     */
+    public function read()
+    {
+        return $this->content;
+    }
+}

package/src/api/vendor/vlucas/phpdotenv/src/Util/Regex.php

@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Util;
+
+use GrahamCampbell\ResultType\Error;
+use GrahamCampbell\ResultType\Success;
+
+/**
+ * @internal
+ */
+final class Regex
+{
+    /**
+     * This class is a singleton.
+     *
+     * @codeCoverageIgnore
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Perform a preg match, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<bool, string>
+     */
+    public static function matches(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            return @\preg_match($pattern, $subject) === 1;
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg match all, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<int, string>
+     */
+    public static function occurrences(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            return (int) @\preg_match_all($pattern, $subject);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg replace callback, wrapping up the result.
+     *
+     * @param string                     $pattern
+     * @param callable(string[]): string $callback
+     * @param string                     $subject
+     * @param int|null                   $limit
+     *
+     * @return \GrahamCampbell\ResultType\Result<string, string>
+     */
+    public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
+            return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg split, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<string[], string>
+     */
+    public static function split(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            /** @var string[] */
+            return (array) @\preg_split($pattern, $subject);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg operation, wrapping up the result.
+     *
+     * @template V
+     *
+     * @param callable(string): V $operation
+     * @param string              $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<V, string>
+     */
+    private static function pregAndWrap(callable $operation, string $subject)
+    {
+        $result = $operation($subject);
+
+        if (\preg_last_error() !== \PREG_NO_ERROR) {
+            /** @var \GrahamCampbell\ResultType\Result<V,string> */
+            return Error::create(\preg_last_error_msg());
+        }
+
+        /** @var \GrahamCampbell\ResultType\Result<V,string> */
+        return Success::create($result);
+    }
+}

package/src/api/vendor/vlucas/phpdotenv/src/Util/Str.php

@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Util;
+
+use GrahamCampbell\ResultType\Error;
+use GrahamCampbell\ResultType\Success;
+use PhpOption\Option;
+
+/**
+ * @internal
+ */
+final class Str
+{
+    /**
+     * This class is a singleton.
+     *
+     * @codeCoverageIgnore
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Convert a string to UTF-8 from the given encoding.
+     *
+     * @param string      $input
+     * @param string|null $encoding
+     *
+     * @return \GrahamCampbell\ResultType\Result<string, string>
+     */
+    public static function utf8(string $input, ?string $encoding = null)
+    {
+        if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
+            /** @var \GrahamCampbell\ResultType\Result<string, string> */
+            return Error::create(
+                \sprintf('Illegal character encoding [%s] specified.', $encoding)
+            );
+        }
+
+        $converted = $encoding === null ?
+            @\mb_convert_encoding($input, 'UTF-8') :
+            @\mb_convert_encoding($input, 'UTF-8', $encoding);
+
+        if (!is_string($converted)) {
+            /** @var \GrahamCampbell\ResultType\Result<string, string> */
+            return Error::create(
+                \sprintf('Conversion from encoding [%s] failed.', $encoding ?? 'NULL')
+            );
+        }
+
+        /**
+         * this is for support UTF-8 with BOM encoding
+         * @see https://en.wikipedia.org/wiki/Byte_order_mark
+         * @see https://github.com/vlucas/phpdotenv/issues/500
+         */
+        if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
+            $converted = \substr($converted, 3);
+        }
+
+        /** @var \GrahamCampbell\ResultType\Result<string, string> */
+        return Success::create($converted);
+    }
+
+    /**
+     * Search for a given substring of the input.
+     *
+     * @param string $haystack
+     * @param string $needle
+     *
+     * @return \PhpOption\Option<int>
+     */
+    public static function pos(string $haystack, string $needle)
+    {
+        /** @var \PhpOption\Option<int> */
+        return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
+    }
+
+    /**
+     * Grab the specified substring of the input.
+     *
+     * @param string   $input
+     * @param int      $start
+     * @param int|null $length
+     *
+     * @return string
+     */
+    public static function substr(string $input, int $start, ?int $length = null)
+    {
+        return \mb_substr($input, $start, $length, 'UTF-8');
+    }
+
+    /**
+     * Compute the length of the given string.
+     *
+     * @param string $input
+     *
+     * @return int
+     */
+    public static function len(string $input)
+    {
+        return \mb_strlen($input, 'UTF-8');
+    }
+}