macros4cuke 0.2.11 → 0.2.12

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.12 / 2013-05-01
+* [CHANGE] Method `Macros4Cuke#compile` raise an `EmptyArgumentError` exception when a line contains an empty or blank argument.
+* [CHANGE] File `template-engine_spec.rb`: Added an example for error case mentioned in previous line.
+
 ## 0.2.11 / 2013-05-01
 * [CHANGE] File `macros4cuke.gemspec`: Removed dependency on Rake.
 

data/lib/macros4cuke/constants.rb

@@ -3,7 +3,7 @@
 
 module Macros4Cuke # Module used as a namespace
 	# This constant keeps the current version of the gem.
-	Version = '0.2.11'
+	Version = '0.2.12'
   
   Description = "Macros for Cucumber"
 	

data/lib/macros4cuke/exceptions.rb

@@ -34,6 +34,15 @@ class UnreachableSubstepArgument < Macros4CukeError
 end # class
 
 
+
+# Raised when a sub-step has an empty or blank argument name.
+class EmptyArgumentError < Macros4CukeError
+  def initialize(aText)
+    super("An empty or blank argument occurred in '#{aText}'.")
+  end
+end # class
+
+
 # Raised when one invokes a macro-step with an unknown phrase. 
 class UnknownMacroError < Macros4CukeError
   def initialize(aPhrase)

data/lib/macros4cuke/template-engine.rb

@@ -2,6 +2,7 @@
 # Purpose: Implementation of the MacroStep class.
 
 require 'strscan' # Use the StringScanner for lexical analysis.
+require_relative 'exceptions' # Load the 
 
 module Macros4Cuke # Module used as a namespace
 
@@ -52,18 +53,21 @@ public
 end # class
 
 
+# A very simple implementation of a templating engine. 
 class TemplateEngine
   # The original text of the template is kept here.
   attr_reader(:source)
   
   # Constructor.
-  # [aSourceTemplate]
+  # [aSourceTemplate] the template source text. It may contain zero or tags enclosed between chevrons <...>.
   def initialize(aSourceTemplate)
     @source = aSourceTemplate
     @representation = compile(aSourceTemplate)
   end
 
 public
+  # [aContextObject] context object to get actual values (when not present in the Hash parameter).
+  # [theLocals] a Hash with pairs of the form: argument name => actual value.
   def render(aContextObject = nil, theLocals)
     return '' if @representation.empty?
     context = aContextObject.nil? ? Object.new : aContextObject
@@ -88,6 +92,8 @@ public
 
   # Class method. Parse the given line text.
   # Returns an array of couples.
+  # Couples are of the form:
+  # [:static, text] or [:dynamic, text]
   def self.parse(aTextLine)
     scanner = StringScanner.new(aTextLine)
     result = []
@@ -134,13 +140,21 @@ private
     input_lines = aSourceTemplate.split(/\r\n?|\n/)
     
     # Parse the input text into raw data.
-    raw_lines = input_lines.map { |line| self.class.parse(line) }
+    raw_lines = input_lines.map do |line| 
+      line_items = self.class.parse(line)
+      line_items.each do |(kind, text)|
+        # A tag text cannot be empty nor blank
+        raise EmptyArgumentError.new(line.strip) if (kind == :dynamic) && text.strip.empty?
+      end
+      
+      line_items
+    end
     
     compiled_lines = raw_lines.map { |line| compile_line(line) }
     return compiled_lines.flatten()
   end
   
-  
+  # Convert the array of raw entries into full-fledged template elements.
   def compile_line(aRawLine)
     line_rep = aRawLine.map { |couple| compile_couple(couple) }
     line_rep << EOLRep.new

data/spec/macros4cuke/template-engine_spec.rb

@@ -155,6 +155,13 @@ SNIPPET
       instance = TemplateEngine.new ''
       instance.source.should be_empty
     end
+    
+    it "should complain when a placeholder is empty or blank" do
+      text_w_empty_arg = sample_template.sub(/userid/, '')
+      error_message = %Q|An empty or blank argument occurred in 'And I fill in "Username" with "<>"'.|
+      lambda { TemplateEngine.new text_w_empty_arg }.should raise_error(Macros4Cuke::EmptyArgumentError, error_message)      
+      
+    end
   end
   
   context "Provided services" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: macros4cuke
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.2.12
   prerelease: 
 platform: ruby
 authors: