macros4cuke 0.2.16 → 0.2.17

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.2.17 / 2013-05-05
+* [CHANGE] File `engine_spec.rb`: Added more RSpec examples. SimpleCov code coverage raised to more than 96%.
+* [CHANGE] Added section in README.md
+
+
 ## 0.2.16 / 2013-05-04
 * [FEATURE] Added dependency to SimpleCov. It is used to measure test code coverage (the combination of Cucumber and RSpec result in 95.9% code coverage).
 * [CHANGE] File `macro-step-support_spec.rb`: Added one RSpec example

data/README.md

@@ -245,6 +245,22 @@ Here are few observations worth noticing:
 the value "Main Street, 22".  
 - Data rows don't have to follow strictly the order of the arguments in the sub-step sequence. 
 
+## With great power comes great responsibility. ##
+_Stan Lee_  
+
+Our experience is that macro-steps change deeply the way one designs and writes feature files.  
+Macro-steps are most useful in UI-testing (e.g. with tools like Capybara) because they help to close
+ the gap between the user's intent and the low-level user interface actions.   
+In addition __Macros4Cuke__ allows advanced users to craft their own steps without having to program step definitions.
+This last argument becomes important in the context of user acceptance testing, a domain where the assumption that
+ every tester is also Rubyist is -alas!- far from the truth.
+
+ 
+Macros with Cucumber is highly debated topic, so it is always wise to know what other people say about it:  
+[Support for Macros] (https://github.com/cucumber/gherkin/issues/178)  
+[Substeps - macro request for the nth time] (http://grokbase.com/t/gg/cukes/133ey063b8/cucumber-substeps-macro-request-for-the-nth-time)
+
+
 Copyright
 ---------
 Copyright (c) 2013, Dimitri Geshef. Macros4Cuke is released under the MIT License see [LICENSE.txt](https://github.com/famished-tiger/Macros4Cuke/blob/master/LICENSE.txt) for details.

data/lib/macros4cuke/constants.rb

@@ -3,7 +3,7 @@
 
 module Macros4Cuke # Module used as a namespace
 	# The version number of the gem.
-	Version = '0.2.16'
+	Version = '0.2.17'
 
   # Brief description of the gem.
   Description = "Macros for Cucumber"

data/spec/macros4cuke/templating/engine_spec.rb

@@ -134,6 +134,18 @@ SNIPPET
       error_message = "Missing closing chevron '>'."
       lambda { Engine::parse(sample_text) }.should raise_error(StandardError, error_message)
     end
+    
+    it  "should complain if a text misses an opening chevron" do
+      sample_text = 'begin <some_tag> > end'
+      error_message = "Missing opening chevron '<'."
+      lambda { Engine::parse(sample_text) }.should raise_error(StandardError, error_message)
+    end
+    
+    it  "should complain if a text ha&s nested opening chevrons" do
+      sample_text = 'begin <<some_tag> > end'
+      error_message = "Nested opening chevron '<'."
+      lambda { Engine::parse(sample_text) }.should raise_error(StandardError, error_message)
+    end    
 
   end # context
 
@@ -166,12 +178,22 @@ SNIPPET
   context "Provided services" do
 
     it "should know the variable(s) it contains" do
+      # Case using the sample template
       subject.variables == [:userid, :password]
 
       # Case of an empty source template text
       instance = Engine.new ''
       instance.variables.should be_empty
     end
+  
+  
+    it "should ignore variables/placeholders in comments" do
+      substeps = "  # Comment 1 <miscellaneous>\n" + sample_template
+      substeps += "  #\n Comment 2 <haphazard>"
+      instance = Engine.new substeps
+      subject.variables == [:userid, :password]
+    end
+
 
     it "should render the text given the actuals" do
       locals = {'userid' => "johndoe"}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: macros4cuke
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.2.17
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-04 00:00:00.000000000 Z
+date: 2013-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber