hyper-spec 1.0.alpha1.5 → 1.0.0.lap28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c17257af4d7b13916648e6ba8a495f1ca0b2f5a300e8ea96e7490c47cd696691
-  data.tar.gz: 6a823c91fd6d46c1c086296316af229b993761bee436e4b3940371b0ae4ecd03
+  metadata.gz: 1b567b6e5e1eb4555bcf41ada038f247a2f83c346be6d21593f9777f9b73dfb8
+  data.tar.gz: c1691e64e39fad1442c94782f6e3094460b635bce026767b3ece63d757d0a24d
 SHA512:
-  metadata.gz: b7eb46d260a9025424755c1248500f8ab7b79956385149507b7518a40d1e38848dfdfac9eb19fd8661b6022d37aa6d627d21483e90251d52044cadad07b5533a
-  data.tar.gz: 20b3e256b12ad4c3ef08b0ac371b2bb8ce3b6dc4a7498e4a249e15e32243f339780eaaabf5e952c6c5b64180846bf2eea71a93c98d6ea599c1f64b447d0da1c0
+  metadata.gz: eeaa28e71f46802e74d4d2ecaf6405f8a9518e030d371c7397ede62976c66fe309be3a8f3a5b1434c5e56765ad73117e9660618bcc158830d9eb485a7fc157ea
+  data.tar.gz: 93fb42f8f0212cd415dddfd17e7d7ee235f1c2fb470edb1957bd8d8c4bf3b04a50f7290c450374fd5edd5c915a3e16848b314e79df13f4945d1a44801c3256a3

data/.gitignore

@@ -13,6 +13,7 @@ capybara-*.html
 **.orig
 rerun.txt
 pickle-email-*.html
+Gemfile.lock
 
 # TODO Comment out these rules if you are OK with secrets being uploaded to the repo
 config/initializers/secret_token.rb
@@ -52,7 +53,3 @@ bower.json
 
 # ignore Idea files
 .idea
-
-# ignore Gemfile.locks https://yehudakatz.com/2010/12/16/clarifying-the-roles-of-the-gemspec-and-gemfile/
-/spec/test_app/Gemfile.lock
-/Gemfile.lock

data/.rubocop.yml

@@ -0,0 +1,107 @@
+Style/BlockDelimiters:
+  EnforcedStyle: line_count_based
+  SupportedStyles:
+    # The `line_count_based` style enforces braces around single line blocks and
+    # do..end around multi-line blocks.
+    - line_count_based
+    # The `semantic` style enforces braces around functional blocks, where the
+    # primary purpose of the block is to return a value and do..end for
+    # procedural blocks, where the primary purpose of the block is its
+    # side-effects.
+    #
+    # This looks at the usage of a block's method to determine its type (e.g. is
+    # the result of a `map` assigned to a variable or passed to another
+    # method) but exceptions are permitted in the `ProceduralMethods`,
+    # `FunctionalMethods` and `IgnoredMethods` sections below.
+    - semantic
+    # The `braces_for_chaining` style enforces braces around single line blocks
+    # and do..end around multi-line blocks, except for multi-line blocks whose
+    # return value is being chained with another method (in which case braces
+    # are enforced).
+    - braces_for_chaining
+  ProceduralMethods:
+    # Methods that are known to be procedural in nature but look functional from
+    # their usage, e.g.
+    #
+    #   time = Benchmark.realtime do
+    #     foo.bar
+    #   end
+    #
+    # Here, the return value of the block is discarded but the return value of
+    # `Benchmark.realtime` is used.
+    - benchmark
+    - bm
+    - bmbm
+    - create
+    - each_with_object
+    - measure
+    - new
+    - realtime
+    - tap
+    - with_object
+  FunctionalMethods:
+    # Methods that are known to be functional in nature but look procedural from
+    # their usage, e.g.
+    #
+    #   let(:foo) { Foo.new }
+    #
+    # Here, the return value of `Foo.new` is used to define a `foo` helper but
+    # doesn't appear to be used from the return value of `let`.
+    - let
+    - let!
+    - subject
+    - watch
+  IgnoredMethods:
+    # Methods that can be either procedural or functional and cannot be
+    # categorised from their usage alone, e.g.
+    #
+    #   foo = lambda do |x|
+    #     puts "Hello, #{x}"
+    #   end
+    #
+    #   foo = lambda do |x|
+    #     x * 100
+    #   end
+    #
+    # Here, it is impossible to tell from the return value of `lambda` whether
+    # the inner block's return value is significant.
+    - lambda
+    - proc
+    - it
+
+Style/Documentation:
+  Description: 'Document classes and non-namespace modules.'
+  Enabled: false
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+
+# Multi-line method chaining should be done with trailing dots.
+Style/DotPosition:
+  EnforcedStyle: leading
+  SupportedStyles:
+    - leading
+    - trailing
+
+Style/FrozenStringLiteralComment:
+  Description: >-
+                 Add the frozen_string_literal comment to the top of files
+                 to help transition from Ruby 2.3.0 to Ruby 3.0.
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Description: 'Avoid multi-line chains of blocks.'
+  StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#single-line-blocks'
+  Enabled: false
+
+Style/MutableConstant:
+  Description: 'Do not assign mutable objects to constants.'
+  Enabled: false
+
+Metrics/AbcSize:
+  # The ABC size is a calculated magnitude, so this number can be a Fixnum or
+  # a Float.
+  Max: 20
+
+Metrics/LineLength:
+  Max: 100

