flatpack_core 1.1 → 1.3

data/flatpack_core.gemspec

@@ -16,6 +16,6 @@ Gem::Specification.new do |gem|
   gem.version       = Flatpack::Core::VERSION
   gem.add_dependency('json', '~> 1.7')
   gem.add_dependency('uuidtools', '~> 2.1')
-  gem.add_dependency('activesupport', "~> 2.3")
+  gem.add_dependency('activesupport', "= 2.3.8")
   gem.add_development_dependency "rspec", "~> 2.6"
 end

data/lib/flatpack/core/base_has_uuid.rb

@@ -41,6 +41,11 @@ module Flatpack
         name = self.class.name.gsub(/^.*::/,'')
         name[0,1].downcase + name[1..-1]
       end
+
+      # Equality should be based solely on uuid
+      def <=>(other)
+        @uuid <=> other.uuid
+      end
       
       def class_for_property(property)
         klass=self.class

data/lib/flatpack/core/packer.rb

@@ -4,92 +4,106 @@ require 'json'
 module Flatpack
   module Core
     class Packer
-      
+
       include MapInitialize
-      
+
       attr_accessor :verbose, :pretty
-      
+
       # Generate a FlatPack JSON string from the given entity
       def pack(entity)
         return {} unless entity
-          
+
         @uuid_stack = []
         @all_entities = {}
         @data = {}
-          
+
         recursive_pack(entity)
-        
+
         json = {
-          :data => @data,
-          :value => entity.uuid
+            :data => @data,
+            :value => entity.uuid
         }
         json = @pretty ? JSON.pretty_generate(json) : json.to_json
-        
+
         if(@verbose)
           puts "*** Serializing #{entity.entity_name} to FlatPack ***"
           puts json
         end
-        
+
         json
       end
-      
+
       private
-      
+
       def recursive_pack(entity)
-        # we only proceed if the entity has a uuid property, 
+        # we only proceed if the entity has a uuid property,
         # and we haven't seen it before
         uuid = entity.uuid
+
         return if !entity.respond_to?(:uuid) or @all_entities.keys.include?(uuid)
-        
+
         @all_entities[uuid] = entity
         parent_uuid = @uuid_stack.length > 0 ? @uuid_stack.last : nil
         @uuid_stack.push(uuid)
-        
-        # walk through our properties
         json = entity.properties
+
+        # if the entity has some embedded properties, we walk throught them
+        if(entity.class.const_defined?(:EMBEDDED_PROPERTY_NAMES))
+          entity.class::EMBEDDED_PROPERTY_NAMES.each do |embedded_property_name|
+            embedded = entity.send(embedded_property_name)
+
+            # Each property of the embedded value should be added to our top level JSON
+            if(embedded.class.const_defined?(:PROPERTY_NAMES))
+              embedded.class::PROPERTY_NAMES.each do |name|
+                json[name] = embedded.send(name)
+              end
+            end
+          end
+        end
+
+        # walk through our properties
         json.keys.each do |name|
           camel_name = name.to_s.camelize
           camel_name = camel_name[0,1].downcase + camel_name[1..-1]
-
           value = json[name]
           uuid_name = "#{camel_name}Uuid"
-          
-          # The name we're working with will be replaced with a 
+
+          # The name we're working with will be replaced with a
           # properly cased name or uuid reference
           json.delete(name)
-          
+
           # property is another entity
           if(value.respond_to?(:uuid))
             recursive_pack(value)
             json[uuid_name] = value.uuid
-          
-          # property is a collection of (potentially) other entities
+
+            # property is a collection of (potentially) other entities
           elsif(value.is_a?(Array))
-            
+
             # we'll recurse down to each referenced value
             value.each do |referenced_value|
               recursive_pack(referenced_value)
               referenced_value.uuid
             end
-            
+
             # and add our uuid reference
             json[uuid_name] = value.map {|v| v.uuid}
-            
-          # property is a plain old property
+
+            # property is a plain old property
           else
-            # TODO how to handle local..At dates?  
+            # TODO how to handle local..At dates?
             # Pass a timezone into the pack function as an option?
 
             json[camel_name] = value
           end
         end
