reactive-ruby 0.7.4 → 0.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e6e7e4fc40600191b0985643a430eca77bbc7816
-  data.tar.gz: 35c09c919ba8ceaabd2165960fcc963a4f2c57c1
+  metadata.gz: 5aafd11f2c53f8653e3572bd568320daace5f4a6
+  data.tar.gz: 9c7142108c3ba5289d2a5f08dd4d7eb5f4db3d15
 SHA512:
-  metadata.gz: 6cc80309ecd3a8115eeef622a7f61e96188fc2e52e3e3b03ba6c5b6d672ccdd2588db5100894fb4763dd38e74f31737d76ff586337d7c65db0c2f92b63f2d7a2
-  data.tar.gz: b1321b290e26ca408b04143d0a3f29e4e0d5efd33b119224eeb9c2bdffc5d05410652cdd9e3cec0b4643faf08d6a6a0f1b957091d619d5bc63f4cd0ef2a94d83
+  metadata.gz: 2122b457f0f408e113d449ca0170f31c75ed3bf9725a5593f1fb7937c6fab9e4d8a14e23907ac1cb1596288b3e0139464f9e13bc429c22446accbd74018ffbb8
+  data.tar.gz: ee2c90bfd899ca3455216a8f777db05f31fc3053910a5458bfbaafa15d52bdec02b217352eeacc6b6acc066c127c6499777debbe572aa2399b6d5eeb9b9fb4ae

data/Gemfile.lock

@@ -0,0 +1,101 @@
+PATH
+  remote: .
+  specs:
+    reactive-ruby (0.7.5)
+      jquery-rails
+      opal
+      opal-activesupport
+      opal-browser
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (4.2.3)
+      actionview (= 4.2.3)
+      activesupport (= 4.2.3)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.3)
+      activesupport (= 4.2.3)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activesupport (4.2.3)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    builder (3.2.2)
+    erubis (2.7.0)
+    hike (1.2.3)
+    i18n (0.7.0)
+    jquery-rails (4.0.4)
+      rails-dom-testing (~> 1.0)
+      railties (>= 4.2.0)
+      thor (>= 0.14, < 2.0)
+    json (1.8.3)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mini_portile (0.6.2)
+    minitest (5.8.0)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    opal (0.8.0)
+      hike (~> 1.2)
+      sourcemap (~> 0.1.0)
+      sprockets (~> 3.1)
+      tilt (>= 1.4)
+    opal-activesupport (0.1.0)
+      opal (>= 0.5.0, < 1.0.0)
+    opal-browser (0.2.0)
+      opal
+      paggio
+    opal-rspec (0.4.3)
+      opal (>= 0.7.0, < 0.9)
+    paggio (0.2.4)
+    rack (1.6.4)
+    rack-protection (1.5.3)
+      rack
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.7)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.2)
+      loofah (~> 2.0)
+    railties (4.2.3)
+      actionpack (= 4.2.3)
+      activesupport (= 4.2.3)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.4.2)
+    sinatra (1.4.6)
+      rack (~> 1.4)
+      rack-protection (~> 1.4)
+      tilt (>= 1.3, < 3)
+    sourcemap (0.1.1)
+    sprockets (3.3.3)
+      rack (~> 1.0)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tilt (2.0.1)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  opal-rspec
+  reactive-ruby!
+  sinatra
+
+BUNDLED WITH
+   1.10.6

data/README.md

@@ -4,11 +4,13 @@
 
 It lets you write reactive UI components, with Ruby's elegance using the tried and true React.js engine. :heart:
 
-This fork of the original react.rb gem is a work in progress.  Currently it is being used in a large rails app, so until a better guide can be written we will just assume you will use it a rails app too.  However the gem itself has no dependency on rails, and there are people using the gem in other environments.
+This fork of the original react.rb gem is a work in progress.  Currently it is being used in a large rails app.  However the gem itself has no dependency on rails, and there are people using the gem in other environments.
 
 ## Quick Overview
 
-A react app is built from one or more trees of components.  A react component can live side by side with other non-react html. A react component is just like a rails view or a partial.  Reactive-Ruby takes advantage of this by letting you add Reactive-Ruby components as views, and call them directly from your controller like any other view.
+A react app is built from one or more trees of components.  React components can live side by side with other non-react html and javascript. A react component is just like a rails view or a partial.  Reactive-Ruby takes advantage of these features by letting you add Reactive-Ruby components as views, and call them directly from your controller like any other view.
+
+By design Reactive-Ruby allows reactive components  to be easily added to existing Rails projects, as well in new development. 
 
 Components are first rendered to HTML on the server (called pre-rendering) this is no different from what happens when your ERB or HAML templates are translated to HTML.  
 
@@ -16,10 +18,7 @@ A copy of the react engine, and your components follows the rendered HTML to the
 
 The beauty is you now have one markup description, written in the same language as your server code, that works both as the HTML template and as an interactive component.
 
-By design Reactive-Ruby allows reactive components  to be easily added to existing Rails projects, as well in new development. 
-
-
-## Installation and setup
+## Installation and Setup with Rails
 
 In your gem file:
 
