Merge branch 'rnewton-master' into dev/3.0.0

Author: paquettg

src/PHPHtmlParser/Dom.php

@@ -146,6 +146,7 @@ public function __get($name)
      * @throws CircularException
      * @throws CurlException
      * @throws StrictException
+     * @throws LogicalException
      */
     public function load(string $str, array $options = []): Dom
     {
@@ -607,6 +608,7 @@ protected function clean(string $str): string
      * @throws ChildNotFoundException
      * @throws CircularException
      * @throws StrictException
+     * @throws LogicalException
      */
     protected function parse(): void
     {

src/PHPHtmlParser/Dom/AbstractNode.php

@@ -310,6 +310,27 @@ public function getTag(): Tag
         return $this->tag;
     }
 
+    /**
+     * Replaces the tag for this node
+     *
+     * @param string|Tag $tag
+     * @return AbstractNode
+     * @chainable
+     */
+    public function setTag($tag): AbstractNode
+    {
+        if (is_string($tag)) {
+            $tag = new Tag($tag);
+        }
+
+        $this->tag = $tag;
+
+        // clear any cache
+        $this->clear();
+
+        return $this;
+    }
+
     /**
      * A wrapper method that simply calls the getAttribute method
      * on the tag of this node.

tests/Node/HtmlTest.php

@@ -413,6 +413,18 @@ public function testRemoveAllAttributes()
         $this->assertEquals(0, \count($node->getAttributes()));
     }
 
+    public function testSetTag()
+    {
+        $node = new HtmlNode('div');
+        $this->assertEquals('<div></div>', $node->outerHtml());
+
+        $node->setTag('p');
+        $this->assertEquals('<p></p>', $node->outerHtml());
+
+        $node->setTag(new Tag('span'));
+        $this->assertEquals('<span></span>', $node->outerHtml());
+    }
+
     public function testCountable()
     {
         $div = new Tag('div');