hyper-react 0.99.6 → 1.0.0.lap21

data/Gemfile

@@ -1,7 +1,4 @@
 source 'https://rubygems.org'
-#gem "opal-jquery", git: "https://github.com/opal/opal-jquery.git", branch: "master"
-gem 'hyper-spec',       path: '../hyper-spec'
-gem 'hyperloop-config', path: '../hyperloop-config'
-gem 'hyper-store',      path: '../hyper-store'
-gem 'hyper-component',  path: '../hyper-component'
+gem "opal-jquery", git: "https://github.com/opal/opal-jquery.git", branch: "master"
+gem "opal-rails", git: "https://github.com/opal/opal-rails.git", branch: "master"
 gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Yi-Cheng Chang (http://github.com/zetachang)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -20,7 +20,8 @@
 <img src="http://ruby-hyperloop.org/images/githubgitterbadge.png">
 </a>
 
-[![Gem Version](https://badge.fury.io/rb/hyper-component.svg)](https://badge.fury.io/rb/hyper-component)
+[![Build Status](https://travis-ci.org/ruby-hyperloop/hyper-react.svg?branch=master)](https://travis-ci.org/ruby-hyperloop/hyper-react)
+[![Gem Version](https://badge.fury.io/rb/hyper-react.svg)](https://badge.fury.io/rb/hyper-react)
 
 <p align="center">
 <img src="http://ruby-hyperloop.org/images/HyperComponents.png" width="100" alt="Hyper-components">
@@ -28,39 +29,11 @@
 
 </div>
 
-## Hyper-Component GEM is part of Hyperloop GEMS family
+## Hyper-React GEM is part of Hyperloop GEMS family
 
-Build interactive Web applications quickly. Hyperloop encourages rapid development with clean, pragmatic design. With developer productivity as our highest goal, Hyperloop takes care of much of the hassle of Web development, so you can focus on innovation and delivering end-user value.
+Hyper-react GEM comes with the Hyperloop GEM. 
 
-One language. One model. One set of tests. The same business logic and domain models running on the clients and the server. Hyperloop is fully integrated with Rails and also gives you unfettered access to the complete universe of JavaScript libraries (including React) from within your Ruby code. Hyperloop lets you build beautiful interactive user interfaces in Ruby.
-
-Everything has a place in our architecture. Components deliver interactive user experiences, Operations encapsulate business logic, Models magically synchronize data between clients and servers, Policies govern authorization and Stores hold local state. 
-
-**Hyper-component** brings Components modules uesed in the Hyperloop interface.
-
-## Getting Started
-
-1. Update your Gemfile:
-        
-```ruby
-#Gemfile
-
-gem 'hyperloop'
-```
-
-2. At the command prompt, update your bundle :
-
-        $ bundle update
-
-3. Run the hyperloop install generator:
-
-        $ rails g hyperloop:install
-
-4. Follow the guidelines to start developing your application. You may find
-   the following resources handy:
-    * [Getting Started with Hyperloop](http://ruby-hyperloop.org/start/components/)
-    * [Hyperloop Guides](http://ruby-hyperloop.org/docs/architecture)
-    * [Hyperloop Tutorial](http://ruby-hyperloop.org/tutorials)
+But if you want to install it separately, please install the [Hyper-component GEM](https://github.com/ruby-hyperloop/hyper-component).
 
 ## Community
 
@@ -74,4 +47,3 @@ Please **do not post** usage questions to GitHub Issues. For these types of ques
 ## License
 
 Hyperloop is released under the [MIT License](http://www.opensource.org/licenses/MIT).
-

data/Rakefile

@@ -1,11 +1,30 @@
-require 'bundler/gem_tasks'
+require 'bundler'
+Bundler.require
+Bundler::GemHelper.install_tasks
+
+# Store the BUNDLE_GEMFILE env, since rake or rspec seems to clean it
+# while invoking task.
+ENV['REAL_BUNDLE_GEMFILE'] = ENV['BUNDLE_GEMFILE']
+
 require 'rspec/core/rake_task'
+require 'opal/rspec/rake_task'
+
+RSpec::Core::RakeTask.new('ruby:rspec')
 
-RSpec::Core::RakeTask.new(:spec)
+task :test do
+  Rake::Task['ruby:rspec'].invoke
+end
+
+require 'generators/reactive_ruby/test_app/test_app_generator'
+desc "Generates a dummy app for testing"
+task :test_app do
+  ReactiveRuby::TestAppGenerator.start
+  puts "Setting up test app database..."
+  system("bundle exec rake db:drop db:create db:migrate > #{File::NULL}")
+end
 
-namespace :spec do
-  task :prepare do
-  end
+task :test_prepare do
+  system("./dciy_prepare.sh")
 end
 
-task default: :spec
+task default: [ :test ]

data/UPGRADING.md

@@ -0,0 +1,24 @@
+## Upgrading to hyper-react from Reactrb
+
+Follow these steps to upgrade:
+
+1. Replace `reactrb` with `hyper-react` both in **Gemfile** and any `require`s in your code.
+2. To include the React.js source, the suggested way is to add `require 'react/react-source'` before `require 'hyper-react'`. This will use the copy of React.js source from `react-rails` gem.
+
+## Upgrading to Reactrb
+
+The original gem `react.rb` was superceeded by `reactive-ruby`, which has had over 15,000 downloads.  This name has now been superceeded by `reactrb` (see #144 for detailed discussion on why.)
+
+Going forward the name `reactrb` will be used consistently as the organization name, the gem name, the domain name, the twitter handle, etc.
+
+The first initial version of `reactrb` is 0.8.x.
+
+It is very unlikely that there will be any more releases of the `reactive-ruby` gem, so users should upgrade to `reactrb`.
+
+There are no syntactic or semantic breaking changes between `reactrb` v 0.8.x and
+previous versions, however the `reactrb` gem does *not* include the react-js source as previous versions did.  This allows you to pick the react js source compatible with other gems and react js components you may be using.
+
+Follow these steps to upgrade:
+
+1. Replace `reactive-ruby` with `reactrb` both in **Gemfile** and any `require`s in your code.
+2. To include the React.js source, the suggested way is to add `require 'react/react-source'` before `require 'reactrb'`. This will use the copy of React.js source from `react-rails` gem.

data/component-name-lookup.md

@@ -0,0 +1,145 @@
+#### Notes on how component names are looked up
+
+Given:
+
+```ruby
+
+class Blat < React::Component::Base
+
+  render do
+    Bar()      
+    Foo::Bar()
+  end
+
+end
+
+class Bar < React::Component::Base
+end
+
+module Foo
+
+  class Bar < React::Component::Base
+
+    render do
+      Blat()
+      Baz()
+    end
+  end
+
+  class Baz < React::Component::Base
+  end
+
+end
+```
+
+The problem is that method lookup is different than constant lookup.  We can prove it by running this code:
+
+```ruby
+def try_it(test, &block)
+  puts "trying #{test}"
+  result = yield
+  puts "success#{': '+result.to_s if result}"
+rescue Exception => e
+  puts "failed: #{e}"
+ensure
+  puts "---------------------------------"
+end
+
+module Boom
+
+  Bar = 12
+
+  def self.Bar
+    puts "   Boom::Bar says hi"
+  end
+
+  class Baz
+    def doit
+      try_it("Bar()") { Bar() }
+      try_it("Boom::Bar()") {Boom::Bar()}
+      try_it("Bar") { Bar }
+      try_it("Boom::Bar") { Boom::Bar }
+    end
+  end
+end
+
+
+
+Boom::Baz.new.doit
+```
+
+which prints:
+
+```text
+trying Bar()
+failed: Bar: undefined method `Bar' for #<Boom::Baz:0x774>
+---------------------------------
+trying Boom::Bar()
+   Boom::Bar says hi
+success
+---------------------------------
+trying Bar
+success: 12
+---------------------------------
+trying Boom::Bar
+success: 12
+---------------------------------
+```
+
+[try-it](http://opalrb.org/try/?code:def%20try_it(test%2C%20%26block)%0A%20%20puts%20%22trying%20%23%7Btest%7D%22%0A%20%20result%20%3D%20yield%0A%20%20puts%20%22success%23%7B%27%3A%20%27%2Bresult.to_s%20if%20result%7D%22%0Arescue%20Exception%20%3D%3E%20e%0A%20%20puts%20%22failed%3A%20%23%7Be%7D%22%0Aensure%0A%20%20puts%20%22---------------------------------%22%0Aend%0A%0Amodule%20Boom%0A%20%20%0A%20%20Bar%20%3D%2012%0A%20%20%0A%20%20def%20self.Bar%0A%20%20%20%20puts%20%22%20%20%20Boom%3A%3ABar%20says%20hi%22%0A%20%20end%0A%0A%20%20class%20Baz%0A%20%20%20%20def%20doit%0A%20%20%20%20%20%20try_it(%22Bar()%22)%20%7B%20Bar()%20%7D%0A%20%20%20%20%20%20try_it(%22Boom%3A%3ABar()%22)%20%7BBoom%3A%3ABar()%7D%0A%20%20%20%20%20%20try_it(%22Bar%22)%20%7B%20Bar%20%7D%0A%20%20%20%20%20%20try_it(%22Boom%3A%3ABar%22)%20%7B%20Boom%3A%3ABar%20%7D%0A%20%20%20%20end%0A%20%20end%0Aend%0A%20%20%0A%0A%0ABoom%3A%3ABaz.new.doit)
+
+
+What we need to do is:
+
+1. when defining a component class `Foo`, also define in the same scope that Foo is being defined a method `self.Foo` that will accept Foo's params and child block, and render it.
+
+2. As long as a name is qualified with at least one scope (i.e. `ModName::Foo()`) everything will work out, but if we say just `Foo()` then the only way I believe out of this is to handle it via method_missing, and let method_missing do a const_get on the method_name (which will return the class) and then render that component.
+
+#### details
+
+To define `self.Foo` in the same scope level as the class `Foo`, we need code like this:
+
+```ruby
+def register_component_dsl_method(component)
+  split_name = component.name && component.name.split('::')
+  return unless split_name && split_name.length > 2
+  component_name = split_name.last
+  parent = split_name.inject([Module]) { |nesting, next_const| nesting + [nesting.last.const_get(next_const)] }[-2]
+  class << parent
+    define_method component_name do |*args, &block|
+      React::RenderingContext.render(name, *args, &block)
+    end
+    define_method "#{component_name}_as_node" do |*args, &block|
+      React::Component.deprecation_warning("..._as_node is deprecated.  Render component and then use the .node method instead")
+      send(component_name, *args, &block).node
+    end
+  end
+end
+
+module React
+  module Component
+    def self.included(base)
+      ...
+      register_component_dsl_method(base.name)
+    end
+  end
+end
+```
+
+The component's method_missing function will look like this:
+
+```ruby
+def method_missing(name, *args, &block)
+  if name =~ /_as_node$/
+    React::Component.deprecation_warning("..._as_node is deprecated.  Render component and then use the .node method instead")
+    method_missing(name.gsub(/_as_node$/,""), *args, &block).node
+  else
+    component = const_get name if defined? name
+    React::RenderingContext.render(nil, component, *args, &block)
+  end
+end
+```
+
+### other related issues
+
+The Kernel#p method conflicts with the <p> tag.   However the p method can be invoked on any object so we are going to go ahead and use it, and deprecate the para method.

data/dciy.toml

@@ -0,0 +1,3 @@
+[dciy.commands]
+prepare = ["./dciy_prepare.sh"]
+cibuild = ["./dciy_run.sh"]

data/dciy_prepare.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+export HYPER_DEV_GEM_SOURCE='https://gems.ruby-hyperloop.org'
+export RAILS_ENV="test"
+bundle update
+cd spec/test_app
+bundle update
+bundle exec rails db:setup
+cd ../..

data/dciy_run.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+export HYPER_DEV_GEM_SOURCE="https://gems.ruby-hyperloop.org"
+export RAILS_ENV="test"
+pwd
+echo
+echo "Running with Chrome headless"
+DRIVER=headless bundle exec rspec
+# echo
+# echo "Running with Firefox headless"
+# DRIVER=beheaded bundle exec rspec

data/hyper-react.gemspec

@@ -1,41 +1,47 @@
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'react/version'
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib/', __FILE__)
+require 'reactive-ruby/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'hyper-react'
   spec.version       = React::VERSION
-  spec.authors       = ['Mitch VanDuyn', 'Jan Biedermann']
+
+  spec.authors       = ['David Chang', 'Adam Jahn', 'Mitch VanDuyn', 'Jan Biedermann']
   spec.email         = ['mitch@catprint.com', 'jan@kursator.com']
-  spec.summary       = 'Write advanced React components in Ruby.'
   spec.homepage      = 'http://ruby-hyperloop.org'
+  spec.summary       = 'Opal Ruby wrapper of React.js library.'
   spec.license       = 'MIT'
+  spec.description   = 'Write React UI components in pure Ruby.'
   # spec.metadata      = {
   #   "homepage_uri" => 'http://ruby-hyperloop.org',
   #   "source_code_uri" => 'https://github.com/ruby-hyperloop/hyper-component'
   # }
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec)/}) }
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.files         = `git ls-files`.split("\n").reject { |f| f.match(%r{^(gemfiles|spec)/}) }
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'actionview', '>= 4.0.0'
+  spec.add_dependency 'hyper-store', React::VERSION
+  spec.add_dependency 'opal', '>= 0.11.0', '< 0.12.0'
+  spec.add_dependency 'opal-activesupport', '~> 0.3.1'
 
-  spec.add_dependency 'hyper-component', React::VERSION
-  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'chromedriver-helper'
   spec.add_development_dependency 'hyper-spec', React::VERSION
+  spec.add_development_dependency 'jquery-rails'
   spec.add_development_dependency 'listen'
-  spec.add_development_dependency 'mini_racer', '~> 0.2.4'
-  spec.add_development_dependency 'opal', '>= 0.11.0', '< 0.12.0'
-  spec.add_development_dependency 'opal-browser', '~> 0.2.0'
-  spec.add_development_dependency 'opal-rails', '~> 0.9.4'
-  spec.add_development_dependency 'puma'
+  spec.add_development_dependency 'mime-types'
+  spec.add_development_dependency 'nokogiri'
+  spec.add_development_dependency 'opal-jquery'
+  spec.add_development_dependency 'opal-rails', '~> 0.9.3'
+  spec.add_development_dependency 'opal-rspec'
   spec.add_development_dependency 'rails', '>= 4.0.0'
+  spec.add_development_dependency 'rails-controller-testing'
   spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec', '~> 3.7.0'
-  spec.add_development_dependency 'rspec-steps', '~> 2.1.1'
+  spec.add_development_dependency 'react-rails', '>= 2.4.0', '< 2.5.0'
+  spec.add_development_dependency 'rspec-rails'
   spec.add_development_dependency 'rubocop', '~> 0.51.0'
   spec.add_development_dependency 'sqlite3'
+  spec.add_development_dependency 'mini_racer', '~> 0.1.15'
+  spec.add_development_dependency 'timecop', '~> 0.8.1'
 end

data/lib/generators/reactive_ruby/test_app/templates/assets/javascripts/components.rb

@@ -0,0 +1,3 @@
+require 'opal'
+require 'hyper-react'
+require_tree './components'

data/lib/generators/reactive_ruby/test_app/templates/assets/javascripts/server_rendering.js

@@ -0,0 +1,5 @@
+//= require 'react-server'
+//= require 'react_ujs'
+//= require 'components'
+
+Opal.load('components')

data/lib/generators/reactive_ruby/test_app/templates/assets/javascripts/test_application.rb

@@ -0,0 +1,2 @@
+require 'components'
+require 'react_ujs'

data/lib/generators/reactive_ruby/test_app/templates/boot.rb.erb

@@ -0,0 +1,6 @@
+require 'rubygems'
+gemfile = File.expand_path("<%= gemfile_path %>", __FILE__)
+
+ENV['BUNDLE_GEMFILE'] = gemfile
+require 'bundler'
+Bundler.setup

data/lib/generators/reactive_ruby/test_app/templates/script/rails

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/lib/generators/reactive_ruby/test_app/templates/test_application.rb.erb

@@ -0,0 +1,13 @@
+<% if defined? application_definition %>
+require 'rails/all'
+require File.expand_path('../boot', __FILE__)
+
+# Require the gems listed in Gemfile, including any gems
+# you've limited to :test, :development, or :production.
+Bundler.require(*Rails.groups(assets: %w(development test)))
+
+require 'opal-rails'
+require 'hyper-react'
+
+<%= application_definition %>
+<% end %>

data/lib/generators/reactive_ruby/test_app/templates/views/components/hello_world.rb

@@ -0,0 +1,11 @@
+module Components
+  class HelloWorld
+    include React::Component
+
+    def render
+      div do
+        "Hello, World!".span
+      end
+    end
+  end
+end