Extend 'LeafRenderer' so that it can render 'Encodable' contexts (#188)

Motivation:

Out of the box, the 'LeafRenderer' offers a base API which can render
Leaf templates to a ByteBuffer. This requires the context to be provided
as a dictionary. With 'ViewRenderer' conformance the 'LeafRenderer' can
render 'View's using an Encodable context.

However, the 'LeafRenderer' can't render templates to a ByteBuffer using
an 'Encodable' context. Since, the 'LeafEncoder' is internal users also
can't encode their context to use the 'base' API.

This functionality is helpful when Leaf is used to render documents
which aren't HTML; such as SVG or XML.

Modifications:

- add an extension to 'LeafRenderer' to render a template at the given
  path using an 'Encodable' context
- add a test

Results:

The LeafRenderer can render templates to bytes using Encodable contexts.

Author: glbrntt

Sources/Leaf/LeafRenderer+ViewRenderer.swift

@@ -8,15 +8,30 @@ extension LeafRenderer: ViewRenderer {
 
     public func render<E>(_ name: String, _ context: E) -> EventLoopFuture<View>
         where E: Encodable
+    {
+        return self.render(path: name, context: context).map { buffer in
+            View(data: buffer)
+        }
+    }
+}
+
+extension LeafRenderer {
+    /// Populate the template at `path` with the data from `context`.
+    ///
+    /// - Parameters:
+    ///   - path: The name of the template to render.
+    ///   - context: Contextual data to render the template with.
+    /// - Returns: The serialized bytes of the rendered template.
+    public func render<Context>(path: String, context: Context) -> EventLoopFuture<ByteBuffer>
+        where Context: Encodable
     {
         let data: [String: LeafData]
         do {
             data = try LeafEncoder().encode(context)
         } catch {
             return self.eventLoop.makeFailedFuture(error)
         }
-        return self.render(path: name, context: data).map { buffer in
-            return View(data: buffer)
-        }
+
+        return self.render(path: path, context: data)
     }
 }

Tests/LeafTests/LeafTests.swift

@@ -192,6 +192,44 @@ class LeafTests: XCTestCase {
 
         XCTAssertTrue(renderer.cache.isEnabled)
     }
+
+    func testLeafRendererWithEncodableContext() throws {
+        var test = TestFiles()
+        test.files["/foo.leaf"] = """
+        Hello #(name)!
+        """
+
+        let app = Application(.testing)
+        defer { app.shutdown() }
+        app.views.use(.leaf)
+        app.leaf.sources = .singleSource(test)
+
+        struct NotHTML: ResponseEncodable {
+            var data: ByteBuffer
+
+            func encodeResponse(for request: Request) -> EventLoopFuture<Response> {
+                let response = Response(headers: ["content-type": "application/not-html"],
+                                        body: .init(buffer: self.data))
+                return request.eventLoop.makeSucceededFuture(response)
+            }
+        }
+
+        struct Foo: Encodable {
+            var name: String
+        }
+
+        app.get("foo") { req in
+            return req.application.leaf.renderer.render(path: "foo", context: Foo(name: "World")).map {
+                return NotHTML(data: $0)
+            }
+        }
+
+        try app.test(.GET, "foo") { res in
+            XCTAssertEqual(res.status, .ok)
+            XCTAssertEqual(res.headers.first(name: "content-type"), "application/not-html")
+            XCTAssertEqual(res.body.string, "Hello World!")
+        }
+    }
 }
 
 /// Helper `LeafFiles` struct providing an in-memory thread-safe map of "file names" to "file data"