From 110dc2831488937c1afb70c11657a341912fc8cd Mon Sep 17 00:00:00 2001
From: Peter Nguyen <peteralistairnguyen@gmail.com>
Date: Wed, 5 Feb 2025 00:44:12 -0600
Subject: Initial commit 2/25/2025

---
 .../src/Repository/Adapter/ImmutableWriter.php     | 110 +++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php

(limited to 'vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php')

diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php
new file mode 100644
index 0000000..399e6f9
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php
@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+final class ImmutableWriter implements WriterInterface
+{
+    /**
+     * The inner writer to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface
+     */
+    private $writer;
+
+    /**
+     * The inner reader to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface
+     */
+    private $reader;
+
+    /**
+     * The record of loaded variables.
+     *
+     * @var array<string,string>
+     */
+    private $loaded;
+
+    /**
+     * Create a new immutable writer instance.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface $writer
+     * @param \Dotenv\Repository\Adapter\ReaderInterface $reader
+     *
+     * @return void
+     */
+    public function __construct(WriterInterface $writer, ReaderInterface $reader)
+    {
+        $this->writer = $writer;
+        $this->reader = $reader;
+        $this->loaded = [];
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        // Don't overwrite existing environment variables
+        // Ruby's dotenv does this with `ENV[key] ||= value`
+        if ($this->isExternallyDefined($name)) {
+            return false;
+        }
+
+        // Set the value on the inner writer
+        if (!$this->writer->write($name, $value)) {
+            return false;
+        }
+
+        // Record that we have loaded the variable
+        $this->loaded[$name] = '';
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        // Don't clear existing environment variables
+        if ($this->isExternallyDefined($name)) {
+            return false;
+        }
+
+        // Clear the value on the inner writer
+        if (!$this->writer->delete($name)) {
+            return false;
+        }
+
+        // Leave the variable as fair game
+        unset($this->loaded[$name]);
+
+        return true;
+    }
+
+    /**
+     * Determine if the given variable is externally defined.
+     *
+     * That is, is it an "existing" variable.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    private function isExternallyDefined(string $name)
+    {
+        return $this->reader->read($name)->isDefined() && !isset($this->loaded[$name]);
+    }
+}
-- 
cgit v1.2.3