Merge pull request #14 from 8fold/custom-properties-in-doctype

feature: Users can set version, encoding, and standalone

Author: joshbruce

src/Document.php

@@ -19,17 +19,46 @@ class Document implements Buildable, Contentable
     use BuildableImp;
     use ContentableImp;
 
+    private string $version = '1.0';
+
+    private string $encoding = 'UTF-8';
+
+    private string $standalone = 'yes';
+
     final private function __construct(
         private string $name,
         string|Stringable ...$content
     ) {
         $this->content  = $content;
     }
 
+    public function setVersion(string|float|int $version): self
+    {
+        if (is_int($version)) {
+            $version = strval($version) . '.0';
+        }
+        $this->version = strval($version);
+        return $this;
+    }
+
+    public function setEncoding(string $encoding): self
+    {
+        $this->encoding = $encoding;
+        return $this;
+    }
+
+    public function setStandalone(bool $standalone = true): self
+    {
+        $this->standalone = ($standalone) ? 'yes' : 'no';
+        return $this;
+    }
+
     public function __toString(): string
     {
         $doctype =
-            '<?xml version = "1.0" encoding = "UTF-8" standalone = "yes" ?>'
+            '<?xml version = "' . $this->version .
+            '" encoding = "' . $this->encoding .
+            '" standalone = "' . $this->standalone . '" ?>'
             . "\n";
         return $doctype . $this->opening() . implode('', $this->content)
             . $this->closing();

tests/DocumentBaselineTest.php

@@ -13,6 +13,39 @@
 
 class DocumentBaselineTest extends TestCase
 {
+    /**
+     * @test
+     */
+    public function document_can_modify_doctype_properties(): void
+    {
+        $this->assertSame(
+            '<?xml version = "1.1" encoding = "UTF-16" standalone = "no" ?>' . "\n" .
+            '<root></root>',
+            (string) Document::create('root')
+                ->setVersion(1.1)
+                ->setEncoding('UTF-16')
+                ->setStandalone(false)
+        );
+
+        $this->assertSame(
+            '<?xml version = "1.1" encoding = "UTF-16" standalone = "no" ?>' . "\n" .
+            '<root></root>',
+            (string) Document::create('root')
+                ->setVersion('1.1')
+                ->setEncoding('UTF-16')
+                ->setStandalone(false)
+        );
+
+        $this->assertSame(
+            '<?xml version = "1.0" encoding = "UTF-16" standalone = "no" ?>' . "\n" .
+            '<root></root>',
+            (string) Document::create('root')
+                ->setVersion(1)
+                ->setEncoding('UTF-16')
+                ->setStandalone(false)
+        );
+    }
+
     /**
      *@test
      */

tests/PerformanceTest.php

@@ -62,7 +62,7 @@ public function document_is_speedy(): void
         $elapsed = $end - $start;
         $ms      = $elapsed/1e+6;
 
-        $this->assertLessThan(0.1, $ms);
+        $this->assertLessThan(0.2, $ms);
     }
 
     /**