Dumper: added support for uninitialized lazy objects

Author: dg

src/Tracy/Dumper/Exposer.php

@@ -21,6 +21,11 @@ final class Exposer
 {
 	public static function exposeObject(object $obj, Value $value, Describer $describer): void
 	{
+		if (PHP_VERSION_ID >= 80400 && (new \ReflectionClass($obj))->isUninitializedLazyObject($obj)) {
+			self::exposeLazyObject($obj, $describer, $value);
+			return;
+		}
+
 		$values = get_mangled_object_vars($obj);
 		$props = self::getProperties($obj::class);
 
@@ -276,4 +281,23 @@ public static function exposeDsMap(
 			$describer->addPropertyTo($value, (string) $i++, new Ds\Pair($k, $v));
 		}
 	}
+
+
+	private static function exposeLazyObject(object $obj, Describer $describer, Value $value): void
+	{
+		$rc = new \ReflectionClass($obj);
+		foreach ($rc->getProperties(\ReflectionProperty::IS_PUBLIC) as $prop) {
+			if (!$prop->isLazy($obj)) {
+				$describer->addPropertyTo(
+					$value,
+					$prop->getName(),
+					$prop->getValue($obj),
+					Value::PropertyPublic,
+					described: $describer->describeEnumProperty($obj::class, $prop->getName(), $prop->getValue($obj)),
+				);
+			}
+		}
+
+		$value->value .= ' (lazy)';
+	}
 }

tests/Dumper/Dumper.toHtml().specials.lazyObject.phpt

@@ -0,0 +1,56 @@
+<?php
+
+/**
+ * Test: Tracy\Dumper::toHtml() & lazy object
+ * @phpversion 8.4
+ */
+
+declare(strict_types=1);
+
+use Tester\Assert;
+use Tracy\Dumper;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+class LazyClass
+{
+	public function __construct(
+		public int $id,
+		public string $title,
+	) {
+	}
+}
+
+$rc = new ReflectionClass(LazyClass::class);
+$ghost = $rc->newLazyGhost(function () {});
+
+// new ghost
+Assert::match(
+	<<<'XX'
+		<pre class="tracy-dump tracy-light"><span class="tracy-dump-object">LazyClass (lazy)</span> <span class="tracy-dump-hash">#%d%</span></pre>
+		XX,
+	Dumper::toHtml($ghost, [Dumper::DEPTH => 3]),
+);
+
+// preinitialized property
+$rc->getProperty('id')->setRawValueWithoutLazyInitialization($ghost, 123);
+
+Assert::match(
+	<<<'XX'
+		<pre class="tracy-dump tracy-light"
+		><span class="tracy-toggle"><span class="tracy-dump-object">LazyClass (lazy)</span> <span class="tracy-dump-hash">#%d%</span></span>
+		<div><span class="tracy-dump-indent">   </span><span class="tracy-dump-public">id</span>: <span class="tracy-dump-number">123</span>
+		</div></pre>
+		XX,
+	Dumper::toHtml($ghost, [Dumper::DEPTH => 3]),
+);
+
+// proxy
+$proxy = $rc->newLazyProxy(function () { return new LazyClass; });
+Assert::match(
+	<<<'XX'
+		<pre class="tracy-dump tracy-light"><span class="tracy-dump-object">LazyClass (lazy)</span> <span class="tracy-dump-hash">#%d%</span></pre>
+		XX,
+	Dumper::toHtml($proxy, [Dumper::DEPTH => 3]),
+);

tests/Dumper/Dumper.toText().specials.lazyObject.phpt

@@ -0,0 +1,54 @@
+<?php
+
+/**
+ * Test: Tracy\Dumper::toText() & lazy object
+ * @phpversion 8.4
+ */
+
+declare(strict_types=1);
+
+use Tester\Assert;
+use Tracy\Dumper;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+class LazyClass
+{
+	public function __construct(
+		public int $id,
+		public string $title,
+	) {
+	}
+}
+
+$rc = new ReflectionClass(LazyClass::class);
+$ghost = $rc->newLazyGhost(function () {});
+
+// new ghost
+Assert::match(
+	<<<'XX'
+		LazyClass (lazy) #%d%
+		XX,
+	Dumper::toText($ghost, [Dumper::DEPTH => 3]),
+);
+
+// preinitialized property
+$rc->getProperty('id')->setRawValueWithoutLazyInitialization($ghost, 123);
+
+Assert::match(
+	<<<'XX'
+		LazyClass (lazy) #%d%
+		   id: 123
+		XX,
+	Dumper::toText($ghost, [Dumper::DEPTH => 3]),
+);
+
+// proxy
+$proxy = $rc->newLazyProxy(function () { return new LazyClass; });
+Assert::match(
+	<<<'XX'
+		LazyClass (lazy) #%d%
+		XX,
+	Dumper::toText($proxy, [Dumper::DEPTH => 3]),
+);