Added atribute aliases

lib/mapper/handler/entity/denormalizer.rb

@@ -23,16 +23,25 @@ def denormalize(source, type, context = nil)
               entity = type.factory.create(type, source, context)
               type.attributes.values.each do |attribute|
                 next if attribute.virtual
-                [attribute.name.to_s, attribute.name].each do |name|
+                candidate_names(attribute).each do |name|
                   next unless source.key?(name)
-                  set_object_attribute(entity, name, source[name])
+                  value = source[name]
+                  break set_object_attribute(entity, attribute.name, value)
                 end
               end
               entity
             end
 
             private
 
+            # @param [AMA::Entity::Mapper::Type::Attribute] attribute
+            # @return [Array<Symbol, String>]
+            def candidate_names(attribute)
+              [attribute.name, *attribute.aliases].flat_map do |candidate|
+                [candidate, candidate.to_s]
+              end
+            end
+
             # @param [Hash] source
             # @param [AMA::Entity::Mapper::Type] type
             # @param [AMA::Entity::Mapper::Context] context

lib/mapper/type/attribute.rb

@@ -55,6 +55,9 @@ class Attribute
           # @!attribute values
           #   @return [Array<Object>]
           attr_accessor :values
+          # @!attribute aliases
+          #   @return [Array<Symbol>]
+          attr_accessor :aliases
 
           handler_namespace Handler::Attribute
 
@@ -71,7 +74,8 @@ def self.defaults
               default: nil,
               nullable: false,
               values: [],
-              validator: nil
+              validator: nil,
+              aliases: []
             }
           end
 

test/suite/unit/mapper/handler/entity/denormalizer.spec.rb

@@ -17,10 +17,12 @@
     {
       value: double(
         name: :value,
+        aliases: %i[item entity],
         virtual: false
       ),
       virtual: double(
         name: :virtual,
+        aliases: [],
         virtual: true
       )
     }
@@ -93,6 +95,27 @@
       result = denormalizer.denormalize(data, type, context)
       expect(result.instance_variables).not_to include(:@virtual)
     end
+
+    it 'uses attribute aliases' do
+      data = { item: 12 }
+      result = denormalizer.denormalize(data, type, context)
+      expect(result.instance_variables).to include(:@value)
+      expect(result.instance_variable_get(:@value)).to eq(data[:item])
+    end
+
+    it 'uses attribute aliases in eabsence of exact match' do
+      data = { entity: 12 }
+      result = denormalizer.denormalize(data, type, context)
+      expect(result.instance_variables).to include(:@value)
+      expect(result.instance_variable_get(:@value)).to eq(data[:entity])
+    end
+
+    it 'uses attribute aliases in order of their declaration' do
+      data = { item: 12, entity: 13 }
+      result = denormalizer.denormalize(data, type, context)
+      expect(result.instance_variables).to include(:@value)
+      expect(result.instance_variable_get(:@value)).to eq(data[:item])
+    end
   end
 
   describe '.wrap' do