Changed :transform to :map

Author: jarrett

lib/erb_parser.rb

@@ -9,13 +9,13 @@ module ErbParser
   def self.parse(str, options = {})
     result = ParsedErb.new TreetopRunner.run(str)
 
-    if options[:transform]
+    if options[:transform] or options[:map]
       result.tokens.map do |elem|
         case elem
         when String
           elem
         when ErbTag
-          options[:transform].call(elem)
+          (options[:transform] || options[:map]).call(elem)
         end
       end.join
     else

readme.md

@@ -35,23 +35,26 @@ Pass in an ERB template as a string:
 
 The above usage sets `result` to an array of tokens.
 
-## The `:transform` option
+## The `:map` option
 
 Often, you'll want to parse an ERB template, apply some transformation function to all
-the ERB tags, and get back a new string. That's what the `:transform` option is for:
+the ERB tags, and get back a new string. That's what the `:map` option is for:
 
     result = ErbParser.parse(
       'This is a<% TSET %>',
-      :transform => lambda { |t| t.ruby_code.reverse.downcase }
+      :map => lambda { |t| t.ruby_code.reverse.downcase }
     )
 
     # 'This is a test '
     puts result
 
-As in the above example, the `:transform` option must be a proc. The proc will be passed
+As in the above example, the `:map` option must be a proc. The proc will be passed
 an `ErbTag` as its only parameter. It must return a string. The returned string will be
 inserted into the output where the ERB tag used to be.
 
+`:map` was called `:transform` in version 0.0.0. `:transform` is still available but
+deprecated.
+
 ## XML/HTML usage synopsis
 
 Alternatively, you may pass in an XML/HTML document or fragment and have the ERB tags

test/api_test.rb

@@ -57,6 +57,8 @@ def test_complex_document
 
   def test_transform_option
     str = 'foo<% bar %>baz'
+    result = ErbParser.parse str, :map => lambda { |tag| tag.ruby_code.upcase.reverse }
+    assert_equal 'foo RAB baz', result
     result = ErbParser.parse str, :transform => lambda { |tag| tag.ruby_code.upcase.reverse }
     assert_equal 'foo RAB baz', result
   end