cucumber-rails 0.2.4 → 0.3.0

data/lib/cucumber/rails/capybara_javascript_emulation.rb

@@ -3,20 +3,21 @@ module Cucumber
     module CapybaraJavascriptEmulation
       def self.included(base)
         base.class_eval do
-          alias_method :click_without_rails_javascript_emulation, :click
+          alias_method :click_without_javascript_emulation, :click
+          alias_method :click, :click_with_javascript_emulation
         end
       end
   
-      def click_with_rails_javascript_emulation
-        if link_with_onclick_from_rails?
+      def click_with_javascript_emulation
+        if link_with_non_get_http_method?
           Capybara::Driver::RackTest::Form.new(driver, js_form(self[:href], emulated_method)).submit(self)
         else
-          click_without_rails_javascript_emulation
+          click_without_javascript_emulation
         end
       end
-      
 
       private
+
       def js_form(action, emulated_method, method = 'POST')
         js_form = node.document.create_element('form')
         js_form['action'] = action
@@ -33,12 +34,20 @@ module Cucumber
         js_form
       end
 
-      def link_with_onclick_from_rails?
-        tag_name == 'a' and node['onclick'] =~ /var f = document\.createElement\('form'\); f\.style\.display = 'none';/
+      def link_with_non_get_http_method?
+        if ::Rails.version.to_f >= 3.0
+          tag_name == 'a' && node['data-method'] && node['data-method'] =~ /(?:delete|put|post)/
+        else
+          tag_name == 'a' && node['onclick'] && node['onclick'] =~ /var f = document\.createElement\('form'\); f\.style\.display = 'none';/
+        end
       end
 
       def emulated_method
-        node['onclick'][/m\.setAttribute\('value', '([^']*)'\)/, 1]
+        if ::Rails.version.to_f >= 3.0
+          node['data-method']
+        else
+          node['onclick'][/m\.setAttribute\('value', '([^']*)'\)/, 1]
+        end
       end
     end
   end
@@ -47,15 +56,17 @@ end
 class Capybara::Driver::RackTest::Node
   include Cucumber::Rails::CapybaraJavascriptEmulation
 end
- 
-Before('@emulate_rails_javascript') do
+
+Before('~@no-txn', '~@selenium', '~@culerity', '~@celerity', '~@javascript') do
+  # Enable javascript emulation
   Capybara::Driver::RackTest::Node.class_eval do
-    alias_method :click, :click_with_rails_javascript_emulation
+    alias_method :click, :click_with_javascript_emulation
   end
 end
- 
-After('@emulate_rails_javascript') do
+
+Before('@no-txn,@selenium,@culerity,@celerity,@javascript') do
+  # Disable javascript emulation
   Capybara::Driver::RackTest::Node.class_eval do
-    alias_method :click, :click_without_rails_javascript_emulation
+    alias_method :click, :click_without_javascript_emulation
   end
 end

data/lib/cucumber/rails/rspec.rb

@@ -1,10 +1,23 @@
 require 'cucumber/rails/world'
-require 'spec/expectations'
-require 'spec/rails'
 
-[Cucumber::Rails::World, ActionController::Integration::Session].each do |klass|
-  klass.class_eval do
-    include Spec::Matchers
-    include Spec::Rails::Matchers
+begin
+  require 'rspec/expectations'
+  require 'rspec/rails'
+
+  [Cucumber::Rails::World, ActionController::Integration::Session].each do |klass|
+    klass.class_eval do
+      include Rspec::Matchers
+      include Rspec::Rails::Matchers
+    end
+  end
+rescue LoadError => try_rspec_1
+  require 'spec/expectations'
+  require 'spec/rails'
+
+  [Cucumber::Rails::World, ActionController::Integration::Session].each do |klass|
+    klass.class_eval do
+      include Spec::Matchers
+      include Spec::Rails::Matchers
+    end
   end
-end
+end

data/lib/cucumber/rails/world.rb