-        
+
         # add our parent uuid reference if neccessary
         if parent_uuid
           parent = @all_entities[parent_uuid]
           json["#{parent.entity_name}Uuid"] = parent_uuid
         end
-        
+
         # add the resulting json to the correct bucket in our data hash
         bucket = @data[entity.entity_name]
         if(!bucket)
@@ -97,10 +111,10 @@ module Flatpack
           @data[entity.entity_name] = bucket
         end
         bucket.push(json)
-        
+
         @uuid_stack.pop
       end
-      
+
     end
   end
 end

data/lib/flatpack/core/unpacker.rb

@@ -3,20 +3,20 @@ require 'active_support/inflector'
 module Flatpack
   module Core
     class Unpacker
-      
+
       include MapInitialize
-      
+
       attr_accessor :verbose, :entity_module
 
       # Returns a Reified FlatPack entity from the given JSON data
       def unpack(json_map)
         @all_entities = {}
-        
+
         if(@verbose)
           puts "** Deserializing entity from FlatPack **"
           puts JSON.pretty_generate(json_map)
         end
-        
+
         # Make a first pass through the data to ensure stub entities exist
         uuid_to_data = {}
         (json_map['data'] || []).each do |entity_name, entities|
@@ -29,59 +29,74 @@ module Flatpack
             end
           end
         end
-        
+
         # Then ingest
         uuid_to_data.each { |uuid, data| ingest_item(uuid, data) }
-          
+
         # Return the unpacked entities corresponding to those in the value section
         value = json_map['value']
         value.is_a?(Array) ? value.map{|v| @all_entities[v]} : @all_entities[value]
       end
-      
+
       private
-      
+
       # ingests the given data into the entity associated with the given uuid
       def ingest_item(uuid, data)
         entity = @all_entities[uuid]
         collection_key = entity.entity_name.underscore.pluralize
         reified_properties = {}
-          
+        embedded_entities = [];
+
+        # if this entity has some embedded properties, we'll associate each with
+        # a new instance of the defined type
+        if(entity.class.const_defined?(:EMBEDDED_PROPERTY_NAMES))
+          entity.class::EMBEDDED_PROPERTY_NAMES.each do |embedded_property_name|
+            klass = entity.class_for_property(embedded_property_name)
+            setter = "#{embedded_property_name}="
+            if(entity.respond_to?(setter))
+              embedded_entity = klass.new
+              entity.send(setter, embedded_entity)
+              embedded_entities.push(embedded_entity)
+            end
+          end
+        end
+
         data.each do |key, value|
-            
+
           # fooBarsUuid -> foo_bars
           key = key.underscore
-          
+
           # If the key name ends in _date or _at, we assume this is a date property
           if(key.end_with?('_date') or key.end_with?('_at'))
             reified_properties[key] = Time.parse(value).utc
           end
-          
+
           # The value is referencing another entity or collection of entities
           if(key.end_with?('uuid'))
-            
+
             # foo_bar_uuid -> foo_bar
             key = key[0..-6]
-            
+
             if(value.is_a?(Array))
               reified_properties[key] = value.map { |uuid| @all_entities[uuid] }
-                
+
             else
               referent = @all_entities[value]
-             
+
               # If the referent doesn't exist, it's because the server has sent us a sparse
-              # payload with a dangling fooUuid reference.  We'll attempt to unpack this 
+              # payload with a dangling fooUuid reference.  We'll attempt to unpack this
               # reference using the type informtion encoded within each entity description
               unless referent
                 referent_class = entity.class_for_property(key)
                 referent = referent_class.new(:uuid => value) if referent_class
               end
-             
+
               # If a referent was not included in the payload, and no type information exists
               # for this property name, we simply drop the property
               next unless referent
-              
+
               reified_properties[key] = referent
-             
+
               # Find or create a collection in the referent to establish a bidirectional mapping.
               # For example a foo.bar property should contain a bar.foos collection.
               if(referent.respond_to?(collection_key))
@@ -93,32 +108,46 @@ module Flatpack
                     referent.send(collection_setter, collection)
                   end
                 end
-                collection.push(entity)
+                collection.push(entity) unless collection.include?(entity)
               end
             end