data/.travis.yml

@@ -1,26 +1,21 @@
-dist: trusty
 language: ruby
-cache: bundler
 rvm:
-  - 2.4.4
-  - 2.5.1
-  - ruby-head
+  - ruby
 env:
-  - DRIVER=google-chrome TZ=Europe/Berlin
-matrix:
-  fast_finish: true
-  allow_failures:
-    - rvm: ruby-head
+  - DRIVER=travis HYPER_DEV_GEM_SOURCE="https://gems.ruby-hyperloop.org" TZ=Europe/Berlin
 before_install:
-  - if [[ "$DRIVER" == "google-chrome" ]]; then wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then echo "deb http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then sudo apt-get update -qq && sudo apt-get install -qq -y google-chrome-stable; fi
+  - sudo apt-get install -y fonts-liberation
+  - wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+  - sudo dpkg -i google-chrome*.deb
   - gem install bundler
 before_script:
-  - bundle install --jobs=3 --retry=3
-  - if [[ "$DRIVER" == "google-chrome" ]]; then bundle exec chromedriver-update; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then ls -lR ~/.chromedriver-helper/; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then bundle exec chromedriver --version; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then google-chrome --version; fi
-  - if [[ "$DRIVER" == "google-chrome" ]]; then which google-chrome; fi
-script: bundle exec rspec
+  - cd spec/test_app
+  - bundle update
+  - cd ../../
+  - chromedriver-update
+  - ls -lR ~/.chromedriver-helper/
+script:
+  - bundle exec rake spec
+gemfile:
+  - gemfiles/opal_0_11_react-rails_2_4.gemfile
+

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at mitch@catprint.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -1,7 +1,3 @@
 source 'https://rubygems.org'
-gem 'hyper-component',   path: '../hyper-component'
-gem 'hyper-store',       path: '../hyper-store'
-gem 'hyper-state',       path: '../hyper-state'
-gem 'hyperstack-config', path: '../hyperstack-config'
-#gem 'unparser', path: '../../../unparser'
+gem "opal-jquery", git: "https://github.com/opal/opal-jquery.git", branch: "master"
 gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 catmando
+
+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

