opera-mobile-store-sdk 0.1.0

data/lib/opera/mobile_store/payment_info.rb

@@ -0,0 +1,105 @@
+module Opera
+  module MobileStore
+    class PaymentInfo
+
+      include ActiveModel::Model
+
+      def self.build_from_nokogiri_node(node)
+        if node.present?
+          type = node.xpath("string(@type)").strip.downcase
+
+          case type
+          when "check"  then Check.build_from_nokogiri_node node
+          when "wired"  then Wired.build_from_nokogiri_node node
+          when "paypal" then PayPal.build_from_nokogiri_node node
+          when "none"   then nil
+          else raise "WTF?"
+          end
+        end
+      end
+
+      def type
+        self.class.name.demodulize.downcase
+      end
+
+      def inspect
+        attr_inspect = attributes.inject [] do |attributes, keyval|
+          key, val = keyval
+          attributes + ["#{key}: \"#{val}\""]
+        end.join(", ")
+
+        "<#{self.class.name} #{attr_inspect}>"
+      end
+
+      class Check < PaymentInfo
+        attr_accessor :name, :address
+
+        def self.build_from_nokogiri_node(node)
+          self.new(
+            name:    node.xpath("string(payment_check_name)"),
+            address: node.xpath("string(payment_check_address)")
+          )
+        end
+
+        def attributes
+          [:name, :address].inject({}) do |hash, method|
+            value = self.public_send method
+            hash[method] = value unless value.nil?
+            hash
+          end
+        end
+      end
+
+      class Wired < PaymentInfo
+        attr_accessor :bank_account,
+                      :bank_name,
+                      :bank_address,
+                      :bank_swiftbic,
+                      :bank_iban,
+                      :bank_routing_number,
+                      :intermediary_bank_name,
+                      :intermediary_bank_address,
+                      :intermediary_bank_swiftbic,
+                      :intermediary_bank_iban
+
+        def self.build_from_nokogiri_node(node)
+          data = [
+            :bank_account, :bank_name, :bank_address, :bank_swiftbic, :bank_iban,
+            :bank_routing_number, :intermediary_bank_name, :intermediary_bank_address,
+            :intermediary_bank_swiftbic, :intermediary_bank_iban
+          ].inject({}) do |hash, attribute_name|
+            value = node.xpath("string(payment_wired_#{attribute_name})").strip
+            hash[attribute_name] = value if value.present?
+            hash
+          end
+
+          self.new data
+        end
+
+        def attributes
+          [
+            :bank_account, :bank_name, :bank_address, :bank_swiftbic, :bank_iban,
+            :bank_routing_number, :intermediary_bank_name, :intermediary_bank_address,
+            :intermediary_bank_swiftbic, :intermediary_bank_iban
+          ].inject({}) do |hash, method|
+            value = self.public_send method
+            hash[method] = value unless value.nil?
+            hash
+          end
+        end
+      end
+
+      class PayPal < PaymentInfo
+        attr_accessor :account
+        def self.build_from_nokogiri_node(node)
+          self.new(account: node.xpath("string(account)").strip)
+        end
+
+        def attributes
+          { account: account }
+        end
+      end
+
+    end
+  end
+end

data/lib/opera/mobile_store/product.rb

