papercraft 0.28 → 0.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eccca55a3b242b80413bad0c851619062d66c1b68eaa9f2e4a13ca9e4beefddf
-  data.tar.gz: a5cf234c36fe286a94d6607bc30e13a24568396f6fe78b2f0e22870618e97941
+  metadata.gz: 1ca707074311c909d6e2b4aa86748f1ffbd5b614d73fb78e85985d174b69e263
+  data.tar.gz: f53dc4fa5088472ccc805f50938f25539950446fe14e97facb2cc346722d13fe
 SHA512:
-  metadata.gz: 003a30933c7d7557a346ce02bcc54169427389db2e488ee5516b68b9e99d74f2b5f0464db4e327c1c3064bc7cbfe0df9c4ef0df6322b61a467f14f30a83b415c
-  data.tar.gz: cc8d7e819fdefc04a5ffb1966d707d6fb7e533bc0c8f6d3fc39191749c4733593850a4cb046648c010c2ae4daae6fbaa6980b806a1ab61d9746481dc63fd8ecf
+  metadata.gz: 0d216f2c8db4beed8c7fe184d3b8e0a13ba8af4684d4e46f5506f0b1eb6c3bfaa0ad76b7a5b1b6e28a8ba37a730545ca00139fd0bf35b74628d117c504fc1e9c
+  data.tar.gz: 27ac04cf8b75b5d6abda511513618fb6ef20417365ac7b45855d909323db3c536204f85d719a44e2374b095d955f4eb0c25901290990dab861c908fa4d73142e

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.29 2023-03-11
+
+- Add Tilt integration (#15)
+
 ## 0.28 2023-03-11
 
 - Add `HTML#import_map`, `HTML#js_module` methods

data/README.md

@@ -66,6 +66,7 @@ hello.render('world')
 ## Table of Content
 
 - [Installing Papercraft](#installing-papercraft)
+- [Using with Tilt](#using-with-tilt)
 - [Basic Usage](#basic-usage)
 - [Adding Tags](#adding-tags)
 - [Tag and Attribute Formatting](#tag-and-attribute-formatting)
@@ -126,6 +127,45 @@ Rendering a template is done using `#render`:
 html.render #=> "<div id="greeter"><p>Hello!</p></div>"
 ```
 
+## Using with Tilt
+
+Papercraft templates can also be rendered using Tilt:
+
+```ruby
+require 'tilt/papercraft'
+
+# loading from a file (with a .papercraft extension)
+template = Tilt.new('mytemplate.papercraft')
+template.render
+
+# defining a template inline:
+template = Tilt['papercraft'].new { <<~RUBY
+  h1 'Hello'
+RUBY
+}
+template.render
+```
+
+When rendering using Tilt, the following local variables are available to the
+template: `scope`, `locals` and `block`:
+
+```ruby
+template = Tilt['papercraft'].new { <<~RUBY
+  title scope.title
+  
+  h1 locals[:message]
+
+  emit block if block
+RUBY
+}
+
+def title
+  'foo'
+end
+
+template.render(self, message: 'bar') { p 'this is a paragraph' }
+```
+
 ## Adding Tags
 
 Tags are added using unqualified method calls, and can be nested using blocks:

data/lib/papercraft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Papercraft
-  VERSION = '0.28'
+  VERSION = '0.29'
 end

data/lib/tilt/papercraft.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'papercraft'
+require 'tilt'
+
+# Tilt.
+module Tilt
+  # Papercraft templating engine for Tilt
+  class PapercraftTemplate < Template
+    metadata[:mime_type] = 'text/html'
+
+    protected
+
+    def prepare
+      inner = eval("proc { |scope:, locals:, block:|\n#{data}\n}")
+      @template = Papercraft.html(&inner)
+    end
+
+    def evaluate(scope, locals, &block)
+      @template.render(scope: scope, locals: locals, block: block)
+    end
+  end
+
+  register(PapercraftTemplate, 'papercraft')
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: papercraft
 version: !ruby/object:Gem::Version
-  version: '0.28'
+  version: '0.29'
 platform: ruby
 authors:
 - Sharon Rosner
@@ -114,14 +114,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.9
+        version: 2.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.9
+        version: 2.1.0
 description: 
 email: sharon@noteflakes.com
 executables: []
@@ -143,6 +143,7 @@ files:
 - lib/papercraft/template.rb
 - lib/papercraft/version.rb
 - lib/papercraft/xml.rb
+- lib/tilt/papercraft.rb
 - papercraft.png
 homepage: http://github.com/digital-fabric/papercraft
 licenses: