capybara-jasmine 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d329c6afd030f3b24a86c22282f2638c4f500ad9
+  data.tar.gz: a3073f19a000cb39244a65bed05597f56904ae06
+SHA512:
+  metadata.gz: 2a2c46648589239195cecae10fb20ed356d9aba19f1f27c768e6743d912f84fdcaf99736a7abbbdb5443fc7ea82c79788551e297ecb10ebcd3f56e65ce5818fd
+  data.tar.gz: 193c05ce450da03bd757f6ecd6467171811cc8ceef3de66bdaab14cf28154cc51abc7ce27a389e29af4d31552e4bc952e3e7a5973f12e4638c4f09f2f8b26824

data/.gitignore

@@ -0,0 +1,3 @@
+Gemfile.lock
+
+capybara-jasmine-*

data/README.md

@@ -0,0 +1,47 @@
+# Capybara-Jasmine
+
+This gem uses Capybara to run Jasmine specs. Request a page once, run many JS specs. Works with RSpec and [Jasmine AJAX](https://github.com/jasmine/jasmine-ajax).
+
+##Why?
+Capybara is a powerful tool, but I find it very tedious and slow, especially for JS testing. This is mostly due to the fact that loading a page for each spec is very time consuming.
+
+Being able to write Jasmine specs and run them with the RSpec suite is flexible and fast: write Capybara specs for simple things, but Jasmine is perfect for JS unit tests, on-page JS functionality and AJAX requests.
+
+## Installation
+1. Add to your Gemfile:`gem 'capybara-jasmine'`
+2. Add to the bottom of your spec helper:
+  `require './spec/jasmine/jasmine_helper'
+`
+3. Create a jasmine folder within spec folder.
+2. Create a `jasmine_helper.rb` in the jasmine folder. See Capybara-Jasmine Demo App for inspiration.
+2. Create a features folder and put an RSpec spec in it.
+2. Create a js folder and put your JS specs in it.
+1. Capybara-Jasmine is a Rack app that will call your app. Name your app "app" or allow it to respond to "app".
+
+## How it Works
+Each Jasmine spec file must be selected within the RSpec spec:
+
+    specify 'Index Page' do
+      run_specs 'IndexPageSpec'
+      visit '/'
+
+In this example, we will load the index page run the JS specs `IndexPageSpecs` against it. 
+
+You can specify multiple Jasmine spec files on one Capybara visit:
+
+    run_specs 'IndexPageSpec, NavigationSpec'
+    visit '/'
+
+Capybara-Jasmine uses with RSpec and WebKit.
+
+**JS helpers:**
+
+1. Fill in a form field. Takes a finder and a value:
+   `fillIn( '#emailField', 'joe@example.com' )`
+
+1. Click Submit:
+    `clickSubmit()`
+
+1. Click link or button. Takes a finder:
+     `Click('#logo');`  
+

data/capybara-jasmine.gemspec

@@ -0,0 +1,21 @@
+ Gem::Specification.new do |s|
+  s.name        = 'capybara-jasmine'
+  s.version     = '0.1.1'
+  s.date        = '2015-05-03'
+  s.summary     = 'Run Jasmine specs with Capybara.'
+  s.description = 'This gem allows you to run Jasmine specs with Capybara for a Rack app.'
+  s.authors     = ['George Ulmer']
+  s.email       = 'george@boost-media.com'
+  s.files       = `git ls-files`.split($/)
+  s.homepage    = 'http://rubygems.org/gems/capybara-jasmine'
+  s.license     = 'MIT'
+
+  s.add_dependency 'rack', ['1.6.0']
+  s.add_dependency 'rspec', ['3.2']
+  s.add_dependency 'rack-test', ['0.6.3']
+  s.add_dependency 'guard', ['2.12']
+  s.add_dependency 'capybara', ['2.4.4']
+  s.add_dependency 'capybara-webkit', ['1.5.0']
+  s.add_dependency 'selenium-webdriver', ['2.45.0']
+  s.add_dependency 'awesome_print', ['1.6.1']
+end

data/lib/app/builder.rb

@@ -0,0 +1,14 @@
+def capybara_app
+  Rack::Builder.new do
+    use SpecInjector
+    use Rack::Static, urls:[ '/jasmine' ], root:'spec'
+    use Rack::Static, urls:[ '/capybara-jasmine-files' ], root:gem_dir
+    
+    run app
+  end.to_app
+end
+
+
+def gem_dir
+  File.join(File.dirname(File.expand_path(__FILE__)), '../../lib')
+end

data/lib/app/init.rb

@@ -0,0 +1,8 @@
+# Gems
+require 'rack'
+
+# App
+require_relative 'builder'
+require_relative 'spec_injector'
+
+puts "Starting Capybara Jasmine in #{ ENV[ 'RACK_ENV' ]} environment."

data/lib/app/spec_injector.rb

@@ -0,0 +1,64 @@
+class SpecInjector
+  def initialize app
+    @app = app
+  end
+
+  def call env
+    @env = env
+    
+    status, headers, response = @app.call( env )
+
+    if status != 200
+      puts red( "capybara-jasmine HTTP request error: #{ status } #{ env[ 'PATH_INFO' ] }")
+    else
+      # puts green( "capybara-jasmine HTTP request success: #{ status } #{ env[ 'PATH_INFO' ] }")
+    end
+
+    if headers[ 'Content-Type' ] && headers[ 'Content-Type' ].include?( 'text/html' )
+      body = body_for( response )
+      
+      headers[ 'Content-Length' ] = body.length.to_s
+
+      [ status, headers, [ body ]]
+    else  
+      [ status, headers, response ]
+    end  
+  end
+
+  def specs
+    return [] if @env[ 'HTTP_X_SPECS' ].nil?
+
+    @env[ 'HTTP_X_SPECS' ].split( ',' ).map( &:strip )
+  end
+
+  def body_for response
+    body = ''
+
+    response.each{| p | body += p.gsub( '<head>', "<head>#{ jasmine_requires }#{ header_specs }" )}
+
+    body
+  end
+
+  def header_specs
+    "\n" + specs.map do |spec|
+      "<script src='/jasmine/js/#{ spec }.js'></script>"
+    end.join( "\n" ) + "\n"
+  end
+
+  def jasmine_requires_files
+    [ 
+      'vendor/jquery.2.1.3.min.js',
+      'jasmine_lib/jasmine.js' ,
+      'jasmine_lib/jasmine-html.js',
+      'jasmine_lib/boot.js',
+      'jasmine_lib/mock-ajax.js',
+      'js/SharedHelpers.js'
+    ]
+  end
+
+  def jasmine_requires
+    "\n" + jasmine_requires_files.map do |f|
+      "<script src='/capybara-jasmine-files/#{ f }'></script>"
+    end.join( "\n" )
+  end
+end

data/lib/capybara-jasmine.rb

@@ -0,0 +1,3 @@
+require 'app/init'
+require 'shared/helpers'
+require 'shared/matchers'

data/lib/shared/helpers.rb

@@ -0,0 +1,105 @@
+def run_specs specs
+  page.driver.header 'Content-Type', 'text/html'
+  page.driver.header 'X-Specs', specs
+end
+
+def display_js_errors
+  return unless Capybara.current_driver.match /webkit/
+
+  if page.driver.error_messages.any?
+    puts red 'Javascript errors:'
+  else
+    puts cyan 'No Javascript errors.'
+  end
+
+  page.driver.error_messages.each do |m|
+    puts red( "  #{ filename_for m[ :source ]}: Line #{ m[ :line_number ]}: #{ m[ :message ]}" )
+  end
+end
+
+def filename_for url
+  url.gsub /https?:\/\/.*?\//, ''
+end
+
+def display_js_console
+  return unless Capybara.current_driver == :webkit
+
+  if page.driver.console_messages.any?
+    puts magenta( "Javascript console:")
+  end
+
+  page.driver.console_messages.each do |m|
+    puts magenta( "  #{ filename_for m[ :source ]}: Line #{ m[ :line_number ]}: #{ m[ :message ]}" )
+  end
+end
+
+def display_jasmine_specs
+  puts cyan( jasmine_suites )
+  color_print jasmine_result
+end
+
+def jasmine_result
+  result = js_html.match( /\d+\s+specs?,\s+\d+\s+failures?/ ).to_s
+
+  if result.match /,\s+0 failure/
+    "Jasmine Success: #{ result }"
+  else
+    "Jasmine Failure: #{ result }\n" + jasmine_failures
+  end
+end
+
+def jasmine_failures
+  html_doc = Nokogiri::HTML( js_html )
+  html_doc.css( 'div .result-message' )
+          .map{|div| "  #{ div.text }"}
+          .join( "\n" )
+end
+
+def jasmine_suites
+  html_doc = Nokogiri::HTML( js_html )
+  html_doc.css( 'div .suite' ).map do | suite |
+    suite.at_css( '.suite-detail' ).text +
+    suite.css( 'ul.specs' ).map{| spec | "\n  #{ spec.text }"}.join
+  end.join
+end
+
+def js_html
+  page.evaluate_script( 'document.documentElement.outerHTML' )
+end
+
+def color_print text
+  unless text.match /failure/
+    puts red( "Jasmine specs failed to run for #{ self.inspect }." )
+    return
+  end
+
+  if text.match /,\s+0 failures/
+    puts cyan( text )
+  else
+    puts red( text )
+  end
+end
+
+def colorize color_code, text
+  "\e[#{color_code}m#{text}\e[0m"
+end
+
+def red text
+  colorize 31, text
+end
+
+def green text
+  colorize 32, text
+end
+
+def blue text
+  colorize 34, text
+end
+
+def magenta text
+  colorize 35, text
+end
+
+def cyan text
+  colorize 36, text
+end

data/lib/shared/matchers.rb

@@ -0,0 +1,9 @@
+RSpec::Matchers.define :jasmine_success do
+  match do |actual|
+    ! actual.match /([1-9]|\d{2,}) failures/
+  end
+
+  failure_message do |actual|
+    jasmine_result
+  end
+end

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: capybara-jasmine
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- George Ulmer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.4.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.4.4
+- !ruby/object:Gem::Dependency
+  name: capybara-webkit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.45.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.45.0
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+description: This gem allows you to run Jasmine specs with Capybara for a Rack app.
+email: george@boost-media.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- README.md
+- capybara-jasmine.gemspec
+- lib/app/builder.rb
+- lib/app/init.rb
+- lib/app/spec_injector.rb
+- lib/capybara-jasmine.rb
+- lib/shared/helpers.rb
+- lib/shared/matchers.rb
+homepage: http://rubygems.org/gems/capybara-jasmine
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Run Jasmine specs with Capybara.
+test_files: []