@@ -6,7 +6,11 @@ unless defined?(Test)
 end
 
 if defined?(ActiveRecord::Base)
-  require 'test_help' 
+  if Rails.version.to_f >= 3.0
+    require 'rails/test_help' 
+  else
+    require 'test_help' 
+  end
 else
   # I can't do rescue LoadError because in this files could be loaded
   # from rails gem (ie. load actionpack 2.3.5 if rubygems are not disabled)

data/lib/cucumber/web/tableish.rb

@@ -1,75 +1,77 @@
 require 'nokogiri'
 
 module Cucumber
-  module Tableish
-    # This method returns an Array of Array of String, using CSS3 selectors. 
-    # This is particularly handy when using Cucumber's Table#diff! method.
-    #
-    # The +row_selector+ argument must be a String, and picks out all the rows
-    # from the web page's DOM. If the number of cells in each row differs, it
-    # will be constrained by (or padded with) the number of cells in the first row
-    #
-    # The +column_selectors+ argument must be a String or a Proc, picking out
-    # cells from each row. If you pass a Proc, it will be yielded an instance
-    # of Nokogiri::HTML::Element.
-    #
-    # == Example with a table
-    #
-    #   <table id="tools">
-    #     <tr>
-    #       <th>tool</th>
-    #       <th>dude</th>
-    #     </tr>
-    #     <tr>
-    #       <td>webrat</td>
-    #       <td>bryan</td>
-    #     </tr>
-    #     <tr>
-    #       <td>cucumber</td>
-    #       <td>aslak</td>
-    #     </tr>
-    #   </table>
-    #
-    #   t = tableish('table#tools tr', 'td,th')
-    #
-    # == Example with a dl
-    #
-    #   <dl id="tools">
-    #     <dt>webrat</dt>
-    #     <dd>bryan</dd>
-    #     <dt>cucumber</dt>
-    #     <dd>aslak</dd>
-    #   </dl>
-    #
-    #   t = tableish('dl#tools dt', lambda{|dt| [dt, dt.next.next]})
-    #
-    def tableish(row_selector, column_selectors)
-      html = defined?(Capybara) ? body : response_body
-      _tableish(html, row_selector, column_selectors)
-    end
+  module Web
+    module Tableish
+      # This method returns an Array of Array of String, using CSS3 selectors. 
+      # This is particularly handy when using Cucumber's Table#diff! method.
+      #
+      # The +row_selector+ argument must be a String, and picks out all the rows
+      # from the web page's DOM. If the number of cells in each row differs, it
+      # will be constrained by (or padded with) the number of cells in the first row
+      #
+      # The +column_selectors+ argument must be a String or a Proc, picking out
+      # cells from each row. If you pass a Proc, it will be yielded an instance
+      # of Nokogiri::HTML::Element.
+      #
+      # == Example with a table
+      #
+      #   <table id="tools">
+      #     <tr>
+      #       <th>tool</th>
+      #       <th>dude</th>
+      #     </tr>
+      #     <tr>
+      #       <td>webrat</td>
+      #       <td>bryan</td>
+      #     </tr>
+      #     <tr>
+      #       <td>cucumber</td>
+      #       <td>aslak</td>
+      #     </tr>
+      #   </table>
+      #
+      #   t = tableish('table#tools tr', 'td,th')
+      #
+      # == Example with a dl
+      #
+      #   <dl id="tools">
+      #     <dt>webrat</dt>
+      #     <dd>bryan</dd>
+      #     <dt>cucumber</dt>
+      #     <dd>aslak</dd>
+      #   </dl>
+      #
+      #   t = tableish('dl#tools dt', lambda{|dt| [dt, dt.next.next]})
+      #
+      def tableish(row_selector, column_selectors)
+        html = defined?(Capybara) ? body : response_body
+        _tableish(html, row_selector, column_selectors)
+      end
 