@@ -0,0 +1,157 @@
+require "active_model"
+
+module Opera
+  module MobileStore
+    class Product
+
+      include ActiveModel::Model
+
+      include Opera::MobileStoreSDK::APIAccessible
+
+      # All attributes are Read-Only...
+      attr_accessor :id, :code, :category_id, :cp_product_id,
+                  :app_type,
+                  :released_at,    # Release date
+                  :download_count, # Download count at Opera Mobile Store
+                  :author_id,
+                  :support_url,
+                  :version,
+                  :requirements,
+                  :price,
+                  :adult_content,
+                  :rating,
+                  :currency,
+                  :product_type,
+                  :weight,
+                  :updated_at,
+                  :added_at,
+                  :keywords,
+                  :rating,
+                  :images,
+                  :eula,
+                  :subsites,
+                  :builds,
+                  :i18n
+
+      def category
+        Category.find category_id if category_id.present?
+      end
+
+      def author
+        Author.find author_id if author_id.present?
+      end
+
+      def title(key = "en")
+        required_data = i18n.detect do |x|
+          x.language_iso_code == key.to_s
+        end.title
+        required_data.present? ? required_data : title('en')
+      end
+
+      def short_description(key = "en")
+        required_data = i18n.detect do |x|
+          x.language_iso_code == key.to_s
+        end.short_description
+        required_data.present? ? required_data : short_description('en')
+      end
+
+      def long_description(key = "en")
+        required_data = i18n.detect do |x|
+          x.language_iso_code == key.to_s
+        end.long_description
+        required_data.present? ? required_data : long_description('en')
+      end
+
+      def available_language_codes
+        i18n.map(&:language_iso_code)
+      end
+
+      def self.build_from_nokogiri_node(node)
+
+        category_id = node.xpath("number(category/@id)").to_i
+        author_id = node.xpath("number(author/@id)").to_i
+
+        # Register the category unless it's already registered in the ID Map:
+        Category.register(
+          id: category_id,
+          code: node.xpath("string(category/@code)"),
+          name: node.xpath("string(category)")
+        ) unless Category.registered? category_id
+
+        # Register the author unless it's already registered in the ID Map:
+        unless Author.registered? author_id
+          author_attributes = {
+            id: author_id,
+            name: node.xpath("string(author)"),
+            email: node.xpath("string(author_email)")
+          }
+          author_attributes.delete(:email) unless author_attributes[:email].present?
+
+          Author.register author_attributes
+        end
+
+        data = {
+          id:   node.xpath("number(@id)").to_i,
+          code: node.xpath("string(@code)"),
+          cp_product_id: node.xpath("number(cp_product_id)").to_i,
+
+          category_id: category_id,
+          author_id: author_id,
+          app_type: node.xpath("string(apptype)"),
+          released_at: Time.parse(node.xpath "string(release_date)"),
+          download_count: node.xpath("number(downloads_count)").to_i,
+          support_url: node.xpath("string(support_url)"),
+          version: node.xpath("string(version)"),
+          # TODO: process requirements node
+
+          # Product localization in English:
+          i18n: [
+            ProductLocalization.new(
+              language_code: "en",
+              language_iso_code: "en",
+              language_name: "English",
+              title: node.xpath("string(product_name)").strip,
+              short_description: node.xpath("string(short_description)").strip,
+              long_description: node.xpath("string(long_description)").strip
+            )
+          ],
+
+          price: node.xpath("number(price)"),
+          currency: node.xpath("string(currency)"),
+          product_type: node.xpath("string(type)"),
+          weight: node.xpath("number(weight)").to_i,
+          updated_at: Time.parse(node.xpath "string(update_date)"),
+          added_at: Time.parse(node.xpath "string(add_date)"),
+
+          keywords: node.xpath("keywords/keyword").map do |x|
+            value = x.text.strip
+            value.present? ? Opera::MobileStoreSDK.html_entities.decode(value) : nil
+          end.compact,
+
+          images: node.xpath("images/*").map do |i|
+            ProductImage.build_from_nokogiri_node i
+          end,
+
+          builds: node.xpath("builds/build").map do |b|
+            Build.build_from_nokogiri_node b
+          end,
+
+        }
+
+        node.xpath("translates/language").each do |language_node|
+          data[:i18n] << ProductLocalization.new(
+            language_code: language_node.xpath("string(@code)").strip,
+            language_iso_code: language_node.xpath("string(@iso)").strip,
+            language_name: language_node.xpath("string(@language)").strip,
+            title: node.xpath("string(title)").strip,
+            short_description: node.xpath("string(short_description)").strip,
+            long_description: node.xpath("string(description)").strip
+          )
+        end
+
+        self.new data
+      end
+
+    end
+  end
+end

data/lib/opera/mobile_store/product_image.rb

@@ -0,0 +1,42 @@
+module Opera
+  module MobileStore
+    class ProductImage
+
+      include ActiveModel::Model
+
+      # All attributes are Read-Only...
+      attr_accessor :type, :width, :height, :url
+
+      def self.build_from_nokogiri_node(node)
+
+        data = {
+          type: node.name,
+          url: node.text.strip
+        }
+
+        # Extract width + height data:
+        width = node.xpath("string(@width)")
+        height = node.xpath("string(@height)")
+        data[:width] = width.to_i if width.present?
+        data[:height] = width.to_i if height.present?
+
+        self.new data
+      end
+
+      def inspect
+        info = { type: type }
+        info[:width]  = width if width.present?
+        info[:height] = height if height.present?
+        info[:url]    = url
+
+        info = info.inject [] do |attributes, keyval|
+          key, val = keyval
+          attributes + ["#{key}:#{val}"]
+        end
+
+        "<Opera::MobileStore::ProductImage " + info.join(', ') + ">"
+      end
+
+    end
+  end
+end

data/lib/opera/mobile_store/product_localization.rb

@@ -0,0 +1,35 @@
+module Opera
+  module MobileStore
+    class ProductLocalization
+
+      include ActiveModel::Model
+
+      # All attributes are Read-Only...
+      attr_accessor :language_code,
+                    :language_iso_code,
+                    :language_name,
+                    :title,
+                    :short_description,
+                    :long_description
+
+      def attributes
+        [:language_code, :language_iso_code, :language_name,
+        :title, :short_description, :long_description].inject({}) do |hash, method|
+          value = self.public_send method
+          hash[method] = value unless value.nil?
+          hash
+        end
+      end
+
+      def inspect
+        attr_inspect = attributes.inject [] do |attributes, keyval|
+          key, val = keyval
+          attributes + ["#{key}:#{val}"]
+        end.join(", ")
+
+        "<#{self.class.name} #{attr_inspect}>"
+      end
+
+    end
+  end
+end

data/lib/opera/mobile_store_sdk/api_accessible.rb

@@ -0,0 +1,44 @@
+require "active_support/concern"
+
+module Opera
+  module MobileStoreSDK
+    module APIAccessible
+
+      extend ActiveSupport::Concern
+
+      included do
+
+      end
+
+      module ClassMethods
+
+        def where(given_options = {})
+          APIObjectList.new(name).where given_options
+        end
+
+        def per(given_item_count)
+          APIObjectList.new(name).per given_item_count
+        end
+
+        def page(given_page)
+          APIObjectList.new(name).page given_page
+        end
+
+        def all
+          APIObjectList.new(name)
+        end
+
+        def includes(*included_fields)
+          params = included_fields.map(&:to_s).map(&:downcase)
+          .select { |x| %w(original_images billing eula adult subsites compatibility profit rating).include? x }
+          .map { |x| x == "billing" ? "show_billing" : x }
+          .inject({}) { |hash, param_name| hash[param_name] = "1"; hash }
+
+          APIObjectList.new name, params
+        end
+
+      end
+
+    end
+  end
+end

data/lib/opera/mobile_store_sdk/api_object_list.rb

