js_render 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 931cdb27a1564cea7a6719b853ae02809767e3e1
-  data.tar.gz: 9c312aa181cc85b811fb42d1e5413c08031fe8c8
+  metadata.gz: 3537448b722ff236b75da2d4f60f5c69fbfa6290
+  data.tar.gz: 177de4414b1c645c485fbc6ef1b3bebe5b4a968f
 SHA512:
-  metadata.gz: d0130b87cc4372619a790c24a53ba05905208a53e6faaa684e2e5b5828579064b8152176b08cd1e1c6ab791c52e6a1b968cd93e3b9cb660c6d1d774c97fbf2f2
-  data.tar.gz: 9d902e9d87c9a78fd2d834b572ed17f49b5c96024878af06aa36344d4b2b45189f58b18d23db93483a7fd68690ec0a4dbecd07b1bbbe92d69fa00a67269e4d0c
+  metadata.gz: 97646f57c0c1428117e0ca0d2bb849f0cf04d6c5cdff34a3fd0f03cdb225f3668ff528b309b7ede336ec335493a7c377e61f46f6f2f651acac2ca89a5f6f14b3
+  data.tar.gz: 6869b116f9fdeb9842164f57727ad5878752f67da1e90976e7ca76c85e669c54f67dea3430b304d8c5231d13c3f699c8d50ff2c0aca478f49e2fe3ddb943f312

data/README.md

@@ -3,8 +3,6 @@
 
 # JsRender
 
-**Disclaimer: This is currently a "work in progress". More functionality, improvements, and docs are coming. That said everything does work, but the API might change in the near future. Check out the docs below as well as the [`examples`](./examples).**
-
 JsRender is an unopinionated Ruby library for rendering JavaScript "components" on the server side. This approach works with [React](https://facebook.github.io/react/), [Angular](ihttps://angular.io/), [Ember](http://emberjs.com/), or any other library of your choice. The only requirement is that there is a JavaScript function that returns HTML for the component or view such that it can be properly rendered on the server side (e.g. [`ReactDOMServer.renderToString`](https://facebook.github.io/react/docs/top-level-api.html#reactdomserver.rendertostring) in React).
 
 The library works in two essential parts:
@@ -152,6 +150,12 @@ Methods you can override if you subclass `JsRender::AssetFinder::Base`:
 
 > Defaults to `nil`
 
+** should_server_render **
+
+This config option is a boolean that specifies if the server render function and associated JS should be executed and run. When it is false, it only returns the span with the unique ID that the client side render function relies upon. This is meant for development purposes and enables things like console logging etc. that would normally cause errors in the `ExecJS` runtime.
+
+> Defaults to `true`
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/js_render/configuration.rb

@@ -22,7 +22,8 @@ module JsRender
                   :server_render_function,
                   :client_render_function,
                   :use_asset_pipeline,
-                  :asset_finder_class
+                  :asset_finder_class,
+                  :should_server_render
 
     def initialize
       @base_path = 'app/assets/javascripts'
@@ -32,6 +33,7 @@ module JsRender
       @client_render_function = 'window.render*Client'
       @use_asset_pipeline = false
       @asset_finder_class = nil
+      @should_server_render = true
     end
   end
 end

data/lib/js_render/renderer.rb

@@ -26,6 +26,8 @@ module JsRender
     end
 
     def generate_html
+      return "<span id=\"#{@uuid}\"></span>" unless JsRender.config.should_server_render
+
       func_name = JsRender.config.server_render_function.gsub('*', @component_name)
       server_code = <<-JS
         (function () {

data/lib/js_render/version.rb

@@ -1,3 +1,3 @@
 module JsRender
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: js_render
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jonathan Lehman
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-05-23 00:00:00.000000000 Z
+date: 2016-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler