mobile_stores 0.1.0

data/lib/mobile_stores/app.rb

@@ -0,0 +1,60 @@
+module MobileStores
+  class App
+
+    attr_accessor :title, :application_id, :creator_name, :creator_id, :version, :rating, :description, :category, :icon_url, :view_url, :price, :compatibility, :screenshot_urls
+
+    def initialize(hash = {})
+      hash.each_pair do |key, value|
+        self.send "#{ key }=", value
+      end
+    end
+
+    class << self
+      attr_accessor :store
+
+      # Selects the store for further manipulations.
+      #
+      #   App.in(:app_store)
+      #
+      def in(store)
+        store_class = if store.is_a? Symbol
+          MobileStores::STORES[store]
+        elsif store.is_a? String
+          Object.const_get(store) rescue nil
+        elsif store.is_a? Class
+          store
+        end
+
+        raise NotImplementedError, "#{ store } is not implemented yet." if store.nil?
+
+        store_class.new
+      end
+
+      # Selects Apple AppStore for further manipulations.
+      def app_store
+        self.in(AppStore)
+      end
+
+      # Selects Google Play Store for further manipulations.
+      def google_play
+        self.in(GooglePlay)
+      end
+
+      # Selects Windows Store for further manipulations.
+      def windows_store
+        self.in(WindowsStore)
+      end
+
+      # Selects BlackBerry World Store for further manipulations.
+      def blackberry_world
+        self.in(BlackBerryWorld)
+      end
+
+      # Selects BlackBerry World Store for further manipulations.
+      def amazon_marketplace
+        self.in(AmazonMarketplace)
+      end
+    end
+
+  end
+end

data/lib/mobile_stores/app_store.rb

@@ -0,0 +1,56 @@
+module MobileStores
+  class AppStore
+    include MobileStore
+
+    act_as_json_source
+
+    private
+
+    def self.apps_url(query = nil, count = nil, country = nil)
+      url = "http://itunes.apple.com/search?media=software"
+      url = "#{ url }&term=#{ CGI::escape(query) }" if query
+      url = "#{ url }&limit=#{ count }" if count
+      url = "#{ url }&country=#{ country.alpha2 }"
+      url
+    end
+
+    def self.app_url(id, country)
+      "http://itunes.apple.com/lookup?id=#{ CGI::escape(id) }&country=#{ country.alpha2 }"
+    end
+
+    def self.process_app_json(json)
+      app = self.parse_json(json).first
+      raise "App not found." if app.nil?
+      app
+    end
+
+    def self.process_apps_json(json)
+      self.parse_json(json)
+    end
+
+    def self.parse_json(json)
+      if json['results']
+        json['results'].map do |app|
+          App.new({ 
+            application_id: app['trackId'].to_s.force_encoding('utf-8'),
+            title: app['trackName'].force_encoding('utf-8'),
+            creator_name: app['artistName'].force_encoding('utf-8'),
+            creator_id: app['artistId'].to_s.force_encoding('utf-8'),
+            version: app['version'].to_s.force_encoding('utf-8'),
+            rating: (app['averageUserRating'].to_f || 0).to_s.force_encoding('utf-8').to_f,
+            description: app['description'].force_encoding('utf-8'),
+            category: app['primaryGenreName'].force_encoding('utf-8'),
+            icon_url: app['artworkUrl512'].force_encoding('utf-8'),
+            view_url: app['trackViewUrl'].force_encoding('utf-8'),
+            price: app['price'].to_s.force_encoding('utf-8').to_d,
+            compatibility: app['supportedDevices'].sort,
+            screenshot_urls: app['screenshotUrls'] + app['ipadScreenshotUrls']
+          })
+        end
+      else
+        []
+      end
+    end
+
+  end
+end

data/lib/mobile_stores/black_berry_world.rb

@@ -0,0 +1,55 @@
+module MobileStores
+  class BlackBerryWorld
+    include MobileStore
+
+    act_as_json_source
+
+    private
+
+    def self.apps_url(query = nil, count = nil, country)
+      url = "http://appworld.blackberry.com/cas/producttype/apps/listtype/search_listing/category/0/search/#{ CGI::escape(query) }?page=1&model=Imagination%20GPU&countrycode=#{ country.alpha2 }&lang=#{ country.languages.first }"
+      url = "#{ url }&pagesize=#{ count }" if count
+      url
+    end
+
+    def self.app_url(id, country)
+      "http://appworld.blackberry.com/cas/content/#{ id }?model=Imagination%20GPU&countrycode=#{ country.alpha2 }&lang=#{ country.languages.first }"
+    end
+
+    def self.process_app_json(json)
+      self.parse_element_json(json)
+    end
+
+    def self.process_apps_json(json)
+      self.parse_list_json(json)
+    end
+
+    def self.parse_element_json(json)
+      App.new({ 
+        application_id: json['id'],
+        title: json['name'],
+        creator_name: json['vendorName'],
+        creator_id: json['vendorId'],
+        version: (json['cdDTO']['releaseVersion'] rescue nil),
+        rating: (json['rating'] == -1 ? nil : json['rating']),
+        description: json['description'],
+        category: json['categories'][0]['name'],
+        icon_url: "http://appworld.blackberry.com/webstore/servedimages/#{ json['iconId'] }.png/?t=2",
+        view_url: "http://appworld.blackberry.com/webstore/content/#{ json['id'] }",
+        price: (json['cdDTO']['price'].to_d rescue 0),
+        compatibility: json['cdDTO']['supportedDevices'],
+        screenshot_urls: (json['screenShots'] || []).map{ |s| "http://appworld.blackberry.com/webstore/servedimages/#{ s }.png/?t=11" }
+      })
+    end
+
+    def self.parse_list_json(json)
+      json['ldata'].map do |app|
+        App.new({
+          :application_id => app['id'],
+          :title => app['name'],
+          :icon_url => "http://appworld.blackberry.com/webstore/servedimages/#{ app['iconId'] }.png/?t=2"
+        })
+      end
+    end
+  end
+end

data/lib/mobile_stores/google_play.rb

@@ -0,0 +1,61 @@
+# GooglePlay doesn't support country based filtering, so every country is
+# supported by default
+module MobileStores
+  class GooglePlay
+    include MobileStore
+
+    act_as_html_source
+
+    private
+
+    def self.apps_url(query = nil, count = nil, country = nil)
+      url = "https://play.google.com/store/search?hl=en"
+      url = "#{ url }&q=#{ CGI::escape(query) }" if query
+      url = "#{ url }&start=0&num=#{ count }" if count
+      url
+    end
+
+    def self.app_url(id, country)
+      "https://play.google.com/store/apps/details?id=#{ id }&hl=en"
+    end
+
+    def self.process_app_html(doc)
+      self.parse_html_page(doc)
+    end
+
+    def self.process_apps_html(doc, count = nil)
+      self.parse_html_list(doc, count)
+    end
+
+    def self.parse_html_page(doc)
+      App.new({
+        application_id: doc.css('.details-wrapper')[0]['data-docid'],
+        title: doc.css('.document-title div')[0].inner_text.strip,
+        creator_name: doc.css('.document-subtitle.primary')[0].inner_text.strip,
+        creator_id: doc.css('.document-subtitle.primary')[0].inner_text.strip,
+        version: doc.css('[itemprop=softwareVersion]')[0].inner_text.strip,
+        rating: doc.css('[itemprop=ratingValue]')[0]['content'].to_f,
+        description: doc.css('[itemprop=description] .app-orig-desc')[0].inner_text.strip.gsub(%r{</?[^>]+?>}, ''),
+        category: doc.css('.document-subtitle.category')[0].inner_text.strip,
+        icon_url: doc.css('.cover-image')[0]['src'],
+        view_url: "https://play.google.com/store/apps/details?hl=en&id=#{ doc.css('.details-wrapper')[0]['data-docid'] }",
+        price: doc.css('[itemprop=price]')[0]["content"].to_d,
+        compatibility: (doc.css('.metadata div.content[itemprop=operatingSystems]')[0].inner_text.strip rescue nil),
+        screenshot_urls: doc.css('.full-screenshot').map{ |d| d['src'] }
+      })
+    end
+
+    def self.parse_html_list(doc, count = nil)
+      apps = doc.css('.card-list .card').map do |app|
+        App.new({
+          :application_id => app['data-docid'],
+          :title => app.css('img')[0]['alt'],
+          :icon_url => app.css('img')[0]['src']
+        })
+      end
+
+      count ? apps.take(count) : apps
+    end
+
+  end
+end

data/lib/mobile_stores/mobile_store.rb

@@ -0,0 +1,176 @@
+require "json"
+require "net/http"
+require "uri"
+
+module MobileStores
+  module MobileStore
+
+    module InstanceMethods
+
+      attr_accessor :country
+
+      def initialize
+        # set country to United States as default
+        @country = Country.new(:us)
+        super
+      end
+
+      # Selects store corresponding to country or returns selected country,
+      # if arguments is not specified
+      #  
+      #   App.in(:app_store).country(:us).find("12345") # returns +App+ object
+      # 
+      def country(country = nil)
+        if country
+          @country = Country.new(country)
+          self
+        else
+          @country
+        end
+      end
+
+      # Finds app in store by ID.
+      # Returns nil if app was not found.
+      #
+      #   App.in(:app_store).find("12345") # returns +App+ object
+      #
+      def find(id)
+        find!(id) rescue nil
+      end
+
+      # Finds app in store by ID.
+      # Raises error if app was not found.
+      #
+      #   App.in(:app_store).find("12345") # returns +App+ object
+      #
+      def find!(id)
+        self.class.find_app(id, country)
+      end
+
+      # Searches apps in store by query
+      #
+      #   App.in(:app_store).search("angry") # returns array of +App+ objects
+      #
+      def search(query, count = nil)
+        self.class.search_apps(query, count, country)
+      end
+
+      # Returns true if app exists in store searching by ID, 
+      # otherwise returns false
+      def exists?(id)
+        not find(id).nil?
+      end
+
+    end
+
+    module ClassMethods
+
+      def act_as_json_source
+        self.extend(JsonClassMethods)
+      end
+
+      def act_as_html_source
+        self.extend(HtmlClassMethods)
+      end
+
+      # Returns url for a list of apps.
+      def apps_url(query = nil, count = nil)
+        raise_not_implemented
+      end
+
+      # Returns url for a single app.
+      def app_url(id)
+        raise_not_implemented
+      end
+
+      private
+      
+      # Raises +NotImplementedError+ when called.
+      def raise_not_implemented
+        raise NotImplementedError, "#{ self.name.to_s }.#{ caller[0] =~ /`([^']*)'/ and $1 } is not implemented."
+      end
+    end
+
+    module JsonClassMethods
+      
+      # Finds app in store by ID.
+      #
+      #   AppStore.find_app("12345") # returns +App+ object
+      #
+      def find_app(id, country)
+        process_app_json(json(app_url(id, country)))
+      end
+
+      # Searches apps in store by query.
+      #
+      #   AppStore.search_apps("angry") # returns array of +App+ objects
+      #
+      def search_apps(query, count = nil, country)
+        process_apps_json(json(apps_url(query, count, country)))
+      end
+
+      private
+
+      # Processes json for a list of apps.
+      def process_apps_json(json)
+        raise_not_implemented
+      end
+
+      # Process json for a single app.
+      def process_app_json(json)
+        raise_not_implemented
+      end
+
+      # Fetches json object from url.
+      def json(url)
+        response = Net::HTTP.get_response(URI.parse(url))
+        JSON.parse(response.body)
+      end
+
+    end
+
+    module HtmlClassMethods
+      
+      # Finds app in store by ID.
+      #
+      #   AppStore.find_app("12345") # returns +App+ object
+      #
+      def find_app(id, country)
+        process_app_html(doc(app_url(id, country)))
+      end
+
+      # Searches apps in store by query.
+      #
+      #   AppStore.search_apps("angry") # returns array of +App+ objects
+      #
+      def search_apps(query, count = nil, country)
+        process_apps_html(doc(apps_url(query, count, country)), count)
+      end
+
+      private
+
+      # Processes json for a list of apps.
+      def process_apps_html(html, count)
+        raise_not_implemented
+      end
+
+      # Process json for a single app.
+      def process_app_html(html)
+        raise_not_implemented
+      end
+
+      # Fetches json object from url.
+      def doc(url)
+        Nokogiri::HTML(open(url))
+      end
+
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    include InstanceMethods
+
+  end
+end

data/lib/mobile_stores/windows_store.rb