@@ -0,0 +1,174 @@
+require "faraday"
+require "opera/mobile_store_sdk/faraday_middleware"
+
+module Opera
+  module MobileStoreSDK
+
+    # Our version of Array... which will request each page upon iteration...
+    # see http://stackoverflow.com/questions/1571349/can-the-array-be-reinvented-in-ruby
+    class APIObjectList
+
+      include Enumerable
+
+      attr_reader :options
+
+      def initialize(klass, options = {})
+        @klass = klass
+        @options = options.with_indifferent_access
+      end
+
+      def length
+        response.body.count
+      end
+
+      def found_rows
+        response.env[:found_rows]
+      end
+      alias_method :total_count, :found_rows
+
+      def sdk_tms
+        {
+          api_calling: response.env[:opera_api_calling_tms],
+          api_response_parsing: response.env[:opera_api_response_parsing_tms],
+        }
+      end
+
+      def api_call_duration
+        sdk_tms[:api_calling].real
+      end
+
+      def api_response_parsing_duration
+        sdk_tms[:api_response_parsing].real
+      end
+
+      def api_response_datetime
+        response.env[:opera_api_response_datetime]
+      end
+
+      def timestamp
+        response.env[:timestamp]
+      end
+
+      def updated_at
+        Time.at(page.timestamp).to_datetime
+      end
+
+      def [](n)
+        response.body[n]
+      end
+
+      def each
+        0.upto(length - 1) { |idx| yield self[idx] }
+      end
+
+      def to_a
+        response.body
+      end
+
+      # Chainable Methods ------------------------------------------------------
+      def where(given_options = {})
+
+        given_options = given_options.with_indifferent_access
+
+        ########################################################################
+        # Validate (& filter out conflicting) options:
+
+        # Product list API can use added_after/updated_after parameters:
+
+        if given_options.include? :updated_after
+          if given_options[:updated_after].is_a? String
+            begin
+              given_options[:updated_after] = DateTime.parse(given_options[:updated_after])
+            rescue ArgumentError => e
+              raise Opera::MobileStoreSDK::Errors::APIParamsError,
+                "Parameter 'updated_after' is not a date (#{given_options[:updated_after]})"
+            end
+          elsif !given_options[:updated_after].respond_to? :to_date
+            raise Opera::MobileStoreSDK::Errors::APIParamsError,
+              "Parameter 'updated_after' is not a date (#{given_options[:updated_after]})"
+          end
+        end
+
+        if given_options.key? :added_after
+          if given_options[:added_after].is_a? String
+            begin
+              given_options[:added_after] = DateTime.parse(given_options[:added_after])
+            rescue ArgumentError => e
+              raise Opera::MobileStoreSDK::Errors::APIParamsError,
+                "Parameter 'added_after' is not a date (#{given_options[:added_after]})"
+            end
+          elsif !given_options[:added_after].respond_to? :to_date
+            raise Opera::MobileStoreSDK::Errors::APIParamsError,
+              "Parameter 'added_after' is not a date (#{given_options[:added_after]})"
+          end
+
+          # Delete conflicting parameters:
+          given_options.delete :updated_after
+        end
+        ########################################################################
+
+        self.class.new @klass, @options.merge(given_options)
+      end
+
+      def page(given_page)
+        where @options.merge(page: given_page)
+      end
+
+      def offset(given_offset)
+        where @options.merge(offset: given_offset)
+      end
+
+      def per(given_item_count)
+        where @options.merge(items: given_item_count)
+      end
+
+      def includes(included_fields = [])
+        params = included_fields.map(&:to_s).map(&:downcase)
+        .select { |x| %w(original_images billing eula adult subsites compatibility profit rating).include? x }
+        .map { |x| x == "billing" ? "show_billing" : x }
+        .inject({}) { |hash, param_name| hash[param_name] = "1"; hash }
+
+        self.class.new @klass, @options.merge(params)
+      end
+      # ------------------------------------------------------------------------
+
+      protected
+
+        def response
+
+          converted_options = @options.inject({}) do |hsh, keyval|
+            key, val = keyval
+
+            hsh[key.to_s] = case key.to_sym
+              when :added_after, :updated_after then
+                # byebug
+                val.to_date.to_s
+              else val.to_s
+            end
+
+            hsh
+          end
+
+          # puts "Options: #{@options.inspect}"
+          # byebug
+
+          @_response ||= Opera::MobileStoreSDK.connection.get do |request|
+            request.url MobileStoreSDK.config.api_path, {
+              action: action_param
+            }.merge(converted_options)
+
+            request.options.timeout = MobileStoreSDK.config.api_call_timeout
+            request.options.open_timeout = MobileStoreSDK.config.api_call_open_timeout
+          end
+        end
+
+        def action_param
+          @_action_param ||= case @klass
+            when "Opera::MobileStore::Developer" then "full_developers"
+            else @klass.demodulize.underscore.pluralize
+          end
+        end
+
+    end
+  end
+end