Introduce Product Resource

The Core API supports retrieval of products by its Product ID. This PR
introduces the new Product resource, along with child resources needed
to build the main Product object. These child resources include
Allergens, Ingredient, Dietary Tag.

This change addresses the need by:
* Introducing a CoreObject resource which can be used by all core (v2)
  objects
* Introducing a Product resource

Author: imRohan

lib/bls/core.rb

@@ -17,13 +17,20 @@
 require_relative "core/resources/api_error"
 require_relative "core/authorization/bearer"
 require_relative "core/resources/object"
+require_relative "core/resources/object_v2"
+require_relative "core/resources/allergen"
+require_relative "core/resources/dietary_tag"
+require_relative "core/resources/ingredient"
 require_relative "core/resources/inventory_level"
+require_relative "core/resources/nutrition_fact"
 require_relative "core/resources/order"
 require_relative "core/resources/order_item"
 require_relative "core/serializers/order_item_serializer"
 require_relative "core/resources/menu"
 require_relative "core/resources/menu_item"
 require_relative "core/serializers/menu_item_serializer"
+require_relative "core/resources/product"
+require_relative "core/resources/product_factory"
 require_relative "core/resources/recipient"
 require_relative "core/serializers/recipient_serializer"
 require_relative "core/version"

lib/bls/core/resources/allergen.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class Allergen < Bls::Core::ObjectV2; end
+  end
+end

lib/bls/core/resources/dietary_tag.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class DietaryTag < Bls::Core::ObjectV2; end
+  end
+end

lib/bls/core/resources/ingredient.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class Ingredient < Bls::Core::ObjectV2; end
+  end
+end

lib/bls/core/resources/nutrition_fact.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class NutritionFact < Bls::Core::ObjectV2; end
+  end
+end

lib/bls/core/resources/object_v2.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class ObjectV2 < Bls::Core::Object
+      def self.build_from_array(array)
+        array.map { |object| build(object) }
+      end
+
+      def resources_path
+        "#{api.base_url}/api/#{object_name.downcase}"
+      end
+
+      def resource_path
+        "#{api.base_url}/api/#{object_name.downcase}/#{id}"
+      end
+
+      def api
+        @api ||= Bls::Core::V2.build
+      end
+    end
+  end
+end

lib/bls/core/resources/product.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class Product < Bls::Core::ObjectV2
+      def object_name
+        "products"
+      end
+
+      def self.build_from_response(data)
+        factory = ProductFactory.new(data)
+        factory.create
+      end
+    end
+  end
+end

lib/bls/core/resources/product_factory.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Bls
+  module Core
+    class ProductFactory
+      attr_accessor :response
+
+      def initialize(response)
+        @response = response
+      end
+
+      def create
+        product = Product.build(response)
+        product.ingredients = ingredients
+        product.allergens = allergens
+        product.dietary_tags = dietary_tags
+        product.nutrition_facts = nutrition_facts
+        product
+      end
+
+      protected
+
+      def ingredients
+        Ingredient.build_from_array(response[:ingredients])
+      end
+
+      def allergens
+        Allergen.build_from_array(response[:allergens])
+      end
+
+      def dietary_tags
+        DietaryTag.build_from_array(response[:dietary_tags])
+      end
+
+      def nutrition_facts
+        as_packaged = NutritionFact.
+                      build_from_array(response[:nutrition_facts][:as_packaged])
+        as_cooked = NutritionFact.
+                    build_from_array(response[:nutrition_facts].
+                                     fetch(:as_cooked, []))
+        { as_packaged: as_packaged, as_cooked: as_cooked }
+      end
+    end
+  end
+end

lib/bls/core/testing/fake.rb

@@ -6,6 +6,26 @@ module Testing
       class Fake
         def self.configure(*); end
 
+        class Allergen
+          def self.create(code: "MILK", source: "ANCHOVY")
+            OpenStruct.new(code: code, source: source)
+          end
+        end
+
+        class DietaryTag
+          def self.create(tag: "PESCATARIAN")
+            OpenStruct.new(tag: tag)
+          end
+        end
+
+        class Ingredient
+          def self.create(code: "MILK", name: "ANCHOVY", quantity: 1,
+                          unit: "serving")
+            OpenStruct.new(code: code, name: name, quantity: quantity,
+                           unit: unit)
+          end
+        end
+
         class InventoryLevel
           def self.create(sku: "SKU1", date: Date.today.to_s,
                           distribution_center_name: "WEST_COAST",
@@ -56,6 +76,12 @@ def initialize(menu_item)
           end
         end
 
+        class NutritionFact
+          def self.create(code: "CALORIES", amount: 0, unit: "serving")
+            OpenStruct.new(code: code, amount: amount, unit: unit)
+          end
+        end
+
         class Recipient
           def self.new(name: nil, street1: nil, street2: nil, city: nil,
                        state: nil, zip: nil, zip4: nil, email: nil, phone: nil,
@@ -95,6 +121,15 @@ def self.new(sku:, quantity:, protein_sku:)
           end
         end
 
+        class Product
+          def self.new(code:, name:, status: "DRAFT", nutrition_facts: [])
+            OpenStruct.new(code: code, name: name, status: status,
+                           nutrition_facts: nutrition_facts,
+                           allergens: [Fake::Allergen.create],
+                           dietary_tags: [Fake::DietaryTag.create])
+          end
+        end
+
         def self.client
           Fake::Client.new
         end

spec/core/resources/product_factory_spec.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+RSpec.describe Bls::Core::ProductFactory do
+  describe "#create" do
+    it "assigns the ingredients to the Product" do
+      response = build_product_response
+      ingredient = Bls::Core::Ingredient.build(response[:ingredients])
+      factory = Bls::Core::ProductFactory.new(response)
+
+      result = factory.create
+
+      expect(result.ingredients).to match_array(ingredient)
+    end
+
+    it "assigns the allergens to the Product" do
+      response = build_product_response
+      allergen = Bls::Core::Allergen.build_from_array(response[:allergens])
+      factory = Bls::Core::ProductFactory.new(response)
+
+      result = factory.create
+
+      expect(result.allergens).to match_array(allergen)
+    end
+
+    it "assigns the dietary tags to the Product" do
+      response = build_product_response
+      dietary_tags = Bls::Core::Allergen.
+                     build_from_array(response[:dietary_tags])
+      factory = Bls::Core::ProductFactory.new(response)
+
+      result = factory.create
+
+      expect(result.dietary_tags).to match_array(dietary_tags)
+    end
+
+    it "assigns the nutrition facts to the Product" do
+      response = build_product_response
+      factory = Bls::Core::ProductFactory.new(response)
+      product = factory.create
+
+      result = product.nutrition_facts
+
+      expect(result.keys).to match_array([:as_packaged, :as_cooked])
+    end
+  end
+end