@@ -0,0 +1,72 @@
+module MobileStores
+  class WindowsStore
+    include MobileStore
+
+    COUNTRY_LANGUAGE = { :ao => 'pt', :ar => 'es', :am => 'en', :au => 'en', :la => 'az', :az => 'tn', :bd => 'en', :be => 'nl', :be => 'fr', :bj => 'fr', :bo => 'es', :br => 'pt', :bf => 'fr', :bi => 'fr', :cm => 'en', :ca => 'en', :ca => 'fr', :cz => 'cs', :cl => 'es', :co => 'es', :cd => 'fr', :cr => 'es', :ci => 'fr', :dk => 'da', :de => 'de', :ec => 'es', :ee => 'et', :sv => 'es', :es => 'es', :es => 'ca', :fr => 'fr', :gh => 'en', :gt => 'es', :gn => 'fr', :ht => 'fr', :hn => 'es', :hk => 'en', :hr => 'hr', :is => 'is', :in => 'en', :id => 'id', :ie => 'en', :it => 'it', :ke => 'en', :kw => 'en', :lv => 'lv', :li => 'de', :lt => 'lt', :mg => 'fr', :hu => 'hu', :mw => 'en', :my => 'ms', :my => 'en', :ml => 'fr', :mx => 'es', :mz => 'pt', :nl => 'nl', :nz => 'en', :ni => 'es', :ne => 'fr', :ng => 'en', :no => 'nb', :at => 'de', :la => 'uz', :uz => 'tn', :pk => 'en', :py => 'es', :pe => 'es', :ph => 'en', :ph => 'il', :pl => 'pl', :pt => 'pt', :do => 'es', :ro => 'ro', :rw => 'fr', :ch => 'de', :sn => 'fr', :al => 'sq', :sl => 'en', :sg => 'en', :si => 'sl', :sk => 'sk', :so => 'en', :za => 'en', :la => 'sr', :cs => 'tn', :ch => 'fr', :fi => 'fi', :se => 'sv', :ch => 'it', :tz => 'en', :td => 'fr', :tg => 'fr', :tr => 'tr', :ug => 'en', :gb => 'en', :us => 'en', :ve => 'es', :vn => 'vi', :zm => 'en', :zw => 'en', :gr => 'el', :by => 'be', :bg => 'bg', :kz => 'kk', :mk => 'mk', :ru => 'ru', :tj => 'ru', :tm => 'ru', :ua => 'uk', :il => 'he', :jo => 'ar', :ae => 'ar', :bh => 'ar', :dz => 'ar', :iq => 'ar', :kw => 'ar', :ma => 'ar', :sa => 'ar', :ye => 'ar', :tn => 'ar', :om => 'ar', :qa => 'ar', :eg => 'ar', :in => 'hi', :th => 'th', :kr => 'ko', :cn => 'zh', :tw => 'zh', :jp => 'ja', :hk => 'zh' 
+    }
+
+    act_as_html_source
+
+    private
+
+    def self.apps_url(query = nil, count = nil, country)
+      url = "http://www.windowsphone.com/#{ COUNTRY_LANGUAGE[country.alpha2.downcase.to_sym] }-#{ country.alpha2.downcase }/store/search"
+      url = "#{ url }?q=#{ CGI::escape(query) }" if query
+      URI.encode url
+    end
+
+    def self.app_url(id, country)
+      URI.encode "http://www.windowsphone.com/#{ country.languages.first }-#{ country.alpha2.downcase }/store/app/#{ id }"
+    end
+
+    def self.process_app_html(doc)
+      app = self.parse_html_page(doc)
+      raise "App not found." if app.nil?
+      app
+    end
+
+    def self.process_apps_html(doc, count = nil)
+      self.parse_html_list(doc, count)
+    end
+
+    def self.parse_html_page(doc)
+      App.new({
+        application_id: doc.css('[itemprop=url]')[0]['content'].match(/[^\/]+\/[^\/]+$/)[0],
+        title: doc.css('[itemprop=name]')[0].inner_text,
+        creator_name: doc.css('[itemprop=publisher]')[0].inner_text,
+        creator_id: doc.css('[itemprop=publisher]')[0].inner_text,
+        version: doc.css('[itemprop=softwareVersion]')[0].inner_text,
+        rating: doc.css('[itemprop=ratingValue]')[0]['content'].to_f,
+        description: doc.css('[itemprop=description]')[0].inner_text.gsub(%r{</?[^>]+?>}, ''),
+        category: (doc.css('[itemprop=applicationCategory]')[0].inner_text.capitalize rescue nil),
+        icon_url: doc.css('[itemprop=image]')[0]['src'],
+        view_url: doc.css('[itemprop=url]')[0]['content'],
+        price: doc.css('[itemprop=price]')[0].inner_text.gsub(/[^0-9.,]/, '').to_d,
+        compatibility: doc.css('[itemprop=operatingSystems]').map{ |o| o.inner_text}.join(', '),
+        screenshot_urls: doc.css('#screenshots a').map{ |d| d['href'] }
+      })
+    end
+
+    def self.parse_html_list(doc, count = nil, page = 1)
+      apps = doc.css('.appList td').map do |app|
+        id_string = app.css('a')[0]['data-ov'].split(';').last
+        App.new({
+          :application_id => id_string.split(' ')[1] + '/' + id_string.split(' ')[0],
+          :title => app.css('a')[1].inner_text,
+          :icon_url => app.css('img')[0]['src']
+        })
+      end
+
+      if count and page == 1
+        while apps.size < count and doc.css('#nextLink').length > 0
+          page += 1
+          doc = Nokogiri::HTML(open("http://www.windowsphone.com#{ doc.css('#nextLink')[0]['href'] }"))
+          apps += self.parse_html_list(doc)
+        end
+      end
+
+      count ? apps.take(count) : apps
+    end
+
+  end
+end