-    def _tableish(html, row_selector, column_selectors) #:nodoc
-      doc = Nokogiri::HTML(html)
-      column_count = nil
-      doc.search(row_selector).map do |row|
-        cells = case(column_selectors)
-        when String
-          row.search(column_selectors)
-        when Proc
-          column_selectors.call(row)
-        end
-        column_count ||= cells.length
-        (0...column_count).map do |n|
-          cell = cells[n]
-          case(cell)
-            when String then cell.strip
-            when nil then ''
-            else cell.text.strip
+      def _tableish(html, row_selector, column_selectors) #:nodoc
+        doc = Nokogiri::HTML(html)
+        column_count = nil
+        doc.search(row_selector).map do |row|
+          cells = case(column_selectors)
+          when String
+            row.search(column_selectors)
+          when Proc
+            column_selectors.call(row)
+          end
+          column_count ||= cells.length
+          (0...column_count).map do |n|
+            cell = cells[n]
+            case(cell)
+              when String then cell.strip
+              when nil then ''
+              else cell.text.strip
+            end
           end
         end
       end
-    end
+    end    
   end
 end
 
-World(Cucumber::Tableish)
+World(Cucumber::Web::Tableish)

data/lib/generators/cucumber/feature/USAGE

@@ -0,0 +1,16 @@
+Description:
+    Generates a skeleton for a new feature. Both a simple .feature file and
+    a steps.rb file is generated. This generator should be used with moderation.
+    See http://github.com/aslakhellesoy/cucumber/wikis/feature-coupled-steps-antipattern
+    for details about the dangers involved.
+
+    This generator can take an optional list of attribute pairs similar to Rails'
+    built-in resource generator.
+
+Examples (Rails 3):
+    `script/rails generate cucumber:feature post` # no attributes
+    `script/rails generate cucumber:feature post title:string body:text published:boolean`
+
+Examples (Rails 2):
+    `script/generate feature post` # no attributes
+    `script/generate feature post title:string body:text published:boolean`

data/lib/generators/cucumber/feature/feature_base.rb

@@ -0,0 +1,29 @@
+module Cucumber
+  module Generators
+    module FeatureBase
+
+      def create_directory(m = self, rails2 = false)
+        if rails2
+          m.directory 'features/step_definitions'
+        else
+          m.empty_directory 'features/step_definitions'
+        end
+      end
+
+      def create_feature_file(m = self)
+        m.template 'feature.erb', "features/manage_#{plural_name}.feature"
+      end
+
+      def create_steps_file(m = self)
+        m.template 'steps.erb', "features/step_definitions/#{singular_name}_steps.rb"
+      end
+
+      def create_support_file(m = self)
+        m.gsub_file 'features/support/paths.rb', /'\/'/mi do |match|
+          "#{match}\n    when /the new #{singular_name} page/\n      new_#{singular_name}_path\n"
+        end
+      end
+
+    end
+  end
+end

data/lib/generators/cucumber/feature/feature_generator.rb

@@ -0,0 +1,37 @@
+require File.join(File.dirname(__FILE__), 'named_arg')
+require File.join(File.dirname(__FILE__), 'feature_base')
+
+module Cucumber
+  class FeatureGenerator < Rails::Generators::NamedBase
+
+    include Cucumber::Generators::FeatureBase
+  
+    argument :fields, :optional => true, :type => :array, :banner => "[field:type, field:type]"
+
+    attr_reader :named_args
+  
+    def parse_fields
+      @named_args = @fields.nil? ? [] : @fields.map { |arg| NamedArg.new(arg) }
+    end    
+
+    def generate
+      create_directory
+      create_feature_file
+      create_steps_file
+      create_support_file
+    end
+  
+    def self.banner
+      "#{$0} cucumber:feature ModelName [field:type, field:type]"
+    end
+  
+    def self.gem_root
+      File.expand_path("../../../../../", __FILE__)
+    end
+  
+    def self.source_root
+      File.join(gem_root, 'templates', 'feature')
+    end
+  
+  end
+end

data/lib/generators/cucumber/feature/named_arg.rb

