Merge pull request praxis#171 from rightscale/292_missing_example_for…

…_collections

Include full example for Collections

lib/attributor/types/collection.rb

@@ -108,7 +108,10 @@ def self.dump(values, **opts)
     def self.describe(shallow = false, example: nil)
       hash = super(shallow)
       hash[:options] = {} unless hash[:options]
-      member_example = example.first if example
+      if example
+        hash[:example] = example
+        member_example = example.first
+      end
       hash[:member_attribute] = member_attribute.describe(true, example: member_example)
       hash
     end

spec/types/collection_spec.rb

@@ -312,6 +312,7 @@
     subject(:described) { type.describe(example: example) }
     it 'includes the member_attribute' do
       expect(described).to have_key(:member_attribute)
+      expect(described).not_to have_key(:example)
       expect(described[:member_attribute]).not_to have_key(:example)
     end
 
@@ -322,6 +323,10 @@
         expect(described[:member_attribute]).to have_key(:example)
         expect(described[:member_attribute]).to eq(type.member_attribute.describe(example: example.first))
       end
+      it 'includes the incoming example for the whole collection as well' do
+        expect(described).to have_key(:example)
+        expect(described[:example]).to eq(example)
+      end
     end
   end