-            
-          # The value is just a plain old property
+
+            # The value is just a plain old property
           else
-            reified_properties[key] = value
+
+            # if the entity accepts a property with this key directly, we add it
+            if(entity.respond_to?(key))
+              reified_properties[key] = value
+
+              # otherwise, we attempt to set the property on to one of our
+              # embedded entity properties
+            else
+              embedded_entities.each do |embedded_entity|
+                setter = "#{key}=".to_sym
+                if embedded_entity.respond_to?(setter)
+                  embedded_entity.send(setter, value)
+                end
+              end
+            end
           end
         end
-        
+
         entity.set_properties(reified_properties)
       end
-      
+
       # Finds the existing entity associated with the given uuid in the local
       # entity store, or stores and returns a new one
       def allocate_or_get_entity(entity_name, uuid)
         entity = @all_entities[uuid]
         return entity if entity
-        
+
         klass = entity_class_for_name(entity_name)
         if(klass != nil)
           @all_entities[uuid] = klass.new({:uuid => uuid})
         end
         klass
       end
-      
+
       # Finds the Ruby class associated with the given entity name
       def entity_class_for_name(name)
         class_name = "#{name[0,1].capitalize}#{name[1..-1]}"
@@ -134,7 +163,7 @@ module Flatpack
           puts "could not create class for name #{class_name}"
         end
 
-        result 
+        result
       end
     end
   end

data/lib/flatpack/core/version.rb

@@ -1,5 +1,5 @@
 module Flatpack
   module Core
-    VERSION = "1.1"
+    VERSION = "1.3"
   end
 end

data/spec/core_spec.rb

@@ -1,130 +1,153 @@
 require 'flatpack_core'
 
+class Merchant < Flatpack::Core::BaseHasUuid
+  attr_accessor :uuid, :merchant_locations;
+end
+
+class StreetAddress < Flatpack::Core::BaseHasUuid
+  PROPERTY_NAMES = [:address, :city, :state, :zip]
+  attr_accessor *PROPERTY_NAMES
+end
+
+class MerchantLocation < Flatpack::Core::BaseHasUuid
+  PROPERTY_NAMES = [:uuid, :merchant]
+  attr_accessor *PROPERTY_NAMES
+
+  EMBEDDED_PROPERTY_NAMES = [
+      :street_address
+  ]
+  attr_accessor *EMBEDDED_PROPERTY_NAMES
+
+  TYPE_MAP = {
+      :street_address => StreetAddress,
+  }
+end
+
 class TestEntity < Flatpack::Core::BaseHasUuid
   PROPERTY_NAMES = [
-    :one,
-    :two,
-    :test_sub_entities,
-    :test_entities,
-    :test_entity
+      :one,
+      :two,
+      :test_sub_entities,
+      :test_entities,
+      :test_entity
   ]
   attr_accessor *PROPERTY_NAMES
 end
 
 class TestSubEntity < TestEntity
   PROPERTY_NAMES = [
-    :three
+      :three
   ]
   attr_accessor *PROPERTY_NAMES
 end
 
 describe Flatpack::Core do
-  
+
   before(:all) do
     @flatpack = Flatpack::Core::Flatpack.new({
-      :pretty => true, 
-      :verbose => true 
-    })
+                                                 :pretty => true,
+                                                 :verbose => true
+                                             })
   end
-  
+
   it "serializes a simple entity" do
-      
+
     root = TestEntity.new({
-      :one => 'first',
-      :two => 'second'
-    })
-    
+                              :one => 'first',
+                              :two => 'second'
+                          })
+
     json = @flatpack.packer.pack(root)
-    
+
     map = JSON.parse(json)
     map['data'].keys.length.should eq(1)
     entities = map['data']['testEntity']
     entities.length.should eq(1)
     entity = entities[0]
-    
+
     entity.keys.length.should eq(3)
     entity['one'].should eq('first')
     entity['two'].should eq('second')
     entity['uuid'].should be_true
   end
-  
+
   it "serializes an entity with forward references" do