@@ -0,0 +1,380 @@
+# HyperSpec
+
+[![Build Status](https://travis-ci.org/ruby-hyperloop/hyper-spec.svg?branch=master)](https://travis-ci.org/ruby-hyperloop/hyper-spec)
+
+With HyperSpec you can run *isomorphic* specs for all your Hyperloop code using RSpec.  Everything runs as standard RSpec test specs.  
+
+For example if you have a component like this:
+
+```ruby
+class SayHello < React::Component::Base
+  param :name
+  render(DIV) do
+    "Hello there #{params.name}"
+  end
+end
+```
+
+Your test spec would look like this:
+
+```ruby
+describe 'SayHello', js: true do
+  it 'has the correct content' do
+    mount "SayHello", name: 'Fred'
+    expect(page).to have_content('Hello there Fred')
+  end
+end
+```
+
+The `mount` method will setup a blank client window, and *mount* the named component in the window, passing any parameters.
+
+Notice that the spec will need a client environment so we must set `js: true`.
+
+The `mount` method can also take a block which will be recompiled and set to the client before mounting the component.  You can place any client side code in the mount block including the definition of components.
+
+```ruby
+describe "the mount's code block", js: true do
+  it 'will be recompiled on the client' do
+    mount 'ShowOff' do
+      class ShowOff < React::Component::Base
+        render(DIV) { 'Now how cool is that???' }
+      end
+    end
+    expect(page).to have_content('Now how cool is that???' )
+  end
+end
+```
+
+## Why?
+
+Hyperloop wants to make the server-client divide as transparent to the developer as practical.  Given this, it makes sense that the testing should also be done with as little concern for client versus server.  
+
+HyperSpec allows you to directly use tools like FactoryBot (or Hyperloop Operations) to setup some test data, then run a spec to make sure that a component correctly displays, or modifies that data.  You can use Timecop to manipulate time and keep in sync between the server and client.  This makes testing easier and more realistic without writing a lot of redundant code.
+
+
+## Installation
+
+Add this line to your application's Gemfile in the test section:
+
+```ruby
+gem 'hyper-spec'
+```
+
+Execute:
+
+    $ bundle install
+
+and then in your spec_helper.rb file
+
+```ruby
+require 'hyper-spec'
+```
+
+You will also need to install selenium, poltergeist and firefox version **46.0.1** (ff latest still does not play well with selenium).
+
+Sadly at this time the selenium chrome driver does not play nicely with Opal, so you can't use Chrome.  We are working on getting rid of the whole selenium business.  Stay tuned.
+
+## Environment Variables
+
+You can set `DRIVER` to `ff` to run the client in Firefox and see what is going on.  By default tests will run in poltergeist which is quicker, but harder to debug problems.
+
+```
+DRIVER=ff bundle exec rspec
+```
+
+## Spec Helpers
+
+HyperSpec adds the following spec helpers to your test environment
+
++ `mount`
++ `client_option` and `client_options`
++ `on_client`
++ `isomorphic`
++ `evaluate_ruby`
++ `expect_evaluate_ruby`
++ `expect_promise`
++ call back and event history methods
++ `pause`
++ `attributes_on_client`
++ `size_window`
++ `add_class`
+
+#### The `mount` Method
+
+`mount` takes the name of a component, prepares an empty test window, and mounts the named component in the window.  
+You may give a block to `mount` which will be recompiled on the client, and run *before* mounting.  This means that the component
+mounted may be actually defined in the block, which is useful for setting up top level wrapper components, which will invoke your component under test.  You can also modify existing components for white box testing, or local fixture data, constants, etc.
+
+`mount` may also be given a hash of the parameters to be passed to the component.
+
+```ruby
+mount 'Display', test: 123 do
+  class Display < React::Component::Base
+    param :test
+    render(DIV) { params.test.to_s }
+  end
+end
+```
+
+#### The `client_option` Method
+
+There are several options that control the mounting process.  Use `client_option` (or `client_options`) before accessing any client side to set any of these options:
+
++ `render_on`: `:server_only`, `:client_only`, or `:both`, default is client_only.
++ `layout`: specify the layout to be used.  Default is :none.
++ `style_sheet`: specify the name of the style sheet to be loaded. Defaults to the application stylesheet.
++ `javascript`: specify the name of the javascript asset file to be loaded. Defaults to the application js file.
+
+For example:
+
+```ruby
+it "can be rendered server side only" do
+  client_option render_on: :server_only
+  mount 'SayHello', name: 'George'
+  expect(page).to have_content('Hello there George')
+  # Server only means no code is downloaded to the client
+  expect(evaluate_script('typeof React')).to eq('undefined')
+end
+```
+
+If you need to pull in alternative style sheets and javascript files, the recommended way to do this is to
+
+1. Add them to a `specs/assets/stylesheets` and `specs/assets/javascripts` directory and
+2. Add the following line to your `config/environment/test.rb` file:  
+  ```ruby
+    config.assets.paths << ::Rails.root.join('spec', 'assets', 'stylesheets').to_s
+    config.assets.paths << ::Rails.root.join('spec', 'assets', 'javascripts').to_s
+  ```
+
+This way you will not pollute your application with these 'test only' files.
+
+*The javascript spec asset files can be `.rb` files and contain ruby code as well.  See the specs for examples!*
+
+#### The `on_client` Method
+
+`on_client` takes a block and compiles and runs it on the client.  This is useful in setting up test constants and client only fixtures.
+
+Note that `on_client` needs to *proceed* any calls to `mount`, `evaluate_ruby`, `expect_evaluate_ruby` or `expect_promise` as these methods will initiate the client load process.
+
+#### The `isomorphic` Method
+
+Similar to `on_client` but the block is *also* run on the server.  This is useful for setting constants shared by both client and server, and modifying behavior of isomorphic classes such as ActiveRecord models, and HyperOperations.
+
+```ruby
+isomorphic do
+  class SomeModel < ActiveRecord::Base
+    def fake_attribute
+      12
+    end
+  end
+end
+```
+
+#### The `evaluate_ruby` Method
+
+Takes either a string or a block, dynamically compiles it, downloads it to the client and runs it.
+
+```ruby
+evaluate_ruby do
+  i = 12
+  i * 2
+end
+# returns 24
+
+isomorphic do
+  def factorial(n)
+    n == 1 ? 1 : n * factorial(n-1)
+  end
+end
+
+expect(evaluate_ruby("factorial(5)")).to eq(factorial(5))
+```
+
+`evaluate_ruby` can also be very useful for debug.  Set a breakpoint in your test, then use `evaluate_ruby` to interrogate the state of the client.
+
+#### The `expect_evaluate_ruby` Method
+
+Combines expect and evaluate methods:
+
+```ruby
+expect_evaluate_ruby do
+  i = 1
+  5.times { |n| i = i*n }
+  i
+end.to eq(120)
+```
+
+#### The `expect_promise` Method
+
+Works like `expect_evaluate_ruby` but is used with promises.  `expect_promise` will hang until the promise resolves and then return to the results.
+
+```ruby
+expect_promise do
+  Promise.new.tap do |p|
+    after(2) { p.resolve('hello') }
+  end
+end.to eq('hello')
+```
+
+#### Call Back and Event History Methods
+
+HyperReact components can *generate* events and perform callbacks.  HyperSpec provides methods to test if an event or callback was made.
+
+```ruby
+mount 'CallBackOnEveryThirdClick' do
+  class CallBackOnEveryThirdClick < React::Component::Base
+    param :click3, type: Proc
+    def increment_click
+      @clicks ||= 0
+      @clicks = (@clicks + 1)
+      params.click3(@clicks) if @clicks % 3 == 0
+    end
+    render do
+      DIV(class: :tp_clicker) { "click me" }
+      .on(:click) { increment_click }
+    end
+  end
+end
+
+7.times { page.click('#tp_clicker') }
+expect(callback_history_for(:click3)).to eq([[3], [6]])
+```
+
+Note that for things to work, the param must be declared as a `type: Proc`.
+
++ `callback_history_for`: the entire history given as an array of arrays
++ `last_callback_for`: same as `callback_history_for(xxx).last`
++ `clear_callback_history_for`: clears the array (userful for repeating test variations without remounting)
++ `event_history_for, last_event_for, clear_event_history_for`: same but for events.
+
+#### The `pause` Method
+
+For debugging.  Everything stops, until you type `go()` in the client console.  Running binding.pry also has this effect, and is often sufficient, however it will also block the server from responding unless you have a multithreaded server.
+
+#### The `attributes_on_client` Method
+
+*This feature is currently untested - use at your own risk.*
+
+This reads the value of active record model attributes on the client.
+
+In other words the method `attributes_on_client` is added to all ActiveRecord models.   You then take a model you have instance of on the server, and by passing the Capybara page object, you get back the attributes for that same model instance, currently on the client.
+
+```ruby
+expect(some_record_on_server.attributes_on_client(page)[:fred]).to eq(12)
+```
+
+Note that after persisting a record the client and server will be synced so this is mainly useful for debug or in rare cases where it is important to interrogate the value on the client before its persisted.
+
+#### The `size_window` Method
+
+Sets the size of the test window.  You can say:
+`size_window(width, height)` or pass one of the following standard sizes:  to one of the following standard sizes:
+
++ small: 480 X 320
++ mobile: 640 X 480
++ tablet: 960 X 640
++ large: 1920 X 6000
++ default: 1024 X 768
+
+example: `size_window(:mobile)`
+
+You can also modify the standard sizes with `:portrait`
+
+example: `size_window(:table, :portrait)`
+
+You can also specify the size by providing the width and height.
+
+example: `size_window(600, 600)`
+
+size_window with no parameters is the same as `size_window(:default)`
+
+Typically you will use this in a `before(:each)` or `before(:step)` block
+
+#### The `add_class` Method
+
+Sometimes it's useful to change styles during testing (mainly for debug so that changes on screen are visible.)
+
+The `add_class` method takes a class name (as a symbol or string), and hash representing the style.
+
+```ruby
+it "can add classes during testing" do
+  add_class :some_class, borderStyle: :solid
+  mount 'StyledDiv' do
+    class StyledDiv < React::Component::Base
+      render(DIV, id: 'hello', class: 'some_class') do
+        'Hello!'
+      end
+    end
+  end
+  expect(page.find('#hello').native.css_value('border-right-style')).to eq('solid')
+end
+```
+
+## Integration with the Steps gem
+
+The [rspec-steps gem](https://github.com/LRDesign/rspec-steps) can be useful in doing client side testing.  Without rspec-steps, each test spec will cause a reload of the browser window.  While this insures that each test runs in a clean environment, it is typically not necessary and can really slow down testing.
+
+The rspec-steps gem will run each test without reloading the window, which is usually fine.
+
+Checkout the rspec-steps example in the `hyper_spec.rb` file for an example.
+
+*Note that hopefully in the near future we are going to build a custom capybara driver that will just directly talk to Hyperloop on the client side.  Once this is in place these troubles should go away! - Volunteers welcome to help!*
+
+## Timecop Integration
+
+HyperSpec is integrated with [Timecop](https://github.com/travisjeffery/timecop) to freeze, move and speed up time.  The client and server times will be kept in sync when you use any these Timecop methods:
+
++ `freeze`:  Freezes time at the specified point in time (default is Time.now)
++ `travel`:  Time runs normally forward from the point specified.
++ `scale`:   Like travel but times runs faster.
++ `return`:  Return to normal system time.
+
+For example:
+```ruby
+Timecop.freeze # freeze time at current time
+# ... test some stuff
+Timecop.freeze Time.now+10.minutes # move time forward 10 minutes
+# ... check to see if expected events happened etc
+Timecop.return
+```
+
+```ruby
+Timecop.scale 60, Time.now-1.year do
+  # Time will begin 1 year ago but advance 60 times faster than normal
+  sleep 10
+  # still sleeps for 10 seconds YOUR time, but server and client will
+  # think 10 minutes have passed
+end
+# no need for Timecop.return if using the block style
+```
+
+See the Timecop [README](https://github.com/travisjeffery/timecop/blob/master/README.markdown) for more details.
+
+There is one confusing thing to note:  On the server if you `sleep` then you will sleep for the specified number of seconds when viewed *outside* of the test.  However inside the test environment if you look at Time.now, you will see it advancing according to the scale factor.  Likewise if you have a `after` or `every` block on the client, you will wait according to *simulated* time.
+
+## Common Problems
+
+If you are getting failures on Poltergeist but not Firefox, make sure you are not requiring `browser` in your components.rb.
+Requiring `browser/interval` or `browser/delay` is okay.
+
+## Development
+
+After checking out the repo, run bundle install and you should be good to go.
+
+Tests are run either by running `rake` or for more control:
+
+```
+DRIVER=ff bundle exec rspec spec/hyper_spec.rb
+```
+
+where DRIVER can be either `ff` (firefox) or `pg` (poltergeist - default).
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/hyper-spec. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -5,6 +5,8 @@ RSpec::Core::RakeTask.new(:spec)
 
 namespace :spec do
   task :prepare do
+    sh %{bundle update}
+    sh %{cd spec/test_app; bundle update}
   end
 end
 

data/dciy.toml

@@ -0,0 +1,3 @@
+[dciy.commands]
+prepare = ["rake spec:prepare"]
+cibuild = ["bundle exec rake"]

data/hyper-spec.gemspec

@@ -25,10 +25,8 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.require_paths = ['lib']
 
   spec.add_dependency 'capybara'
-  spec.add_dependency 'chromedriver-helper', '1.2.0'
-  spec.add_dependency 'libv8', '~> 6.7.0'
+  spec.add_dependency 'chromedriver-helper'
   spec.add_dependency 'method_source'
-  spec.add_dependency 'mini_racer', '~> 0.2.4'
   spec.add_dependency 'opal', '>= 0.11.0', '< 0.12.0'
   spec.add_dependency 'parser', '>= 2.3.3.1'
   spec.add_dependency 'pry'
@@ -36,17 +34,18 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.add_dependency 'selenium-webdriver'
   spec.add_dependency 'timecop', '~> 0.8.1'
   spec.add_dependency 'uglifier'
-  spec.add_dependency 'unparser', '>= 0.4.2' # 0.4 is incompatible
+  spec.add_dependency 'unparser'
   spec.add_dependency 'webdrivers'
 
-  spec.add_development_dependency 'bundler', ['>= 1.17.3', '< 2.1']
-  spec.add_development_dependency 'hyper-component', HyperSpec::VERSION
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'hyper-react', HyperSpec::VERSION
+  spec.add_development_dependency 'mini_racer', '~> 0.1.15'
   spec.add_development_dependency 'opal-browser', '~> 0.2.0'
   spec.add_development_dependency 'opal-rails', '~> 0.9.4'
-  spec.add_development_dependency 'pry-rescue'
   spec.add_development_dependency 'puma'
   spec.add_development_dependency 'rails', '>= 4.0.0'
   spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'pry-rescue'
   spec.add_development_dependency 'react-rails', '>= 2.3.0', '< 2.5.0'
   spec.add_development_dependency 'rspec-collection_matchers'
   spec.add_development_dependency 'rspec-expectations'

data/lib/hyper-spec.rb

@@ -17,11 +17,11 @@ RSpec.configure do |config|
   config.add_setting :debugger_width, default: nil
 
   config.before(:each) do
-    Hyperstack.class_eval do
+    Hyperloop.class_eval do
       def self.on_server?
         true
       end
-    end if defined?(Hyperstack)
+    end if defined?(Hyperloop)
     # for compatibility with HyperMesh
     HyperMesh.class_eval do
       def self.on_server?
@@ -62,14 +62,6 @@ RSpec.configure do |_config|
     Capybara::Selenium::Driver.new(app, browser: :chrome, desired_capabilities: capabilities)
   end
 
-  Capybara.register_driver :chrome_headless_docker_travis do |app|
-    options = ::Selenium::WebDriver::Chrome::Options.new
-    options.add_argument('--headless')
-    options.add_argument('--no-sandbox')
-    options.add_argument('--disable-dev-shm-usage')
-    Capybara::Selenium::Driver.new(app, browser: :chrome, :driver_path => "/usr/lib/chromium-browser/chromedriver", options: options)
-  end
-
   Capybara.register_driver :firefox do |app|
     Capybara::Selenium::Driver.new(app, browser: :firefox)
   end
@@ -100,7 +92,6 @@ RSpec.configure do |_config|
     when 'firefox' then :firefox
     when 'headless' then :selenium_chrome_headless
     when 'safari' then :safari
-    when 'travis' then :chrome_headless_docker_travis
     else :selenium_chrome_headless
     end
 

data/lib/hyper-spec/component_test_helpers.rb

@@ -1,16 +1,13 @@
 # see component_test_helpers_spec.rb for examples
 require 'parser/current'
 require 'unparser'
-require 'hyper-spec/unparser_patch'
 require 'method_source'
 require_relative '../../lib/hyper-spec/time_cop.rb'
 
-Parser::Builders::Default.emit_procarg0 = true
-
 module HyperSpec
   module ComponentTestHelpers
     TOP_LEVEL_COMPONENT_PATCH =
-      Opal.compile(File.read(File.expand_path('../../sources/top_level_rails_component.rb', __FILE__)))
+      Opal.compile(File.read(File.expand_path('../../react/top_level_rails_component.rb', __FILE__)))
     TIME_COP_CLIENT_PATCH =
       Opal.compile(File.read(File.expand_path('../../hyper-spec/time_cop.rb', __FILE__))) +
       "\n#{File.read(File.expand_path('../../sources/lolex.js', __FILE__))}"
@@ -27,11 +24,11 @@ module HyperSpec
 
     def build_test_url_for(controller)
       unless controller
-        unless defined?(::HyperstackTestController)
-          Object.const_set('HyperstackTestController', Class.new(::ActionController::Base))
+        unless defined?(::ReactTestController)
+          Object.const_set('ReactTestController', Class.new(::ActionController::Base))
         end
 
-        controller = ::HyperstackTestController
+        controller = ::ReactTestController
       end
 
       route_root = controller.name.gsub(/Controller$/, '').underscore
@@ -111,8 +108,7 @@ module HyperSpec
       if block
         str = "#{str}\n#{Unparser.unparse Parser::CurrentRuby.parse(block.source).children.last}"
       end
-      js = Opal.compile(str).gsub("// Prepare super implicit arguments\n", "")
-               .delete("\n").gsub('(Opal);', '(Opal)')
+      js = Opal.compile(str).delete("\n").gsub('(Opal);', '(Opal)')
       # workaround for firefox 58 and geckodriver 0.19.1, because firefox is unable to find .$to_json:
       # JSON.parse(evaluate_script("(function(){var a=Opal.Array.$new(); a[0]=#{js}; return a.$to_json();})();"), opts).first
       JSON.parse(evaluate_script("[#{js}].$to_json()"), opts).first
@@ -220,9 +216,8 @@ module HyperSpec
               }
             end
           end
-          class Hyperstack::Internal::Component::TestDummy
-            include Hyperstack::Component
-                render {}
+          class React::Component::HyperTestDummy < React::Component::Base
+                def render; end
           end
           #{@client_code}
           #{Unparser.unparse(Parser::CurrentRuby.parse(block.source).children.last) if block}
@@ -230,7 +225,7 @@ module HyperSpec
         opts[:code] = Opal.compile(block_with_helpers)
       end
 
-      component_name ||= 'Hyperstack::Internal::Component::TestDummy'
+      component_name ||= 'React::Component::HyperTestDummy'
       ::Rails.cache.write(test_url, [component_name, params, opts])
       test_code_key = "hyper_spec_prerender_test_code.js"
       @@original_server_render_files ||= ::Rails.configuration.react.server_renderer_options[:files]
@@ -245,16 +240,16 @@ module HyperSpec
           ::React::ServerRendering.reset_pool # make sure contexts are reloaded so they dont use code from cache, as the rails filewatcher doesnt look for cache changes
         end
       end
+      Lolex.init(self, client_options[:time_zone], client_options[:clock_resolution])
       visit test_url
       wait_for_ajax unless opts[:no_wait]
       page.instance_variable_set('@hyper_spec_mounted', true)
-      Lolex.init(self, client_options[:time_zone], client_options[:clock_resolution])
     end
 
     [:callback_history_for, :last_callback_for, :clear_callback_history_for,
      :event_history_for, :last_event_for, :clear_event_history_for].each do |method|
       define_method(method) do |event_name|
-        evaluate_ruby("Hyperstack::Internal::Component::TopLevelRailsComponent.#{method}('#{event_name}')")
+        evaluate_ruby("React::TopLevelRailsComponent.#{method}('#{event_name}')")
       end
     end
 
@@ -282,11 +277,11 @@ module HyperSpec
     def pause(message = nil)
       if message
         puts message
-        page.evaluate_script "console.log('#{message} (type go() to continue)')"
+        page.evaluate_ruby "puts #{message.inspect}.to_s + ' (type go() to continue)'"
       end
 
       page.evaluate_script('window.hyper_spec_waiting_for_go = true')
-      page.evaluate_script('go = function() {window.hyper_spec_waiting_for_go = false}')
+
       loop do
         sleep 0.25
         break unless page.evaluate_script('window.hyper_spec_waiting_for_go')

data/lib/hyper-spec/version.rb

@@ -1,3 +1,3 @@
 module HyperSpec
-  VERSION = '1.0.alpha1.5'
+  VERSION = '1.0.0.lap28'
 end

data/lib/hyper-spec/wait_for_ajax.rb

@@ -12,9 +12,9 @@ module HyperSpec
     def running?
       jscode = <<-CODE
       (function() {
-        if (typeof Opal !== "undefined" && Opal.Hyperstack !== undefined) {
+        if (typeof Opal !== "undefined" && Opal.Hyperloop !== undefined) {
           try {
-            return Opal.Hyperstack.$const_get("HTTP")["$active?"]();
+            return Opal.Hyperloop.$const_get("HTTP")["$active?"]();
           } catch(err) {
             if (typeof jQuery !== "undefined" && jQuery.active !== undefined) {
               return (jQuery.active > 0);
@@ -39,7 +39,7 @@ module HyperSpec
     rescue Capybara::NotSupportedByDriverError
       true
     rescue Exception => e
-      e.message == 'either jQuery or Hyperstack::HTTP is not defined'
+      e.message == 'either jQuery or Hyperloop::HTTP is not defined'
     end
   end
 end

data/lib/react/top_level_rails_component.rb

@@ -0,0 +1,94 @@
+module React
+  class TopLevelRailsComponent
+    class << self
+      attr_accessor :event_history
+
+      def callback_history_for(proc_name)
+        event_history[proc_name]
+      end
+
+      def last_callback_for(proc_name)
+        event_history[proc_name].last
+      end
+
+      def clear_callback_history_for(proc_name)
+        event_history[proc_name] = []
+      end
+
+      def event_history_for(event_name)
+        event_history["_on#{event_name.event_camelize}"]
+      end
+
+      def last_event_for(event_name)
+        event_history["_on#{event_name.event_camelize}"].last
+      end
+
+      def clear_event_history_for(event_name)
+        event_history["_on#{event_name.event_camelize}"] = []
+      end
+    end
+
+    def component
+      return @component if @component
+      paths_searched = []
+      component = nil
+      if params.component_name.start_with?('::')
+        # if absolute path of component is given, look it up and fail if not found
+        paths_searched << params.component_name
+        component = begin
+                      Object.const_get(params.component_name)
+                    rescue NameError
+                      nil
+                    end
+      else
+        # if relative path is given, look it up like this
+        # 1) we check each path + controller-name + component-name
+        # 2) if we can't find it there we check each path + component-name
+        # if we can't find it we just try const_get
+        # so (assuming controller name is Home)
+        # ::Foo::Bar will only resolve to some component named ::Foo::Bar
+        # but Foo::Bar will check (in this order) ::Home::Foo::Bar, ::Components::Home::Foo::Bar, ::Foo::Bar, ::Components::Foo::Bar
+        self.class.search_path.each do |scope|
+          paths_searched << "#{scope.name}::#{params.controller}::#{params.component_name}"
+          component = begin
+                        scope.const_get(params.controller, false).const_get(params.component_name, false)
+                      rescue NameError
+                        nil
+                      end
+          break if component != nil
+        end
+        unless component
+          self.class.search_path.each do |scope|
+            paths_searched << "#{scope.name}::#{params.component_name}"
+            component = begin
+                          scope.const_get(params.component_name, false)
+                        rescue NameError
+                          nil
+                        end
+            break if component != nil
+          end
+        end
+      end
+      @component = component
+      return @component if @component && @component.method_defined?(:render)
+      raise "Could not find component class '#{params.component_name}' for params.controller '#{params.controller}' in any component directory. Tried [#{paths_searched.join(", ")}]"
+    end
+
+    before_mount do
+      TopLevelRailsComponent.event_history = Hash.new { |h, k| h[k] = [] }
+      @render_params = params.render_params
+      component.validator.rules.each do |name, rules|
+        next unless rules[:type] == Proc
+
+        TopLevelRailsComponent.event_history[name] = []
+        @render_params[name] = lambda do |*args|
+          TopLevelRailsComponent.event_history[name] << args
+        end
+      end
+    end
+
+    def render
+      React::RenderingContext.render(component, @render_params)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyper-spec
 version: !ruby/object:Gem::Version
-  version: 1.0.alpha1.5
+  version: 1.0.0.lap28
 platform: ruby
 authors:
 - Mitch VanDuyn
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-19 00:00:00.000000000 Z
+date: 2018-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -30,30 +30,16 @@ dependencies:
   name: chromedriver-helper
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.2.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.2.0
-- !ruby/object:Gem::Dependency
-  name: libv8
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 6.7.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 6.7.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: method_source
   requirement: !ruby/object:Gem::Requirement
@@ -68,20 +54,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: mini_racer
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.2.4
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.2.4
 - !ruby/object:Gem::Dependency
   name: opal
   requirement: !ruby/object:Gem::Requirement
@@ -192,14 +164,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.2
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.2
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: webdrivers
   requirement: !ruby/object:Gem::Requirement
@@ -220,34 +192,42 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.17.3
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.17.3
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: hyper-component
+  name: hyper-react
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.5
+        version: 1.0.0.lap28
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.5
+        version: 1.0.0.lap28
+- !ruby/object:Gem::Dependency
+  name: mini_racer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.15
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.15
 - !ruby/object:Gem::Dependency
   name: opal-browser
   requirement: !ruby/object:Gem::Requirement
@@ -277,7 +257,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.9.4
 - !ruby/object:Gem::Dependency
-  name: pry-rescue
+  name: puma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -291,35 +271,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: puma
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 4.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 4.0.0
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: pry-rescue
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -489,23 +469,27 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop.yml"
 - ".travis.yml"
+- CODE_OF_CONDUCT.md
 - Gemfile
+- LICENSE.txt
+- README.md
 - Rakefile
 - bin/console
 - bin/setup
+- dciy.toml
 - hyper-spec.gemspec
 - lib/bin/firebug-2.0.13-fx.xpi
 - lib/bin/firebug-2.0.19-fx.xpi
 - lib/hyper-spec.rb
 - lib/hyper-spec/component_test_helpers.rb
 - lib/hyper-spec/time_cop.rb
-- lib/hyper-spec/unparser_patch.rb
 - lib/hyper-spec/version.rb
 - lib/hyper-spec/wait_for_ajax.rb
+- lib/react/top_level_rails_component.rb
 - lib/selenium/web_driver/firefox/profile.rb
 - lib/sources/lolex.js
-- lib/sources/top_level_rails_component.rb
 homepage: http://ruby-hyperloop.org
 licenses:
 - MIT
@@ -525,7 +509,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.0.4
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Drive your Hyperloop client and server specs from RSpec and Capybara

data/lib/hyper-spec/unparser_patch.rb

@@ -1,10 +0,0 @@
-module Unparser
-  class Emitter
-    # Emitter for send
-    class Send < self
-      def local_variable_clash?
-        selector =~ /^[A-Z]/ || local_variable_scope.local_variable_defined_for_node?(node, selector)
-      end
-    end
-  end
-end

data/lib/sources/top_level_rails_component.rb

@@ -1,103 +0,0 @@
-module Hyperstack
-  module Internal
-    module Component
-      class TopLevelRailsComponent
-
-        # original class declares these params:
-        # param :component_name
-        # param :controller
-        # param :render_params
-
-        class << self
-          attr_accessor :event_history
-
-          def callback_history_for(proc_name)
-            event_history[proc_name]
-          end
-
-          def last_callback_for(proc_name)
-            event_history[proc_name].last
-          end
-
-          def clear_callback_history_for(proc_name)
-            event_history[proc_name] = []
-          end
-
-          def event_history_for(event_name)
-            event_history["on_#{event_name}"]
-          end
-
-          def last_event_for(event_name)
-            event_history["on_#{event_name}"].last
-          end
-
-          def clear_event_history_for(event_name)
-            event_history["on_#{event_name}"] = []
-          end
-        end
-
-        def component
-          return @component if @component
-          paths_searched = []
-          component = nil
-          if @ComponentName.start_with?('::')
-            # if absolute path of component is given, look it up and fail if not found
-            paths_searched << @ComponentName
-            component = begin
-                          Object.const_get(@ComponentName)
-                        rescue NameError
-                          nil
-                        end
-          else
-            # if relative path is given, look it up like this
-            # 1) we check each path + controller-name + component-name
-            # 2) if we can't find it there we check each path + component-name
-            # if we can't find it we just try const_get
-            # so (assuming controller name is Home)
-            # ::Foo::Bar will only resolve to some component named ::Foo::Bar
-            # but Foo::Bar will check (in this order) ::Home::Foo::Bar, ::Components::Home::Foo::Bar, ::Foo::Bar, ::Components::Foo::Bar
-            self.class.search_path.each do |scope|
-              paths_searched << "#{scope.name}::#{@Controller}::#{@ComponentName}"
-              component = begin
-                            scope.const_get(@Controller, false).const_get(@ComponentName, false)
-                          rescue NameError
-                            nil
-                          end
-              break if component != nil
-            end
-            unless component
-              self.class.search_path.each do |scope|
-                paths_searched << "#{scope.name}::#{@ComponentName}"
-                component = begin
-                              scope.const_get(@ComponentName, false)
-                            rescue NameError
-                              nil
-                            end
-                break if component != nil
-              end
-            end
-          end
-          @component = component
-          return @component if @component && @component.method_defined?(:render)
-          raise "Could not find component class '#{@ComponentName}' for @Controller '#{@Controller}' in any component directory. Tried [#{paths_searched.join(", ")}]"
-        end
-
-        before_mount do
-          TopLevelRailsComponent.event_history = Hash.new { |h, k| h[k] = [] }
-          component.validator.rules.each do |name, rules|
-            next unless rules[:type] == Proc
-
-            TopLevelRailsComponent.event_history[name] = []
-            @RenderParams[name] = lambda do |*args|
-              TopLevelRailsComponent.event_history[name] << args
-            end
-          end
-        end
-
-        def render
-          Hyperstack::Internal::Component::RenderingContext.render(component, @RenderParams)
-        end
-      end
-    end
-  end
-end