255 bind data object (#256)

* build: upgrade to stable dom release

* feature: allow bindData to be used with object that has Bind Attributes
closes #255

Author: g105b

src/DocumentBinder.php

@@ -4,6 +4,7 @@
 use Gt\Dom\Document;
 use Gt\Dom\Element;
 use Iterator;
+use ReflectionObject;
 
 class DocumentBinder {
 	private ElementBinder $elementBinder;
@@ -66,6 +67,16 @@ public function bindData(
 			throw new IncompatibleBindDataException("bindData is only compatible with key-value-pair data, but it was passed an indexed array.");
 		}
 
+		if(is_object($kvp) && !is_iterable($kvp)) {
+			$refObj = new ReflectionObject($kvp);
+			foreach($refObj->getMethods() as $refMethod) {
+				foreach($refMethod->getAttributes(Bind::class) as $refAttr) {
+					$bindName = $refAttr->getArguments()[0];
+					$kvp->$bindName = $refMethod->getClosure($kvp);
+				}
+			}
+		}
+
 		foreach($kvp as $key => $value) {
 			$this->bindKeyValue($key, $value, $context);
 		}
@@ -102,6 +113,10 @@ private function bind(
 			$context = $this->document->documentElement;
 		}
 
+		if(is_callable($value)) {
+			$value = call_user_func($value);
+		}
+
 		$this->elementBinder->bind($key, $value, $context);
 		$this->placeholderBinder->bind($key, $value, $context);
 	}

src/TemplateCollection.php

@@ -3,7 +3,6 @@
 
 use Gt\Dom\Document;
 use Gt\Dom\Element;
-use Gt\Dom\Text;
 
 class TemplateCollection {
 	/** @var array<string, TemplateElement> */
@@ -50,6 +49,7 @@ private function extractTemplates(Document $document):void {
 		);
 
 		foreach($dataTemplateArray as $nodePath => $element) {
+			/** @var Element $element */
 			$templateElement = new TemplateElement($element);
 			$name = $templateElement->getTemplateName() ?? $nodePath;
 			$this->elementKVP[$name] = $templateElement;

test/phpunit/DocumentBinderTest.php

@@ -6,6 +6,7 @@
 use Gt\Dom\HTMLElement\HTMLParagraphElement;
 use Gt\Dom\HTMLElement\HTMLTableElement;
 use Gt\Dom\HTMLElement\HTMLTableRowElement;
+use Gt\DomTemplate\Bind;
 use Gt\DomTemplate\DocumentBinder;
 use Gt\DomTemplate\IncompatibleBindDataException;
 use Gt\DomTemplate\InvalidBindPropertyException;
@@ -375,4 +376,25 @@ public function testBindList():void {
 			self::assertSame($listItem, $liElementList[$i]->textContent);
 		}
 	}
+
+	public function testBindData_objectWithAttribute():void {
+		$document = DocumentTestFactory::createHTML(DocumentTestFactory::HTML_USER_PROFILE);
+		$sut = new DocumentBinder($document);
+
+		$userObject = new class {
+			#[Bind("username")]
+			public function getUser():string {
+				return "some_username";
+			}
+
+			#[Bind("email")]
+			public function getEmailAddress():string {
+				return "[email protected]";
+			}
+		};
+
+		$sut->bindData($userObject);
+		self::assertSame("some_username", $document->getElementById("dd1")->textContent);
+		self::assertSame("[email protected]", $document->getElementById("dd2")->textContent);
+	}
 }