kosmas58-cucumber 0.3.96 → 0.3.97

data/History.txt

@@ -1,6 +1,25 @@
+== 0.3.97 2009-08-23
+
+The AA-FTT release. Creating a release for the AA-FTT meeting in Chicago so that we can play
+with the new language API and maybe knock out some better .NET support.
+
+=== Bugfixes
+* Allow comments on examples sections underneath scenario outlines (#420 Mike Sassak)
+* Table.map_headers! will fail with a decent error message when 0 or 2+ headers are matched. (Aslak Hellesøy)
+* Fixed an issue with comments with preceding spaces after a background causing a parse error (#401 Joseph Wilk)
+
+=== New Features
+* The public API is documented and there is a new :sdoc task to generate nice searchable API docs.
+* Add :default => :cucumber when setting up Rake tasks for Cucumber in Rails (Aslak Hellesøy)
+* New When /^I fill in "([^\"]*)" for "([^\"]*)"$/ Webrat step for Rails (Aslak Hellesøy)
+
+=== Changed Features
+* Changed the Programming Language API to support languages without "bleed through" (e.g. rubypython can't invoke ruby objs) (Aslak Hellesøy)
+* The Programming Language API manages hooks on the language level instead of on the step mother level (Aslak Hellesøy)
+
 == 0.3.96 2009-08-15
 
-This release doesn't have any directly visible new features or bug fixes. But there are big
+This release doesn't have any significant new features or bug fixes, but there are big
 internal changes. This release has a new API for plugging in other programming languages.
 You can read more about that here: http://groups.google.com/group/cukes/browse_thread/thread/b9db8bf1f3ec9708
 
@@ -870,8 +889,8 @@ spaces removed too.
 == 0.1.8 2008-10-18
 
 This release extends the support for tables. PLEASE NOTE THAT TABLES ARE STILL EXPERIMENTAL.
-In previous releases it has been possible to use tables to define "more examples" of a scenario i
-n a FIT-style column fixture kind of way. Now you can also use tables as arguments to steps.
+In previous releases it has been possible to use tables to define "more examples" of a scenario in 
+a FIT-style column fixture kind of way. Now you can also use tables as arguments to steps.
 
 Tables used to define more examples after a scenario must now be prefixed. In English it looks like this:
 

data/License.txt

@@ -1,3 +1,5 @@
+The MIT License
+
 Copyright (c) 2008,2009 Aslak Hellesøy
 
 Permission is hereby granted, free of charge, to any person obtaining

data/Manifest.txt

@@ -168,6 +168,7 @@ examples/junit/features/pending.feature
 examples/junit/features/step_definitions/steps.rb
 examples/pure_java/README.textile
 examples/python/features/fibonacci.feature
+examples/python/features/step_definitions/fib_steps.py
 examples/python/features/step_definitions/fib_steps.rb
 examples/python/features/support/env.rb
 examples/python/lib/fib.py
@@ -289,7 +290,8 @@ gem_tasks/flog.rake
 gem_tasks/gemspec.rake
 gem_tasks/rspec.rake
 gem_tasks/sass.rake
-gem_tasks/yard.rake
+gem_tasks/sdoc.rake
+lib/README.rdoc
 lib/autotest/cucumber.rb
 lib/autotest/cucumber_mixin.rb
 lib/autotest/cucumber_rails.rb
@@ -346,7 +348,7 @@ lib/cucumber/formatter/tag_cloud.rb
 lib/cucumber/formatter/unicode.rb
 lib/cucumber/formatter/usage.rb
 lib/cucumber/formatters/unicode.rb
-lib/cucumber/language_support/hook_methods.rb
+lib/cucumber/language_support.rb
 lib/cucumber/language_support/language_methods.rb
 lib/cucumber/language_support/step_definition_methods.rb
 lib/cucumber/languages.yml
@@ -359,6 +361,9 @@ lib/cucumber/parser/table.rb
 lib/cucumber/parser/table.tt
 lib/cucumber/parser/treetop_ext.rb
 lib/cucumber/platform.rb
+lib/cucumber/py_support/py_dsl.py
+lib/cucumber/py_support/py_language.py
+lib/cucumber/py_support/py_language.rb
 lib/cucumber/rails/rspec.rb
 lib/cucumber/rails/world.rb
 lib/cucumber/rake/task.rb
@@ -366,13 +371,13 @@ lib/cucumber/rb_support/rb_dsl.rb
 lib/cucumber/rb_support/rb_hook.rb
 lib/cucumber/rb_support/rb_language.rb
 lib/cucumber/rb_support/rb_step_definition.rb
+lib/cucumber/rb_support/rb_world.rb
 lib/cucumber/rspec_neuter.rb
 lib/cucumber/step_match.rb
 lib/cucumber/step_mother.rb
 lib/cucumber/version.rb
 lib/cucumber/webrat/element_locator.rb
 lib/cucumber/webrat/table_locator.rb
-lib/cucumber/world.rb
 rails_generators/cucumber/USAGE
 rails_generators/cucumber/cucumber_generator.rb
 rails_generators/cucumber/templates/cucumber
@@ -398,7 +403,6 @@ spec/cucumber/ast/scenario_spec.rb
 spec/cucumber/ast/step_collection_spec.rb
 spec/cucumber/ast/step_spec.rb
 spec/cucumber/ast/table_spec.rb
-spec/cucumber/ast/visitor_spec.rb
 spec/cucumber/broadcaster_spec.rb
 spec/cucumber/cli/configuration_spec.rb
 spec/cucumber/cli/drb_client_spec.rb
@@ -417,8 +421,8 @@ spec/cucumber/parser/table_parser_spec.rb
 spec/cucumber/rails/stubs/mini_rails.rb
 spec/cucumber/rails/stubs/test_help.rb
 spec/cucumber/rails/world_spec.rb
+spec/cucumber/rb_support/rb_step_definition_spec.rb
 spec/cucumber/sell_cucumbers.feature
-spec/cucumber/step_definition_spec.rb
 spec/cucumber/step_mother_spec.rb
 spec/cucumber/treetop_parser/empty_feature.feature
 spec/cucumber/treetop_parser/empty_scenario.feature

data/config/hoe.rb

@@ -63,6 +63,7 @@ $hoe = Hoe.spec(GEM_NAME) do |p|
   p.extra_deps = [ 
     ['term-ansicolor', '>= 1.0.3'], 
     ['treetop', '>= 1.3.0'], 
+    ['polyglot', '>= 0.2.8'], # Don't really want polyglot, but it keeps breaking so we'll make people use something that works ok'ish 
     ['diff-lcs', '>= 1.1.2'],
     ['builder', '>= 2.1.2']
   ]

data/examples/i18n/Rakefile

@@ -6,7 +6,7 @@ task :i18n do
       lang = f[dir.length+1..-1]
       if examples_working?(lang)
         Dir.chdir(f) do
-          rake("features")
+          rake("cucumber")
         end
       else
         STDERR.puts %{
@@ -21,10 +21,12 @@ task :i18n do
   end
 end
 
+task :default => :i18n
+
 def examples_working?(lang)
-  !%w{ro ko li lt}.index(lang)
+  !%w{ro}.index(lang)
 end
 
 def rake(args)
-  ruby($0, args) rescue nil
+  ruby($0, args)
 end

data/examples/i18n/fi/features/yhteenlasku.feature

@@ -1,13 +1,14 @@
+# language: fi
 Ominaisuus: Yhteenlasku
   Välttyäkseni hölmöiltä virheiltä
   Koska olen laskutaidoton
   Haluan että yhteenlaskut lasketaan puolestani
 
   Tapausaihio: Kahden luvun summa
-    Oletetaan että olen syöttänyt laskimeen luvun 50
-    Ja että olen syöttänyt laskimeen luvun 70
-    Kun painan "summaa"
-    Niin laskimen ruudulla pitäisi näkyä tulos 120
+    Oletetaan että olen syöttänyt laskimeen luvun <luku_1>
+    Ja että olen syöttänyt laskimeen luvun <luku_2>
+    Kun painan "<nappi>"
+    Niin laskimen ruudulla pitäisi näkyä tulos <tulos>
 
   Tapaukset:
     | luku_1  | luku_2  | nappi  | tulos  |

data/examples/python/features/step_definitions/fib_steps.py

@@ -0,0 +1,3 @@
+from py_dsl import *
+
+Given("Hello from python")

data/examples/python/features/support/env.rb

@@ -1,21 +1,21 @@
-require 'rubypython'
-
-ENV['PYTHONPATH'] = File.expand_path(File.dirname(__FILE__) + '/../../lib')
-
-Before do
-  RubyPython.start
-  @fib = RubyPython.import('fib')
-end
-
-After do
-  RubyPython.stop
-end
-
-# RubyPython seems to expect this to exist (?)
-class String
-  def end_with?(str)
-    str = str.to_str
-    tail = self[-str.length, str.length]
-    tail == str      
-  end
-end
+# require 'rubypython'
+# 
+# ENV['PYTHONPATH'] = File.expand_path(File.dirname(__FILE__) + '/../../lib')
+# 
+# Before do
+#   RubyPython.start
+#   @fib = RubyPython.import('fib')
+# end
+# 
+# After do
+#   RubyPython.stop
+# end
+# 
+# # RubyPython seems to expect this to exist (?)
+# class String
+#   def end_with?(str)
+#     str = str.to_str
+#     tail = self[-str.length, str.length]
+#     tail == str      
+#   end
+# end

data/gem_tasks/contributors.rake

@@ -1,4 +1,12 @@
 task :contributors do
   contributors = `git log --pretty=short --no-merges | git shortlog -ne | egrep -ve '^ +' | egrep -ve '^$'`
   puts contributors.split("\n").length
+end
+
+task :codeswarm do
+  sh "code_swarm --reload" rescue nil # Fails because of encoding - which we'll fix
+  sh "iconv -f latin1 -t utf-8 .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "sed -e 's/Aslak\ Hellesøy@.BEKK.no/aslak.hellesoy@gmail.com/g' .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "sed -e 's/josephwilk@joesniff.co.uk/joe@josephwilk.net/g' .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "code_swarm"
 end

data/gem_tasks/features.rake

@@ -4,6 +4,7 @@ require 'cucumber/rake/task'
 namespace :features do
   Cucumber::Rake::Task.new(:all) do |t|
     t.cucumber_opts = %w{--format progress}
+    t.rcov = ENV['RCOV']
   end
   
   Cucumber::Rake::Task.new(:pretty) do |t|

data/gem_tasks/sdoc.rake

@@ -0,0 +1,7 @@
+require 'sdoc' # and use your RDoc task the same way you used it before
+
+Rake::RDocTask.new(:sdoc) do |rdoc|
+  rdoc.rdoc_dir = 'doc/sdoc'
+  rdoc.options += %w{--fmt shtml -N --webcvs=http://github.com/aslakhellesoy/cucumber/blob/v0.3.96/%s --title "Cucumber API" --threads 4 --main README --exclude cucumber/parser lib}
+  rdoc.template = 'direct' # lighter template used on railsapi.com
+end

data/lib/README.rdoc

@@ -0,0 +1,12 @@
+= Cucumber API
+
+This is the public API of Cucumber. The public API includes the classes, modules
+and methods you can use if you are a user of Cucumber. It also applies to you if
+you're developing a 3rd party tool that integrates with Cucumber.
+
+== Internal API
+
+Cucumber has more classes, modules and methods than what you can see in the public
+API. If you decide to dive into the source code and make use of an API that isn't
+part of this documentation - beware that this API might change at any time. If you
+want a particular internal API to be promoted to the public API - let us know.

data/lib/cucumber/ast/background.rb

@@ -2,7 +2,7 @@ require 'cucumber/ast/feature_element'
 
 module Cucumber
   module Ast
-    class Background
+    class Background #:nodoc:
       include FeatureElement
       attr_reader :feature_elements
 

data/lib/cucumber/ast/comment.rb

@@ -7,7 +7,7 @@ module Cucumber
     #
     # This gets parsed into a Comment with value <tt>"# Lorem ipsum\n# dolor sit amet\n"</tt>
     #
-    class Comment
+    class Comment #:nodoc:
       def initialize(value)
         @value = value
       end

data/lib/cucumber/ast/examples.rb

@@ -1,12 +1,13 @@
 module Cucumber
   module Ast
-    class Examples
-      def initialize(line, keyword, name, outline_table)
-        @keyword, @name, @outline_table = keyword, name, outline_table
+    class Examples #:nodoc:
+      def initialize(comment, line, keyword, name, outline_table)
+        @comment, @keyword, @name, @outline_table = comment, keyword, name, outline_table
       end
 
       def accept(visitor)
         return if $cucumber_interrupted
+        visitor.visit_comment(@comment) unless @comment.empty?
         visitor.visit_examples_name(@keyword, @name)
         visitor.visit_outline_table(@outline_table)
       end
@@ -20,7 +21,11 @@ module Cucumber
       end
 
       def to_sexp
-        [:examples, @keyword, @name, @outline_table.to_sexp]
+        sexp = [:examples, @keyword, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        sexp += [@outline_table.to_sexp]
+        sexp
       end
     end
   end

data/lib/cucumber/ast/feature.rb

@@ -1,7 +1,7 @@
 module Cucumber
   module Ast
     # Represents the root node of a parsed feature.
-    class Feature
+    class Feature #:nodoc:
       attr_accessor :file, :language
       attr_writer :features
       attr_reader :name

data/lib/cucumber/ast/feature_element.rb

@@ -1,7 +1,7 @@
 require 'enumerator'
 
 module Cucumber
-  module FeatureElement
+  module FeatureElement #:nodoc:
     attr_writer :feature
 
     def attach_steps(steps)

data/lib/cucumber/ast/features.rb

@@ -1,6 +1,6 @@
 module Cucumber
   module Ast
-    class Features
+    class Features #:nodoc:
       include Enumerable
 
       attr_reader :duration

data/lib/cucumber/ast/outline_table.rb

@@ -1,6 +1,6 @@
 module Cucumber
   module Ast
-    class OutlineTable < Table
+    class OutlineTable < Table #:nodoc:
       def initialize(raw, scenario_outline)
         super(raw)
         @scenario_outline = scenario_outline
@@ -44,7 +44,7 @@ module Cucumber
         @scenario_outline.visit_scenario_name(visitor, row)
       end
 
-      class ExampleRow < Cells
+      class ExampleRow < Cells #:nodoc:
         attr_reader :scenario_outline # https://rspec.lighthouseapp.com/projects/16211/tickets/342
 
         def create_step_invocations!(scenario_outline)

data/lib/cucumber/ast/py_string.rb

@@ -16,7 +16,7 @@ module Cucumber
     #
     # Note how the indentation from the source is stripped away.
     #
-    class PyString
+    class PyString #:nodoc:
       def self.default_arg_name
         "string"
       end

data/lib/cucumber/ast/scenario.rb

@@ -2,7 +2,7 @@ require 'cucumber/ast/feature_element'
 
 module Cucumber
   module Ast
-    class Scenario
+    class Scenario #:nodoc:
       include FeatureElement
       
       attr_reader :name, :line

data/lib/cucumber/ast/scenario_outline.rb

@@ -1,9 +1,9 @@
 module Cucumber
   module Ast
-    class ScenarioOutline
+    class ScenarioOutline #:nodoc:
       include FeatureElement
 
-      module ExamplesArray
+      module ExamplesArray #:nodoc:
         def accept(visitor)
           return if $cucumber_interrupted
           each do |examples|
@@ -24,13 +24,14 @@ module Cucumber
         @steps = StepCollection.new(steps)
 
         @examples_array = example_sections.map do |example_section|
-          examples_line       = example_section[0]
-          examples_keyword    = example_section[1]
-          examples_name       = example_section[2]
-          examples_matrix     = example_section[3]
+          examples_comment    = example_section[0]
+          examples_line       = example_section[1]
+          examples_keyword    = example_section[2]
+          examples_name       = example_section[3]
+          examples_matrix     = example_section[4]
 
           examples_table = OutlineTable.new(examples_matrix, self)
-          Examples.new(examples_line, examples_keyword, examples_name, examples_table)
+          Examples.new(examples_comment, examples_line, examples_keyword, examples_name, examples_table)
         end
         @examples_array.extend(ExamplesArray)
 

data/lib/cucumber/ast/step.rb

@@ -3,7 +3,7 @@ require 'cucumber/step_match'
 
 module Cucumber
   module Ast
-    class Step
+    class Step #:nodoc:
       attr_reader :line, :keyword, :name, :multiline_arg
       attr_writer :step_collection, :options
       attr_accessor :feature_element, :exception

data/lib/cucumber/ast/step_collection.rb

@@ -1,7 +1,7 @@
 module Cucumber
   module Ast
     # Holds an Array of Step or StepDefinition
-    class StepCollection
+    class StepCollection #:nodoc:
       include Enumerable
       
       def initialize(steps)

data/lib/cucumber/ast/step_invocation.rb

@@ -2,7 +2,7 @@ require 'cucumber/step_match'
 
 module Cucumber
   module Ast
-    class StepInvocation
+    class StepInvocation #:nodoc:
       attr_writer :step_collection, :background
       attr_reader :name, :matched_cells, :status, :reported_exception
       attr_accessor :exception