Implement function builder interface (#1)

* Initial implementation of DOM builder interface

* Rename name parameter to target in PI initializer

* Fix document XPath searching with namespaces

Add test for parsing and searching XSD

* Implement builder interface with XHTML 1.1 tags

* Add .gitattributes

* Run builder tests only on Swift >= 5.3

* Add Brewfile.lock.json

* Add example usage for builder interface

* Test on Swift 5.1, 5.2, and 5.3

Author: mattt

.gitattributes

@@ -0,0 +1 @@
+Resources/* linguist-vendored

.github/workflows/ci.yml

@@ -4,11 +4,11 @@ on: [push]
 
 jobs:
   macos:
-    runs-on: macOS-latest
+    runs-on: macos-latest
 
     strategy:
       matrix:
-        xcode: ["11.4", "11.3"]
+        xcode: ["12", "11.7", "11.3"]
 
     steps:
       - name: Checkout
@@ -26,7 +26,7 @@ jobs:
 
     strategy:
       matrix:
-        swift: ["5.2", "5.1"]
+        swift: ["5.3", "5.2", "5.1"]
 
     container:
       image: swift:${{ matrix.swift }}

Brewfile

@@ -1 +1,4 @@
-brew "libxml2", link: true
+tap 'nshipster/formulae'
+brew 'gyb'
+
+brew 'libxml2', link: true

Brewfile.lock.json

@@ -0,0 +1,61 @@
+{
+  "entries": {
+    "tap": {
+      "nshipster/formulae": {
+        "revision": "c780bc082b3f89580849ba6a457c242ec9158b4a"
+      }
+    },
+    "brew": {
+      "gyb": {
+        "version": "2019-01-18",
+        "bottle": false
+      },
+      "libxml2": {
+        "version": "2.9.10_2",
+        "bottle": {
+          "rebuild": 0,
+          "cellar": ":any",
+          "prefix": "/usr/local",
+          "root_url": "https://homebrew.bintray.com/bottles",
+          "files": {
+            "arm64_big_sur": {
+              "url": "https://homebrew.bintray.com/bottles/libxml2-2.9.10_2.arm64_big_sur.bottle.tar.gz",
+              "sha256": "c2e1bb939465a54e70ac4a6a8c333d00bc01a3738037f77cfd2227e47053ff47"
+            },
+            "big_sur": {
+              "url": "https://homebrew.bintray.com/bottles/libxml2-2.9.10_2.big_sur.bottle.tar.gz",
+              "sha256": "0170a16da823ce77d1aad7db927b23a1adb12285a174f36a918275d7952eaaae"
+            },
+            "catalina": {
+              "url": "https://homebrew.bintray.com/bottles/libxml2-2.9.10_2.catalina.bottle.tar.gz",
+              "sha256": "2983d5a448504389888720bf951713114ed7f010d96cde9289fdc5c4b539d303"
+            },
+            "mojave": {
+              "url": "https://homebrew.bintray.com/bottles/libxml2-2.9.10_2.mojave.bottle.tar.gz",
+              "sha256": "7bcd780db5693475c7711eefbbcf703507865e06483e7338ab61027ec375c4bc"
+            },
+            "high_sierra": {
+              "url": "https://homebrew.bintray.com/bottles/libxml2-2.9.10_2.high_sierra.bottle.tar.gz",
+              "sha256": "34d84eaef7f80632a6547903d640be06c6d92b9ca2b815b64b74943b4cf73e63"
+            }
+          }
+        },
+        "options": {
+          "link": true
+        }
+      }
+    }
+  },
+  "system": {
+    "macos": {
+      "catalina": {
+        "HOMEBREW_VERSION": "3.0.10-46-g958b2ec",
+        "HOMEBREW_PREFIX": "/usr/local",
+        "Homebrew/homebrew-core": "acc12fd244cdc4664a57469a4ee7d2471bfc3f52",
+        "CLT": "12.4.0.0.1.1610135815",
+        "Xcode": "12.4",
+        "macOS": "10.15.7"
+      }
+    }
+  }
+}

Makefile

@@ -0,0 +1,8 @@
+Sources/HTML/HTMLTags.swift: Resources/xhtml11.xsd
+
+%.swift: %.swift.gyb
+	@gyb --line-directive '' -o $@ $<
+
+.PHONY:
+clean:
+	@rm Sources/HTML/HTMLTags.swift

README.md

@@ -20,7 +20,7 @@ based on [libxml2][libxml2].
 - [ ] XInclude Support*
 - [ ] XSLT Support*
 - [ ] SAX Parser Interface*
-- [ ] HTML and XML Function Builder Interfaces*
+- [x] HTML and XML Function Builder Interfaces
 
 > \* Coming soon!
 
@@ -133,6 +133,49 @@ document.body?.description // =>
 */
 ```
 
+#### Builder Interface
+
+Available in Swift 5.3+.
+
+```swift
+import HTML
+
+let document = HTML.Document {
+    html(["lang": "en"]) {
+        head {
+            meta(["charset": "UTF-8"])
+            title { "Hello, world!" }
+        }
+
+        body(["class": "beautiful"]) {
+            div(["class": "wrapper"]) {
+                span { "Hello," }
+                tag("span") { "world!" }
+            }
+        }
+    }
+}
+
+document.description // =>
+/*
+<html lang="en">
+  <head>
+      <meta charset="UTF-8">
+      <title>Hello, world!</title>
+  </head>
+  <body class="beautiful">
+      <?greeter start>
+      <div class="wrapper">
+          <span>Hello,</span>
+          <span>world!</span>
+      </div>
+      <?greeter end>
+  </body>
+</html>
+
+*/
+```
+
 ## Installation
 
 ### Swift Package Manager