Contents

require "app_store/base"
require "app_store/application"
require 'pp'

# A category like categories on the AppStore.
# Available attributes:
# * <tt>item-count</tt>: total items count for this category.
# * <tt>title</tt>: title for the category.
class AppStore::Category < AppStore::Base
  plist :mapping => {
    'item-count'  => :item_count,
    'title'       => :title
  }
  
  # Returns an array of featured categories (main categories).
  # It is the same list as the one displayed in the iPhone AppStore.
  def self.featured
    plist = AppStore::Caller.get(AppStore::Caller::FeaturedCategoriesURL)
    plist['items'].collect { |item| new :plist => item }
  end
  
  def self.find_by_id(id)
    # TODO: pass item_id to new
    category = new(:plist => AppStore::Caller.get(AppStore::Caller::CategoryURL, :id => id))
  end
  
  # Returns id for this category
  def item_id
    @item_id ||= @raw['url'].match("id=([0-9]+)")[1]
  end
  
  # Returns an array of items contained in the category, with a maximum of 25 items (Apple limitation).
  # If there are more than 25 items in the category, an extra item is added at the end of the list
  # as a link to the next 25 entries.
  # Each element can be either a Category or an Application.
  def items
    if @items.nil?
      plist = @raw['items'] ? @raw : AppStore::Caller.get(@raw['url'])
      @items = AppStore::List.new(
        :list                 => plist['items'],
        :element_type         => 'link',
        :element_initializer  => lambda {|element|
          (element['link-type'] == 'software' ? AppStore::Link : AppStore::Category).new(:plist => element)
        }
      )
    end
    @items
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
app_store-0.0.4	lib/app_store/category.rb
app_store-0.0.3	lib/app_store/category.rb