Initial commit

2026-08-30 22:02:02 +00:00
commit b6bd2277f5
2334 changed files with 646393 additions and 0 deletions
@@ -0,0 +1,70 @@
+<?php
+
+/**
+ * EmptyReadStreamWrapper.php
+ *
+ * @since     2026-04-30
+ * @category  Library
+ * @package   File
+ * @author    Nicola Asuni <info@tecnick.com>
+ * @copyright 2015-2026 Nicola Asuni - Tecnick.com LTD
+ * @license   https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
+ * @link      https://github.com/tecnickcom/tc-lib-file
+ *
+ * This file is part of tc-lib-file software library.
+ */
+
+namespace Test;
+
+/**
+ * A stream wrapper that returns initial data on the first read then returns
+ * empty strings on all subsequent reads while never signalling EOF via
+ * stream_eof().  This exercises the inner `break` in File::rfRead() that
+ * fires when fread() yields an empty string before the while-loop condition
+ * can detect EOF.
+ */
+class EmptyReadStreamWrapper
+{
+    public mixed $context;
+
+    private string $initialData = 'ab';
+
+    private bool $initialRead = false;
+
+    // phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+    public function stream_open(string $path, string $mode, int $options, ?string &$opened_path): bool
+    {
+        unset($path, $mode, $options, $opened_path);
+        return true;
+    }
+
+    // phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+    public function stream_read(int $count): string
+    {
+        unset($count);
+        if (!$this->initialRead) {
+            $this->initialRead = true;
+            return $this->initialData;
+        }
+
+        // Return empty string while still claiming not at EOF so that the
+        // while-loop in rfRead() re-enters and hits the inner break.
+        return '';
+    }
+
+    // phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+    public function stream_eof(): bool
+    {
+        // Never signal EOF — stream_read() will return '' instead.
+        return false;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    // phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+    public function stream_stat(): array
+    {
+        return [];
+    }
+}