@@ -50,14 +49,19 @@ Then your `assets/javascript/application.rb` file looks like this:
 
 ```
 #assets/javascript/application.rb
+
 # only put files that are browser side only.
 
 require 'components'  # this pulls in your components from the components.rb manifest file  
-require 'jquery'      # you need both these files to access jQuery from Opal
-require 'opal-jquery' # they must be in this order, and after the components require
-require 'browser'     # opal access to browser specific methods (such as setTimer)
-require 'react_ujs'   # this is required and is part of the prerendering system     
-# whatever else you might need here
+require 'react_ujs'   # this is required on the client side only and is part of the prerendering system
+
+# require any thing else that is browser side only, typically  these 4 are all you need.  If you
+# have client only sections of code that that do not contain requires wrap them in 
+# if React::IsomorphicHelpers.on_opal_client? blocks.  
+
+require 'jquery'           # you need both these files to access jQuery from Opal
+require 'opal-jquery'      # they must be in this order, and after the components require
+require 'browser/interval' # for #every, and #after methods
 ```
 
 Okay that is your setup.
@@ -102,6 +106,10 @@ Open up the js console in the browser and you will see a log showing what went o
 
 Have a look at the sources in the console, and notice your ruby code is there, and you can set break points etc.
 
+## Integration with Sinatra
+
+See the sinatra-tutorial folder
+
 ## Typical Problems
 
 `Uncaught TypeError: Cannot read property 'toUpperCase' of undefined`  This means the thing you are trying to render is not actually a react component.  Often is because the top level component name is wrong.  For example if you are in controller Foo and the method is `bar`, but you have named the component Foo::Bars then you would see this message.

data/example/{tutorial → rails-tutorial}/Gemfile.lock

@@ -13,11 +13,11 @@ GIT
 PATH
   remote: ../..
   specs:
-    reactive-ruby (0.7.3)
+    reactive-ruby (0.7.5)
+      jquery-rails
       opal
       opal-activesupport
       opal-browser
-      opal-jquery
 
 GEM
   remote: https://rubygems.org/

data/example/rails-tutorial/app/assets/javascripts/application.rb

@@ -0,0 +1,15 @@
+#assets/javascript/application.rb
+
+# only put files that are browser side only.
+
+require 'components'  # this pulls in your components from the components.rb manifest file  
+require 'react_ujs'   # this is required on the client side only and is part of the prerendering system
+
+# require any thing else that is browser side only, typically  these 4 are all you need.  If you
+# have client only sections of code that that do not contain requires wrap them in 
+# if React::IsomorphicHelpers.on_opal_client? blocks.  
+
+require 'jquery'           # you need both these files to access jQuery from Opal
+require 'opal-jquery'      # they must be in this order, and after the components require
+require 'browser/interval' # for #every, and #after methods
+

data/example/sinatra-tutorial/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'reactive-ruby', :path => '../..'
+gem 'sinatra'
+gem 'opal-jquery'

data/example/sinatra-tutorial/Gemfile.lock

@@ -0,0 +1,101 @@
+PATH
+  remote: ../..
+  specs:
+    reactive-ruby (0.7.4)
+      jquery-rails
+      opal
+      opal-activesupport
+      opal-browser
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (4.2.3)
+      actionview (= 4.2.3)
+      activesupport (= 4.2.3)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.3)
+      activesupport (= 4.2.3)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activesupport (4.2.3)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    builder (3.2.2)
+    erubis (2.7.0)
+    hike (1.2.3)
+    i18n (0.7.0)
+    jquery-rails (4.0.4)
+      rails-dom-testing (~> 1.0)
+      railties (>= 4.2.0)
+      thor (>= 0.14, < 2.0)
+    json (1.8.3)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mini_portile (0.6.2)
+    minitest (5.8.0)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    opal (0.8.0)
+      hike (~> 1.2)
+      sourcemap (~> 0.1.0)
+      sprockets (~> 3.1)
+      tilt (>= 1.4)
+    opal-activesupport (0.1.0)
+      opal (>= 0.5.0, < 1.0.0)
+    opal-browser (0.2.0)
+      opal
+      paggio
+    opal-jquery (0.4.0)
+      opal (>= 0.7.0, < 0.9.0)
+    paggio (0.2.4)
+    rack (1.6.4)
+    rack-protection (1.5.3)
+      rack
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.7)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.2)
+      loofah (~> 2.0)
+    railties (4.2.3)
+      actionpack (= 4.2.3)
+      activesupport (= 4.2.3)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.4.2)
+    sinatra (1.4.6)
+      rack (~> 1.4)
+      rack-protection (~> 1.4)
+      tilt (>= 1.3, < 3)
+    sourcemap (0.1.1)
+    sprockets (3.3.3)
+      rack (~> 1.0)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tilt (2.0.1)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  opal-jquery
+  reactive-ruby!
+  sinatra
+
+BUNDLED WITH
+   1.10.6

data/example/sinatra-tutorial/_comments.json

@@ -0,0 +1,38 @@
+[
+    {
+        "author": "Pete Hunt",
+        "text": "Hey there!"
+    },
+    {
+        "author": "Mitch",
+        "text": "i ***am*** saying something!"
+    },
+    {
+        "author": "Jan",
+        "text": "well what are you saying *dear*"
+    },
+    {
+        "author": "Mitch",
+        "text": "I am saying something"
+    },
+    {
+        "author": "Mitch",
+        "text": "I did say something"
+    },
+    {
+        "author": "Mitch",
+        "text": "said make a brandy Alexander"
+    },
+    {
+        "author": "Jan",
+        "text": "No **I Said** make the alexander!  - You make it"
+    },
+    {
+        "author": "Cool Fred",
+        "text": "Just do it!"
+    },
+    {
+        "author": "foo",
+        "text": "to you"
+    }
+]