@@ -0,0 +1,17 @@
+class NamedArg
+  attr_reader :name
+  attr_reader :type
+
+  def initialize(s)
+    @name, @type = *s.split(':')
+  end
+
+  def value(n)
+    if @type == 'boolean'
+      (n % 2) == 0
+    else
+      "#{@name} #{n}"
+    end
+  end
+end
+

data/lib/generators/cucumber/skeleton/USAGE

@@ -0,0 +1,21 @@
+Description:
+    Sets up Cucumber in your Rails project. After running this generator you will
+    get a new rake task called features.
+    
+    This also generates the necessary files in the features directory.
+    
+    Also see the feature generator, which you can use to generate skeletons
+    for new features.
+    
+Examples (Rails 3):
+    `script/rails generate cucumber:skeleton`
+
+    You can also provide a language argument for localized webrat_steps:
+    `script/rails generate cucumber:skeleton de`
+
+Examples (Rails 2):
+    `script/generate cucumber`
+
+    You can also provide a language argument for localized webrat_steps:
+    `script/generate cucumber de`
+

data/lib/generators/cucumber/skeleton/skeleton_base.rb

@@ -0,0 +1,202 @@
+module Cucumber
+  module Generators
+    module SkeletonBase
+
+      DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
+
+      # Checks and prints the limitations
+      def check_upgrade_limitations
+        if File.exist?('features/step_definitions/webrat_steps.rb')
+          STDERR.puts "Please remove features/step_definitions/webrat_steps.rb\n" +
+          "See upgrading instructions for 0.2.0 in History.txt"
+          exit(1)
+        end
+
+        if File.exist?('features/support/version_check.rb')
+          STDERR.puts "Please remove features/support/version_check.rb\n" +
+          "See upgrading instructions for 0.2.0 in History.txt"
+          exit(1)
+        end
+      end
+
+      # Creates templates
+      def create_templates(m = self, rails2 = false)
+        m.template 'config/cucumber.yml.erb', 'config/cucumber.yml'
+        if rails2
+          m.template 'environments/cucumber.rb.erb', 'config/environments/cucumber.rb'
+        end
+      end
+
+      def configure_gemfile(m = self, rails2 = false)
+        require 'thor-ext'
+        unless rails2
+          puts "Update Rails 3 Gemfile for cucumber"
+          gsub_file 'Gemfile', /('|")gem/, "\1\ngem"
+          add_gem('database_cleaner', '>=0.5.0') unless has_plugin? 'database_cleaner'
+          if driver == :capybara
+            add_gem('capybara', '>=0.3.0')
+          else
+            add_gem('webrat', '>=0.7.0') unless has_plugin? 'webrat'
+          end
+          if framework == :rspec
+            add_gem('rspec', '>=1.3.0') unless has_plugin? 'rspec'
+            add_gem('rspec-rails', '>=1.3.2') unless has_plugin? 'rspec-rails'
+          end
+          if spork?
+            add_gem('spork''>=0.7.5') unless has_plugin? 'spork'
+          end
+          add_gems(%w{cucumber cucumber-rails})
+        end
+      end
+
+      def create_scripts(m = self, rails2 = false)
+        if rails2
+          m.file 'script/cucumber', 'script/cucumber', {
+            :chmod => 0755, :shebang => options[:shebang] == DEFAULT_SHEBANG ? nil : options[:shebang]
+          }
+        else
+          m.copy_file 'script/cucumber', 'script/cucumber'
+          m.chmod     'script/cucumber', 0755
+        end
+      end
+
+      def create_step_definitions(m = self, rails2 = false)
+        if rails2
+          m.directory 'features/step_definitions'
+        else
+          m.empty_directory 'features/step_definitions'
+        end
+
+        m.template "step_definitions/#{driver}_steps.rb.erb", 'features/step_definitions/web_steps.rb'
+        if language != 'en'
+          m.template "step_definitions/web_steps_#{language}.rb.erb", "features/step_definitions/web_steps_#{language}.rb"
+        end
+      end
+
+      def create_feature_support(m = self, rails2 = false)
+        if rails2
+          m.directory 'features/support'
+          m.file      'support/paths.rb', 'features/support/paths.rb'
+
+          if spork?
+            m.template 'support/rails_spork.rb.erb', 'features/support/env.rb'
+          else
+            m.template 'support/rails.rb.erb',       'features/support/env.rb'
+          end
+        else
+          m.empty_directory 'features/support'
+          m.copy_file 'support/paths.rb', 'features/support/paths.rb'
+
+          if spork?
+            m.template 'support/rails_spork.rb.erb', 'features/support/env.rb'
+          else
+            m.template 'support/rails.rb.erb',       'features/support/env.rb'
+          end
+        end
+      end
+
+      def create_tasks(m = self, rails2 = false)
+        if rails2
+          m.directory 'lib/tasks'
+        else
+          m.empty_directory 'lib/tasks'
+        end
+
+        m.template 'tasks/cucumber.rake.erb', 'lib/tasks/cucumber.rake'
+      end
+
+      def create_database(m = self, rails2 = false)
+        unless File.read('config/database.yml').include? 'cucumber:'
+          m.gsub_file 'config/database.yml', /^test:.*\n/, "test: &TEST\n"
+          m.gsub_file 'config/database.yml', /\z/, "\ncucumber:\n  <<: *TEST"
+          
+          # Since gsub_file doesn't ask the user, just inform user that the file was overwritten.
+          puts "       force  config/database.yml"
+        end
+      end
+
+      def print_instructions
+        require 'cucumber/formatter/ansicolor'
+        extend Cucumber::Formatter::ANSIColor
+
+        if @default_driver
+          puts <<-WARNING
+
+    #{yellow_cukes(15)}
+
+                  #{yellow_cukes(1)}   D R I V E R   A L E R T    #{yellow_cukes(1)}
+
+    You didn't explicitly generate with --capybara or --webrat, so I looked at
+    your gems and saw that you had #{green(@default_driver.to_s)} installed, so I went with that.
+    If you want something else, be specific about it. Otherwise, relax.
+
+    #{yellow_cukes(15)}
+
+    WARNING
+        end
+      end
+
+      protected
+
+      def detect_current_driver
+        detect_in_env([['capybara', :capybara], ['webrat', :webrat]])
+      end
+
+      def detect_default_driver
+        @default_driver = first_loadable([['capybara', :capybara], ['webrat', :webrat]])
+        raise "I don't know which driver you want. Use --capybara or --webrat, or gem install capybara or webrat." unless @default_driver
+        @default_driver
+      end
+
+      def detect_current_framework
+        detect_in_env([['spec', :rspec]])  || :testunit
+      end
+
+      def detect_default_framework
+        # TODO need to check this - defaulting to :testunit has been moved from first_loadable
+        # It's unlikely that we don't have test/unit since it comes with Ruby
+        @default_framework ||= first_loadable([['rspec', :rspec]])
+      end
+
+      def spork?
+        options[:spork]
+      end
+
+      def embed_file(source, indent='')
+        IO.read(File.join(self.class.source_root, source)).gsub(/^/, indent)
+      end
+
+      def embed_template(source, indent='')
+        template = File.join(self.class.source_root, source)
+        ERB.new(IO.read(template), nil, '-').result(binding).gsub(/^/, indent)
+      end
+
+      def version
+        IO.read(File.join(self.class.gem_root, 'VERSION')).chomp
+      end
+
+      def first_loadable(libraries)
+        require 'rubygems'
+
+        libraries.each do |lib_name, lib_key|
+          return lib_key if Gem.available?(lib_name)
+        end
+
+        nil
+      end
+
+      def detect_in_env(choices)
+        return nil unless File.file?("features/support/env.rb")
+
+        env = IO.read("features/support/env.rb")
+
+        choices.each do |choice|
+          detected = choice[1] if env =~ /#{choice[0]}/n
+          return detected if detected
+        end
+
+        nil
+      end
+    end
+  end
+end