-      
+
     root = TestEntity.new({
-      :one => 'first',
-      :two => [
-        TestSubEntity.new({:one => 'first', :three => 'third'}), 
-        TestSubEntity.new({:one => 'first', :three => 'third'})
-      ]
-    })
-    
+                              :one => 'first',
+                              :two => [
+                                  TestSubEntity.new({:one => 'first', :three => 'third'}),
+                                  TestSubEntity.new({:one => 'first', :three => 'third'})
+                              ]
+                          })
+
     json = @flatpack.packer.pack(root)
-    
+
     map = JSON.parse(json)
-    
+
     map['data'].keys.length.should eq(2)
-      
+
     # we should have 1 TestEntity at our root
     root_entities = map['data']['testEntity']
     root_entities.length.should eq(1)
     root_entity = root_entities[0]
     root_entity['one'].should eq('first')
-    
+
     # our collection reference at :two should have been flattened away
     root_entity['two'].should be_nil
     root_entity_uuid = root_entity['uuid']
-    
+
     # two TestSubEntities under our root
     sub_entities = map['data']['testSubEntity']
     sub_entities.length.should eq(2)
     sub_entity_one = sub_entities[0]
     sub_entity_two = sub_entities[1]
-    
+
     # sub entities should have a reference to the parent
     sub_entity_one['testEntityUuid'].should eq(root_entity_uuid)
     sub_entity_two['testEntityUuid'].should eq(root_entity_uuid)
-      
+
     # and 3 additional properties
     sub_entity_one.length.should eq(4)
     sub_entity_one['one'].should eq('first')
     sub_entity_one['three'].should eq('third')
     sub_entity_one['two'].should be_nil
-    
+
     sub_entity_two.length.should eq(4)
     sub_entity_two['one'].should eq('first')
     sub_entity_two['three'].should eq('third')
     sub_entity_two['two'].should be_nil
   end
-  
+
   it "serializes an entity with back reference" do
-    
+
     sibling_one = TestEntity.new({
-      :one => 'first_sibling'
-    })
-    
+                                     :one => 'first_sibling'
+                                 })
+
     sibling_two = TestEntity.new({
-      :one => 'second_sibling',
-      :two => sibling_one
-    })
-    
+                                     :one => 'second_sibling',
+                                     :two => sibling_one
+                                 })
+
     json = @flatpack.packer.pack(sibling_two)
-    
+
     map = JSON.parse(json)
-    
+
     map['data'].keys.length.should eq(1)
     entities = map['data']['testEntity']
     entities.each do |e|
-      if(e['uuid'].eql?(sibling_one.uuid.to_s)) 
+      if(e['uuid'].eql?(sibling_one.uuid.to_s))
         e['testEntityUuid'].should eq(sibling_two.uuid.to_s)
       else
         e['testEntityUuid'].should be_nil
       end
     end
-      
+
   end
-  
+
   it "de-serializes a simple entity" do
-    
+
     json = '{'\
       '"value": "b2197fc8-42df-4d8c-9890-0f37a4f99fc7",'\
       '"data": {'\
@@ -138,17 +161,17 @@ describe Flatpack::Core do
        ']'\
       '}'\
     '}'
-    
+
     # the unpacking should succeed even when an unknown
     # entity type (unknownEntity) is present
     entity = @flatpack.unpacker.unpack(JSON.parse(json))
-    
+
     entity.one.should eq('first')
     entity.two.should eq('second')
     entity.uuid.should eq('b2197fc8-42df-4d8c-9890-0f37a4f99fc7')
-    
+
   end
-  
+
   it "de-serializes an entity with a collection reference" do
     json = '{'\
       '"value": "d1c958ba-e6ea-4b12-8335-347289e404ac",'\
@@ -175,21 +198,73 @@ describe Flatpack::Core do
         ']'\
       '}'\
     '}'\
-    
+
     entity = @flatpack.unpacker.unpack(JSON.parse(json))
-    
+
     entity.uuid.should eq('d1c958ba-e6ea-4b12-8335-347289e404ac')
     entity.one.should eq('first')
