consul-templaterb 1.10.1 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d992cca0fe8acc08d28b9d284f033caf1f84804a3a0597474d6a915aaeb9b1b
-  data.tar.gz: b9ca91c0a8ad433926232cd85103829cdb4e285e343e1801497828014930d827
+  metadata.gz: c208ffa413a78bdf642df954fa20acb422a6f46a0b10728eb6df0c16602071a5
+  data.tar.gz: d92d158795b0d0f641e0cb10e05b8dc66672a68ef420d1d527faee134de0a271
 SHA512:
-  metadata.gz: 5a1866f696551f174f146172633f9613b133a4caf9aa797670d8e6ace14e06e0bf7647f194881db57cb5e6f4e5918a3e7d78bf2ab2524d93aeffc5bb13c69322
-  data.tar.gz: 46e23baa70aefeb927cd60965708206818844a130ba9dc4f4214a850583a6be67f3969bfdbd2720abd330d321400a4a129d0f4049a0e49d9ddd80ee134743d24
+  metadata.gz: 8c46f0b64d5b427c08e0c3aa77ff6174b1dbc26deed18161c7b1108df42ec27ac83ebeb365e50800a8f11c9ebba1586f16ef947c6e20d50fc7e4427781289750
+  data.tar.gz: e6e500eb043d6a5627a22207f94992dfcf13d63f5604418b7f53854ad1557bf49aaafd05a0ca7f500e5e23430d5c88f2a983da2afd75287409fcbac549f4d4ff

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## (UNRELEASED)
 
+## 1.11.0 (March 16, 2019)
+
+NEW FEATURES:
+
+* Added new function render_from_string() to render a template from a string (useful with KV)
+
 ## 1.10.1 (February 28, 2019)
 
 BUGFIX:

data/TemplateAPI.md

@@ -295,6 +295,24 @@ Example:
 Will render header.html.erb with parameter title = 'My Title'. `title` can then be accessed within
 the template using `param('title', 'My default Value')` in the `header.html.erb` file.
 
+## render_from_string(template_to_render, [params={}])
+
+Similar to render_file but from a string.
+Allows to render a template from a string. Useful if you have your templates in KV for instance.
+
+Example:
+
+Given the value in Consul's KV `my/template/to_render`: `from KV: <%= 5 * 2 %>`
+
+```erb
+<%= render_from_string(kv('my/template/to_render').get_value_decoded) %>
+```
+
+Would render the value: `from KV: 10`.
+
+That's very usefull if you want to centralize your templates and being able to change the value
+with a simple PUT call in the KV.
+
 ## param(parameter_name, [default_value: nil])
 
 Can be used within a template to access a parameter. Parameters can be specified with `render_file`

data/lib/consul/async/consul_template.rb

@@ -3,6 +3,8 @@ require 'em-http'
 require 'thread'
 require 'forwardable'
 require 'erb'
+require 'digest'
+
 module Consul
   module Async
     class InvalidTemplateException < StandardError
@@ -169,6 +171,14 @@ module Consul
         render(File.read(new_path), new_path, params, current_template_info: template_info)
       end
 
+      # render a sub template from a string template
+      def render_from_string(template_content, params = {})
+        return unless template_content
+        sha1res = Digest::SHA1.hexdigest(template_content)
+        new_path = File.expand_path(":memory:sha1:#{sha1res}", File.dirname(@context[:current_erb_path]))
+        render(template_content, new_path, params, current_template_info: template_info)
+      end
+
       def find_line(e)
         return e.message.dup[5..-1] if e.message.start_with? '(erb):'
         e.backtrace.each do |line|

data/lib/consul/async/version.rb

@@ -1,5 +1,5 @@
 module Consul
   module Async
-    VERSION = '1.10.1'.freeze
+    VERSION = '1.11.0'.freeze
   end
 end

data/samples/render_template_from_kv.erb

@@ -0,0 +1,7 @@
+<%
+# This template render a template contained into Consul's KV
+# Usage: kv_path=my/path/to_template_in_kv consul-templaterb samples/render_template_from_kv.erb
+
+kv_path = param('kv_path') || ENV['kv_path']
+template_content = kv(kv_path).get_value_decoded if kv_path
+%><%= render_from_string(template_content) %>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: consul-templaterb
 version: !ruby/object:Gem::Version
-  version: 1.10.1
+  version: 1.11.0
 platform: ruby
 authors:
 - SRE Core Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-28 00:00:00.000000000 Z
+date: 2019-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request
@@ -211,6 +211,7 @@ files:
 - samples/keys.html.erb
 - samples/metrics.erb
 - samples/nodes.html.erb
+- samples/render_template_from_kv.erb
 - samples/sample_keys.html.erb
 - samples/service_checks_metrics.erb
 - samples/services.html.erb