handlebars-engine 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b6bc490b95cc268a0cc7ee638660caecbfe9d978a13335b8c3588f89e16c3db
-  data.tar.gz: 014eb30c05c4edba8b9f9a340e3539a8542edabd94954efa189b2611456e10d8
+  metadata.gz: cad7fc20a466c4635a87db80dcd3996ef8753bfb6fdbea1d9f90e4463403850b
+  data.tar.gz: c3613182647712f6b9dc8d4da55721e546c1cd4786956524aa5596338e656686
 SHA512:
-  metadata.gz: a092e8fdae258e997d6afb3505b20a67898caf7d08bfd37efee1a50f663b0e084648902b6d396fe392acb46a8e5587deee277e2ec750f31ce103ad8dd42d1d6b
-  data.tar.gz: 99c271de356730e76c660fb806d8dd619edb0f522951a5e822f6460e0e415c02e20311aab2e5be55e89f9b2ffd161e87b75784726512df26d5c59d002ec06f9a
+  metadata.gz: 7d28c6fe7442a645a4f4c463776bde45cfece64c431538fe799380f769c520f9ff38a7f3b4bbc619dd366e81d21ba46a0b8c8466e15000c6eec852a3fba499b1
+  data.tar.gz: d2cf108b5e1a029de806fba2366e0a5ff6060d1ac1898e51c98b1242ed9f918ef95f2ef92bb90c57703f11ac4d41044833797f30e97ebea6877b0ae7e9050011

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2022-01-31
+
+### Added
+- `initialize`: add path parameter ([#5](https://github.com/gi/handlebars-ruby/pull/5))
+- `register_helper`: accept multiple helpers as keyword parameters ([#6](https://github.com/gi/handlebars-ruby/pull/6))
+- `register_helper`: accept javascript function as string ([#7](https://github.com/gi/handlebars-ruby/pull/7))
+- `ci`: verify gem builds ([#8](https://github.com/gi/handlebars-ruby/pull/8))
+- `require`: allow loading from `handlebars-engine` and `handlebars/engine` ([#8](https://github.com/gi/handlebars-ruby/pull/8))
+
 ## [0.2.0] - 2022-01-27
 
 This is the initial implementation, wrapping the JavaScript Handlebars.

data/README.md

@@ -82,6 +82,32 @@ See https://handlebarsjs.com/guide/#custom-helpers.
 
 ### Block Helpers
 
+Block helpers make it possible to define custom iterators and other
+functionality that can invoke the passed block with a new context.
+
+Currently, there is a limitation with the underlying JavaScript engine: it does
+not allow for reentrant calls from within attached Ruby functions: see
+[MiniRacer#225](https://github.com/rubyjs/mini_racer/issues/225). Thus, the
+block function returned to the helper (in `options.fn`) cannot be  invoked.
+
+Thus, for block helpers, a string of JavaScript must define the helper function:
+```ruby
+handlebars = Handlebars::Engine.new
+handlebars.register_helper(map: <<~JS)
+  function(...args) {
+    const ctx = this;
+    const opts = args.pop();
+    const items = args[0];
+    const separator = args[1];
+    const mapped = items.map((item) => opts.fn(item));
+    return mapped.join(separator);
+  }
+JS
+template = handlebars.compile("{{#map items '|'}}'{{this}}'{{/map}}")
+template.call({ items: [1, 2, 3] })
+# => "'1'|2'|'3'"
+```
+
 See https://handlebarsjs.com/guide/#block-helpers.
 
 ### Partials

data/lib/handlebars/engine/version.rb

@@ -2,6 +2,6 @@
 
 module Handlebars
   class Engine
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

data/lib/handlebars/engine.rb

@@ -16,7 +16,10 @@ module Handlebars
     #
     # @param lazy [true, false] immediately loads and initializes the JavaScript
     #   environment.
-    def initialize(lazy: false)
+    # @param path [String, nil] the path to the version of Handlebars to load.
+    #   If `nil`, the contents of `Handlebars::Source.bundled_path` is loaded.
+    def initialize(lazy: false, path: nil)
+      @path = path
       init! unless lazy
     end
 
@@ -60,14 +63,29 @@ module Handlebars
 
     # Registers helpers accessible by any template in the environment.
     #
+    # The function can be either a proc or a string:
+    # * When the function is a proc, it can be either passed in as a normal
+    #   parameter or as a block.
+    # * When the function is a string, it is interpreted as a JavaScript
+    #   function.
+    #
     # @param name [String, Symbol] the name of the helper
+    # @param function [Proc, String] the helper function
     # @yieldparam context [Hash] the current context
     # @yieldparam arguments [Object] the arguments (optional)
     # @yieldparam options [Hash] the options hash (optional)
     # @see https://handlebarsjs.com/api-reference/runtime.html#handlebars-registerhelper-name-helper
-    def register_helper(name, &block)
-      attach(name, &block)
-      call(:registerHelper, [name.to_s, name.to_sym], eval: true)
+    def register_helper(name = nil, function = nil, **helpers, &block)
+      helpers[name] = block || function if name
+      helpers.each do |n, f|
+        case f
+        when Proc
+          attach(n, &f)
+          evaluate("registerHelper('#{n}', #{n})")
+        when String, Symbol
+          evaluate("Handlebars.registerHelper('#{n}', #{f})")
+        end
+      end
     end
 
     # Unregisters a previously registered helper.
@@ -204,21 +222,14 @@ module Handlebars
       return if @init
 
       @context = MiniRacer::Context.new
-      @context.load(::Handlebars::Source.bundled_path)
+      @context.load(@path || ::Handlebars::Source.bundled_path)
       @context.load(File.absolute_path("engine/init.js", __dir__))
 
       @init = true
     end
 
     def js_args(args)
-      args.map { |arg|
-        case arg
-        when Symbol
-          arg
-        else
-          JSON.generate(arg)
-        end
-      }
+      args.map { |arg| JSON.generate(arg) }
     end
   end
 end

data/lib/handlebars-engine.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "handlebars/engine"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handlebars-engine
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Zach Gianos
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-01-27 00:00:00.000000000 Z
+date: 2022-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: handlebars-source
@@ -50,6 +50,7 @@ files:
 - LICENSE
 - README.md
 - exe/handlebars
+- lib/handlebars-engine.rb
 - lib/handlebars/engine.rb
 - lib/handlebars/engine/init.js
 - lib/handlebars/engine/version.rb
@@ -61,7 +62,7 @@ metadata:
   github_repo: https://github.com/gi/handlebars-ruby
   homepage_uri: https://github.com/gi/handlebars-ruby
   source_code_uri: https://github.com/gi/handlebars-ruby
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -76,8 +77,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key:
+rubygems_version: 3.3.3
+signing_key: 
 specification_version: 4
 summary: A simple interface to Handlebars.js for Ruby.
 test_files: []