-    
+
     # entity should have both sub entities within the test_entities property
     entity.test_sub_entities.length.should eq(2)
     entity.test_sub_entities[0].three.should eq('third')
     entity.test_sub_entities[0].one.should eq('first')
     entity.test_sub_entities[1].three.should eq('third')
     entity.test_sub_entities[1].one.should eq('first')
-    
+
     entity.test_sub_entities[0].test_entity.uuid.should eq('d1c958ba-e6ea-4b12-8335-347289e404ac')
-    
   end
-  
+
+  it "deserializes a complex object graph" do
+    json = File.open("#{File.dirname(__FILE__)}/merchant.json", "r").read
+    merchant = @flatpack.unpacker.unpack(JSON.parse(json))
+
+    # ensure we have the proper number of merchant locations
+    merchant.merchant_locations.size.should eq(4)
+
+    # with the proper uuids...
+
+    merchant.merchant_locations.detect do |ml|
+      ml.uuid == 'e988f216-aca6-490d-ad45-4840e05da352'
+    end.should_not be_nil
+
+    merchant.merchant_locations.detect do |ml|
+      ml.uuid == '08ab924a-9742-4e9b-8444-ffc9b43f8566'
+    end.should_not be_nil
+
+    merchant.merchant_locations.detect do |ml|
+      ml.uuid == 'f77333aa-a66c-4944-9b95-53efc3657418'
+    end.should_not be_nil
+
+    merchant.merchant_locations.detect do |ml|
+      ml.uuid == '5f72a832-02af-4dd9-8b30-7cef87f37833'
+    end.should_not be_nil
+  end
+
+  it "tests embeddable properties" do
+    json = File.open("#{File.dirname(__FILE__)}/merchant_location.json", "r").read
+    location = @flatpack.unpacker.unpack(JSON.parse(json))
+
+    # no address information should be available directly on the location entity
+    location.respond_to?(:address).should be_false
+    location.respond_to?(:city).should be_false
+    location.respond_to?(:state).should be_false
+    location.respond_to?(:zip).should be_false
+
+    # instead, they should be within an embedded StreetAddress property
+    location.street_address.address.should eq("1 Embarcadero Center")
+    location.street_address.city.should eq("San Francisco")
+    location.street_address.state.should eq("CA")
+    location.street_address.zip.should eq("94111")
+
+    # now we'll pack our location back to JSON, which should fold the
+    # embedded address properties onto the location directly, then unpack
+    # that JSON again to ensure that the address information has been preserved
+    location = @flatpack.unpacker.unpack(JSON.parse(@flatpack.packer.pack(location)))
+    location.street_address.address.should eq("1 Embarcadero Center")
+    location.street_address.city.should eq("San Francisco")
+    location.street_address.state.should eq("CA")
+    location.street_address.zip.should eq("94111")
+
+  end
+
 end

data/spec/merchant.json

