Merge pull request #54 from rlburkes/master

Allow unwrap option to whitelist keys.

README.md

@@ -45,6 +45,16 @@ Gyoku.xml({ :camel_case => "key" }, { :key_converter => :camelcase })
 # => "<CamelCase>key</CamelCase>"
 ```
 
+Custom key converters. You can use a lambda/Proc to provide customer key converters.
+This is a great way to leverage active support inflections for domain specific acronyms.
+
+``` ruby
+# Use camelize lower which will hook into active support if installed.
+Gyoku.xml({ acronym_abc: "value" }, key_converter: lambda { |key| key.camelize(:lower) })
+# => "<acronymABC>value</acronymABC>"
+
+```
+
 Hash key Strings are not converted and may contain namespaces.
 
 ``` ruby
@@ -152,6 +162,42 @@ Gyoku.xml(
 # => "<foo name=\"bar\">gyoku</foo><foo name=\"baz\" some=\"attr\">rocks!</foo>"
 ```
 
+Unwrapping Arrays. You can specify an optional `unwrap` argument to modify the default Array
+behavior. `unwrap` accepts a boolean flag (false by default) or an Array whitelist of keys to unwrap.
+``` ruby
+# Default Array behavior
+Gyoku.xml({
+  "foo" => [
+    {:is => 'great' },
+    {:is => 'awesome'}
+  ]
+})
+# => "<foo><is>great</is></foo><foo><is>awesome</is></foo>"
+
+# Unwrap Array behavior
+Gyoku.xml({
+  "foo" => [
+    {:is => 'great' },
+    {:is => 'awesome'}
+  ]
+}, unwrap: true)
+# => "<foo><is>great</is><is>awesome</is></foo>"
+
+# Unwrap Array, whitelist.
+# foo is not unwrapped, bar is.
+Gyoku.xml({
+  "foo" => [
+    {:is => 'great' },
+    {:is => 'awesome'}
+  ],
+  "bar" => [
+      {:is => 'rad' },
+      {:is => 'cool'}
+  ]
+}, unwrap: [:bar])
+# => "<foo><is>great</is></foo><foo><is>awesome</is></foo><bar><is>rad</is><is>cool</is></bar>"
+```
+
 Naturally, it would ignore :content! if tag is self-closing:
 
 ``` ruby

lib/gyoku/array.rb

@@ -13,7 +13,7 @@ class Array
     def self.to_xml(array, key, escape_xml = true, attributes = {}, options = {})
 
       self_closing = options.delete(:self_closing)
-      unwrap = options[:unwrap] || false 
+      unwrap =  unwrap?(options.fetch(:unwrap, false), key)
 
       iterate_with_xml array, key, attributes, options do |xml, item, attrs, index|
         if self_closing
@@ -44,9 +44,9 @@ def self.to_xml(array, key, escape_xml = true, attributes = {}, options = {})
     def self.iterate_with_xml(array, key, attributes, options, &block)
 
       xml = Builder::XmlMarkup.new
-      unwrap = options[:unwrap] || false
+      unwrap =  unwrap?(options.fetch(:unwrap, false), key)
 
-      if (unwrap)
+      if unwrap
         xml.tag!(key) { iterate_array(xml, array, attributes, &block) }
       else
         iterate_array(xml, array, attributes, &block)
@@ -85,5 +85,9 @@ def self.tag_attributes(attributes, index)
       end
     end
 
+    def self.unwrap?(unwrap, key)
+      unwrap.kind_of?(::Array) ? unwrap.include?(key.to_sym) : unwrap
+    end
+
   end
 end