@@ -0,0 +1,94 @@
+{
+    "value": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+    "status_code": "200",
+    "data": {
+        "merchant": [
+            {
+                "merchantLocationsUuid": [
+                    "e988f216-aca6-490d-ad45-4840e05da352",
+                    "08ab924a-9742-4e9b-8444-ffc9b43f8566",
+                    "f77333aa-a66c-4944-9b95-53efc3657418",
+                    "5f72a832-02af-4dd9-8b30-7cef87f37833"
+                ],
+                "visitExpirationMinutes": 30,
+                "name": "The Melt (new)",
+                "updatedAt": "2012-09-17T20:33:02.000Z",
+                "pointsSignupBonus": 0,
+                "merchantCapabilitiesUuid": [
+
+                ],
+                "merchantState": "LIVE",
+                "headline": "Free Cheese is Awesome",
+                "createdAt": "2012-09-12T17:17:43.000Z",
+                "loyaltyType": "PUNCHCARD",
+                "uuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c"
+            }
+        ],
+        "merchantLocation": [
+            {
+                "longitude": -122.3994071,
+                "latitude": 37.795027,
+                "combinedAddress": "1 Embarcadero Center",
+                "merchantUuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+                "country": "US",
+                "state": "CA",
+                "address": "1 Embarcadero Center",
+                "timezone": "America/Los_Angeles",
+                "createdAt": "2012-09-12T17:17:44.000Z",
+                "city": "San Francisco",
+                "neighborhoodName": "San Francisco",
+                "zip": "94111",
+                "smsId": "melt1",
+                "uuid": "e988f216-aca6-490d-ad45-4840e05da352"
+            },
+            {
+                "longitude": -122.4001066,
+                "latitude": 37.7872407,
+                "combinedAddress": "115 New Montgomery St",
+                "merchantUuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+                "country": "US",
+                "state": "CA",
+                "address": "115 New Montgomery St",
+                "timezone": "America/Los_Angeles",
+                "createdAt": "2012-09-12T17:17:44.000Z",
+                "city": "San Francisco",
+                "neighborhoodName": "San Francisco",
+                "zip": "94105",
+                "smsId": "melt2",
+                "uuid": "08ab924a-9742-4e9b-8444-ffc9b43f8566"
+            },
+            {
+                "longitude": -122.3901921,
+                "latitude": 37.7897624,
+                "combinedAddress": "345 Spear St",
+                "merchantUuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+                "country": "US",
+                "state": "CA",
+                "address": "345 Spear St",
+                "timezone": "America/Los_Angeles",
+                "createdAt": "2012-09-12T17:17:44.000Z",
+                "city": "San Francisco",
+                "neighborhoodName": "San Francisco",
+                "zip": "94105",
+                "smsId": "melt3",
+                "uuid": "f77333aa-a66c-4944-9b95-53efc3657418"
+            },
+            {
+                "longitude": -122.170764,
+                "latitude": 37.4442964,
+                "combinedAddress": "180 El Camino Real",
+                "merchantUuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+                "country": "US",
+                "state": "California",
+                "address": "180 El Camino Real",
+                "timezone": "America/Los_Angeles",
+                "createdAt": "2012-09-12T17:17:44.000Z",
+                "city": "Palo Alto",
+                "neighborhoodName": "Palo Alto",
+                "zip": "94304",
+                "smsId": "melt4",
+                "uuid": "5f72a832-02af-4dd9-8b30-7cef87f37833"
+            }
+        ]
+    }
+}

data/spec/merchant_location.json

@@ -0,0 +1,24 @@
+{
+    "value": "e988f216-aca6-490d-ad45-4840e05da352",
+    "status_code": "200",
+    "data": {
+        "merchantLocation": [
+            {
+                "longitude": -122.3994071,
+                "latitude": 37.795027,
+                "combinedAddress": "1 Embarcadero Center",
+                "merchantUuid": "a7ae48c9-c0ad-4f2c-a0ca-484f2f5b351c",
+                "country": "US",
+                "state": "CA",
+                "address": "1 Embarcadero Center",
+                "timezone": "America/Los_Angeles",
+                "createdAt": "2012-09-12T17:17:44.000Z",
+                "city": "San Francisco",
+                "neighborhoodName": "San Francisco",
+                "zip": "94111",
+                "smsId": "melt1",
+                "uuid": "e988f216-aca6-490d-ad45-4840e05da352"
+            }
+        ]
+    }
+}

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: flatpack_core
 version: !ruby/object:Gem::Version 
-  hash: 13
+  hash: 9
   prerelease: false
   segments: 
   - 1
-  - 1
-  version: "1.1"
+  - 3
+  version: "1.3"
 platform: ruby
 authors: 
 - Joe Stelmach
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-09-28 00:00:00 +05:30
+date: 2012-10-09 00:00:00 +05:30
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -53,13 +53,14 @@ dependencies:
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - "="
       - !ruby/object:Gem::Version 
-        hash: 5
+        hash: 19
         segments: 
         - 2
         - 3
-        version: "2.3"
+        - 8
+        version: 2.3.8
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
@@ -100,6 +101,8 @@ files:
 - lib/flatpack/core/version.rb
 - lib/flatpack_core.rb
 - spec/core_spec.rb
+- spec/merchant.json
+- spec/merchant_location.json
 has_rdoc: true
 homepage: ""
 licenses: []
@@ -136,3 +139,5 @@ specification_version: 3
 summary: Write a gem summary
 test_files: 
 - spec/core_spec.rb
+- spec/merchant.json
+- spec/merchant_location.json