eq_appstore_info 2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 52a79e242a47e080a90b1ddb1c046d2a7505a8e20b4ded4d6f54913586ce57db
+  data.tar.gz: 5931fac03f00a6bd2d68635e7f3f71524e81f63bbbcc9cf8226ca0c62d75d900
+SHA512:
+  metadata.gz: 61c6181d53ffda6ffda46a7b8a6b8ed3ba991cbbcc2c7b0e53376ddda4a0e564c5464aaa7373f628d8cc2d316cebd4bdcdd3154f0a3b9276c10ddbe9e24cda5f
+  data.tar.gz: e190ea26b4e64caf9ae2bd911568cc30d9af514b83f99b0a567e1b1cbf2eeb4f15c842483f49839eec74e6c851c8df7ebe98f86b4862e1716ac60fe9fb4b9350

data/.gitignore

@@ -0,0 +1,10 @@
+*.gem
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,35 @@
+require: rubocop-rspec
+
+Metrics/LineLength:
+  Max: 100
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+# I hate this stupid rule, that makes tests hard to understand
+RSpec/PredicateMatcher:
+  Enabled: false
+
+# We still need the # coding utf-8 comment for older ruby versions
+Style/Encoding:
+  Enabled: false
+
+# Although using .match? makes sense for ruby 2.4+ in previous versions it doesn't work
+Performance/RegexpMatch:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.7.1

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.2.2
+  - 2.3.0
+  - 2.3.3
+  - 2.4.2
+  - 2.7.1
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in appstore_info.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Ricardo Otero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,91 @@
+[![Build Status](https://travis-ci.org/equinux/appstore_info.svg)](https://travis-ci.org/equinux/appstore_info) [![Dependency Status](https://gemnasium.com/equinux/appstore_info.svg)](https://gemnasium.com/equinux/appstore_info)
+
+# AppStoreInfo
+
+Get details about any app in the Apple App Store. This gem uses iTunes lookup method to get information about apps. (i.e. https://itunes.apple.com/us/lookup?id=343200656).
+
+Compatible with ruby >= 1.9.3
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'app_store_info'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install appstore_info
+
+## Usage
+
+You first have to read the app details, using the store URL or directly with the ID:
+
+```ruby
+app = AppStoreInfo.read_url('https://itunes.apple.com/gb/app/angry-birds/id343200656?mt=8')
+app = AppStoreInfo.read(343200656)
+app = AppStoreInfo.read(343200656, 'gb') # You can give a particular region or it will use 'us'
+```
+
+Then you have some attributes that can be read easily:
+
+```ruby
+app.id                  # => 343200656
+app.name                # => "Angry Birds"
+app.url                 # => "http://www.angrybirds.com/"
+app.average_user_rating # => 4.5
+app.user_rating_count   # => 222131
+app.genre_ids           # => ["6014", "7003", "6016", "7001"]
+app.price               # => 0.79
+app.currency            # => "GBP"
+app.supported_devices   # => ["iPhone-3GS", "iPhone4", "iPodTouchFourthGen", ...]
+app.company             # => "Rovio Entertainment Ltd"
+app.description         # => "Use the unique powers of the Angry Birds to destroy ...
+app.minimum_os_version  # => "6.0"
+app.features            # => ["gameCenter"]
+```
+
+You can also check if the app is Universal:
+
+```ruby
+app.universal? # => false
+```
+
+Last, you can check the details about the latest version of the app:
+
+```ruby
+current_version = app.current_version
+
+current_version.average_user_rating # => 4.0
+current_version.user_rating_count   # => 191
+current_version.number              # => "5.2.0"
+current_version.release_notes       # => "We popped some pesky bugs!"
+```
+
+If you need to get the genre names there's an helper method for that:
+
+```ruby
+app.genre_names # => ["Games", "Action", "Arcade", "Entertainment"]
+```
+
+Keep in mind that the information can be localized if you request for a particular region
+information. Ratings, currency, price etc. can change.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/equinux/appstore_info.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/appstore_info.gemspec

@@ -0,0 +1,32 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'appstore_info/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'eq_appstore_info'
+  spec.version       = AppStoreInfo::VERSION
+  spec.authors       = ['Ricardo Otero', 'Maximilian Szengel']
+  spec.email         = ['oterosantos@gmail.com', 'szengel@equinux.com']
+
+  spec.summary       = 'App Store parser'
+  spec.description   = 'Get details about any app in the Apple App Store'
+  spec.homepage      = 'https://github.com/equinux/appstore_info'
+  spec.license       = 'MIT'
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec)/}) }
+
+  spec.add_dependency 'faraday', '~> 1.0'
+
+  spec.add_development_dependency 'bundler', '~> 2.1'
+  spec.add_development_dependency 'pry', '~> 0.10'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.3'
+  spec.add_development_dependency 'rubocop', '~> 0.49'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.3'
+  spec.add_development_dependency 'vcr', '~> 6.0'
+  spec.add_development_dependency 'webmock', '~> 3.9'
+end

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'appstore_info'
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/appstore_info.rb

@@ -0,0 +1,40 @@
+require 'appstore_info/version'
+require 'appstore_info/api'
+require 'appstore_info/app'
+require 'appstore_info/regions'
+require 'appstore_info/genres'
+
+module AppStoreInfo
+  DEFAULT_REGION = 'us'.freeze
+
+  def self.read(id, region = DEFAULT_REGION)
+    # The region can be wrong because of the multiple app store formats (and our way of  getting) it
+    # from the URL. If that's the case then just fallback to 'us'.
+    region = DEFAULT_REGION unless Regions.find(region)
+
+    json = AppStoreInfo::API.new(id, region).parse
+
+    App.new(json)
+  end
+
+  def self.read_url(url)
+    match = url.match(%r{\Ahttps://itunes.apple.com/(\w+)/.+/?id=?([\d]+)})
+
+    raise InvalidURLError, 'Invalid App Store URL' unless match
+
+    region = match.captures.first
+    id = match.captures.last
+
+    read(id, region)
+  end
+
+  class GenericError < StandardError; end
+
+  class InvalidURLError < GenericError; end
+
+  class EntryNotFound < GenericError; end
+
+  class ConnectionError < GenericError; end
+
+  class ParseError < GenericError; end
+end

data/lib/appstore_info/api.rb

@@ -0,0 +1,47 @@
+require 'json'
+require 'faraday'
+
+module AppStoreInfo
+  class API
+    # The URL to lookup an app. The first variable is the region (us, pt, kor, etc..) and the
+    # second one is the application id (i.e. 599015198).
+    URL_TEMPLATE = 'https://itunes.apple.com/%s/lookup?id=%s'.freeze
+
+    attr_accessor :id, :url
+
+    def initialize(id, region = AppStoreInfo::DEFAULT_REGION)
+      @id = id
+      @region = region
+      @url = format(URL_TEMPLATE, region, id)
+    end
+
+    def parse
+      response = Faraday.get(url)
+
+      unless response.status == 200 && response.body
+        raise ConnectionError, "Cound't connect to app store API"
+      end
+
+      parse_json(response.body)
+    end
+
+    private
+
+    def parse_json(body)
+      json = JSON.parse(body)
+
+      raise EntryNotFound, 'No results' unless json.key?('results')
+
+      json = json['results'].first
+
+      # If the JSON exists and it's a mobile app (to avoid OS X apps)
+      unless json && json['supportedDevices']
+        raise EntryNotFound, "App not found or unavailable on '#{@region}' region"
+      end
+
+      json
+    rescue JSON::ParserError => error
+      raise ParseError, error.message
+    end
+  end
+end

data/lib/appstore_info/app.rb

@@ -0,0 +1,53 @@
+require 'appstore_info/json_accessors'
+require 'ostruct'
+
+module AppStoreInfo
+  class App
+    include AppStoreInfo::JSONAccessors
+
+    attr_reader :current_version
+
+    json_accessors id: 'trackId', name: 'trackCensoredName', url: 'sellerUrl',
+                   average_user_rating: 'averageUserRating', user_rating_count: 'userRatingCount',
+                   genre_ids: 'genreIds', price: 'price', currency: 'currency',
+                   supported_devices: 'supportedDevices', company: 'artistName',
+                   description: 'description', minimum_os_version: 'minimumOsVersion',
+                   features: 'features', languages: 'languageCodesISO2A',
+                   app_store_url: 'trackViewUrl'
+
+    def initialize(json)
+      read_json_accessors(json)
+
+      @artwork = json['artworkUrl512'] || json['artworkUrl100']
+
+      @current_version = read_current_version(json)
+    end
+
+    def universal?
+      @features.include?('iosUniversal')
+    end
+
+    def genre_names
+      @genre_ids.map { |genre| AppStoreInfo::GENRES[genre.to_i] }
+    end
+
+    def store_icon_url
+      return unless @artwork
+
+      @artwork =~ /\.(png|jpg|gif)\z/ ? @artwork : nil
+    end
+
+    private
+
+    def read_current_version(json)
+      version = OpenStruct.new
+
+      version.average_user_rating = json['averageUserRatingForCurrentVersion']
+      version.user_rating_count = json['userRatingCountForCurrentVersion']
+      version.number = json['version']
+      version.release_notes = json['releaseNotes']
+
+      version
+    end
+  end
+end

data/lib/appstore_info/genres.rb

@@ -0,0 +1,77 @@
+module AppStoreInfo
+  GENRES = {
+    6018 => 'Books',
+    6000 => 'Business',
+    6022 => 'Catalogs',
+    6017 => 'Education',
+    6016 => 'Entertainment',
+    6015 => 'Finance',
+    6023 => 'Food & Drink',
+    6014 => 'Games',
+    6013 => 'Health & Fitness',
+    6012 => 'Lifestyle',
+    6020 => 'Medical',
+    6011 => 'Music',
+    6010 => 'Navigation',
+    6009 => 'News',
+    6021 => 'Magazines & Newspapers',
+    6008 => 'Photo & Video',
+    6007 => 'Productivity',
+    6006 => 'Reference',
+    6005 => 'Social Networking',
+    6004 => 'Sports',
+    6003 => 'Travel',
+    6002 => 'Utilities',
+    6001 => 'Weather',
+
+    # Games subgenres
+    7001 => 'Action',
+    7002 => 'Adventure',
+    7003 => 'Arcade',
+    7004 => 'Board',
+    7005 => 'Card',
+    7006 => 'Casino',
+    7007 => 'Dice',
+    7008 => 'Educational',
+    7009 => 'Family',
+    7011 => 'Music',
+    7012 => 'Puzzle',
+    7013 => 'Racing',
+    7014 => 'Role Playing',
+    7015 => 'Simulation',
+    7016 => 'Sports',
+    7017 => 'Strategy',
+    7018 => 'Trivia',
+    7019 => 'Word',
+
+    # Magazines & Newspapers subgenres
+    13007 => 'Arts & Photography',
+    13006 => 'Automotive',
+    13008 => 'Brides & Weddings',
+    13009 => 'Business & Investing',
+    13010 => "Children's Magazines",
+    13011 => 'Computers & Internet',
+    13012 => 'Cooking, Food & Drink',
+    13013 => 'Crafts & Hobbies',
+    13014 => 'Electronics & Audio',
+    13015 => 'Entertainment',
+    13002 => 'Fashion & Style',
+    13017 => 'Health, Mind & Body',
+    13018 => 'History',
+    13003 => 'Home & Garden',
+    13019 => 'Literary Magazines & Journals',
+    13020 => "Men's Interest",
+    13021 => 'Movies & Music',
+    13001 => 'News & Politics',
+    13004 => 'Outdoors & Nature',
+    13023 => 'Parenting & Family',
+    13024 => 'Pets',
+    13025 => 'Professional & Trade',
+    13026 => 'Regional News',
+    13027 => 'Science',
+    13005 => 'Sports & Leisure',
+    13028 => 'Teens',
+    13029 => 'Travel & Regional',
+    13030 => "Women's Interest"
+  }.freeze
+end

data/lib/appstore_info/json_accessors.rb

@@ -0,0 +1,25 @@
+module AppStoreInfo
+  module JSONAccessors
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    def read_json_accessors(json)
+      self.class.accessors.each do |field, json_field|
+        instance_variable_set("@#{field}", json[json_field])
+      end
+    end
+
+    module ClassMethods
+      def json_accessors(json_accessors)
+        json_accessors.map { |field, _| attr_reader field }
+
+        @_json_accessors = json_accessors
+      end
+
+      def accessors
+        @_json_accessors
+      end
+    end
+  end
+end

data/lib/appstore_info/regions.rb

@@ -0,0 +1,108 @@
+module AppStoreInfo
+  # Regions maps the App Store regions in different format.
+  #
+  # AppStoreInfo::Regions.full_list will return a list of countries in the following format:
+  #   [{"Europe"=>
+  #     [{:code=>"AL", :name=>"Albania"},
+  #      {:code=>"AT", :name=>"Austria"},
+  #      {:code=>"BY", :name=>"Belarus"},...
+  #
+  # AppStoreInfo::Regions::territory_list is a list of countries available on App Store:
+  #
+  #   {"AE"=>"United Arab Emirates",
+  #    "AG"=>"Antigua and Barbuda",
+  #    "AI"=>"Anguilla",
+  #    "AL"=>"Albania",
+  #    "AM"=>"Armenia",...
+  class Regions
+    # All the available regions (taken from https://developer.apple.com/library/ios/documentation/
+    # LanguagesUtilities/Conceptual/iTunesConnect_Guide/Appendices/AppStoreTerritories.html
+    TERRITORIES = {
+      'AE' => 'United Arab Emirates',
+      'AG' => 'Antigua and Barbuda', 'AI' => 'Anguilla', 'AL' => 'Albania', 'AM' => 'Armenia',
+      'AO' => 'Angola', 'AR' => 'Argentina', 'AT' => 'Austria', 'AU' => 'Australia',
+      'AZ' => 'Azerbaijan', 'BB' => 'Barbados', 'BE' => 'Belgium', 'BF' => 'Burkina Faso',
+      'BG' => 'Bulgaria', 'BH' => 'Bahrain', 'BJ' => 'Benin', 'BM' => 'Bermuda',
+      'BN' => 'Brunei Darussalam', 'BO' => 'Bolivia', 'BR' => 'Brazil', 'BS' => 'Bahamas',
+      'BT' => 'Bhutan', 'BW' => 'Botswana', 'BY' => 'Belarus', 'BZ' => 'Belize', 'CA' => 'Canada',
+      'CG' => 'Republic Of Congo', 'CH' => 'Switzerland', 'CL' => 'Chile', 'CM' => 'Cameroon',
+      'CN' => 'China', 'CO' => 'Colombia', 'CR' => 'Costa Rica', 'CV' => 'Cape Verde',
+      'CY' => 'Cyprus', 'CZ' => 'Czech Republic', 'DE' => 'Germany', 'DK' => 'Denmark',
+      'DM' => 'Dominica', 'DO' => 'Dominican Republic', 'DZ' => 'Algeria', 'EC' => 'Ecuador',
+      'EE' => 'Estonia', 'EG' => 'Egypt', 'ES' => 'Spain', 'ET' => 'Ethiopia', 'FI' => 'Finland',
+      'FJ' => 'Fiji', 'FM' => 'Federated States Of Micronesia', 'FR' => 'France',
+      'GB' => 'United Kingdom', 'GD' => 'Grenada', 'GH' => 'Ghana', 'GM' => 'Gambia',
+      'GR' => 'Greece', 'GT' => 'Guatemala', 'GW' => 'Guinea-Bissau', 'GY' => 'Guyana',
+      'HK' => 'Hong Kong', 'HN' => 'Honduras', 'HR' => 'Croatia', 'HU' => 'Hungary',
+      'ID' => 'Indonesia', 'IE' => 'Ireland', 'IL' => 'Israel', 'IN' => 'India', 'IS' => 'Iceland',
+      'IT' => 'Italy', 'IQ' => 'Iraq', 'JM' => 'Jamaica',
+      'JO' => 'Jordan', 'JP' => 'Japan', 'KE' => 'Kenya', 'KG' => 'Kyrgyzstan', 'KH' => 'Cambodia',
+      'KN' => 'St. Kitts and Nevis', 'KR' => 'Republic Of Korea', 'KW' => 'Kuwait',
+      'KY' => 'Cayman Islands', 'KZ' => 'Kazakhstan', 'LA' => "Lao People's Democratic Republic",
+      'LB' => 'Lebanon', 'LC' => 'Santa Lucia', 'LK' => 'Sri Lanka', 'LR' => 'Liberia',
+      'LS' => 'Lesotho', 'LT' => 'Lithuania', 'LU' => 'Luxembourg', 'LV' => 'Latvia',
+      'MD' => 'Republic Of Moldova', 'MG' => 'Madagascar', 'MK' => 'Macedonia', 'ML' => 'Mali',
+      'MM' => 'Myanmar', 'MN' => 'Mongolia', 'MO' => 'Macau', 'MR' => 'Mauritania',
+      'MS' => 'Montserrat', 'MT' => 'Malta', 'MU' => 'Mauritius', 'MW' => 'Malawi',
+      'MX' => 'Mexico', 'MY' => 'Malaysia', 'MZ' => 'Mozambique', 'NA' => 'Namibia',
+      'NE' => 'Niger', 'NG' => 'Nigeria', 'NI' => 'Nicaragua', 'NL' => 'Netherlands',
+      'NO' => 'Norway', 'NP' => 'Nepal', 'NZ' => 'New Zealand', 'OM' => 'Oman', 'PA' => 'Panama',
+      'PE' => 'Peru', 'PG' => 'Papua New Guinea', 'PH' => 'Philippines', 'PK' => 'Pakistan',
+      'PL' => 'Poland', 'PS' => 'Palestinian Territory', 'PT' => 'Portugal', 'PW' => 'Palau',
+      'PY' => 'Paraguay', 'QA' => 'Qatar', 'RO' => 'Romania', 'RU' => 'Russia', 'RW' => 'Rwanda',
+      'SA' => 'Saudi Arabia', 'SB' => 'Solomon Islands', 'SC' => 'Seychelles', 'SE' => 'Sweden',
+      'SG' => 'Singapore', 'SI' => 'Slovenia', 'SK' => 'Slovakia', 'SL' => 'Sierra Leone',
+      'SN' => 'Senegal', 'SR' => 'Suriname', 'SS' => 'South Sudan',
+      'ST' => 'Sao Tome and Principe', 'SV' => 'El Salvador', 'SZ' => 'Swaziland',
+      'TC' => 'Turks and Caicos', 'TD' => 'Chad', 'TH' => 'Thailand', 'TJ' => 'Tajikistan',
+      'TM' => 'Turkmenistan', 'TN' => 'Tunisia', 'TR' => 'Turkey', 'TT' => 'Trinidad and Tobago',
+      'TW' => 'Taiwan', 'TZ' => 'Tanzania', 'UA' => 'Ukraine', 'UG' => 'Uganda',
+      'US' => 'United States', 'UY' => 'Uruguay', 'UZ' => 'Uzbekistan',
+      'VC' => 'St. Vincent and The Grenadines', 'VE' => 'Venezuela',
+      'VG' => 'British Virgin Islands', 'VN' => 'Vietnam', 'YE' => 'Yemen',
+      'ZA' => 'South Africa', 'ZM' => 'Zambia', 'ZW' => 'Zimbabwe'
+    }.freeze
+
+    REGIONS = {
+      'Europe' => %w[
+        AL AT BY BE BG HR CY CZ DK EE FI FR DE GR HU IS IE IT LV LT LU MK MT MD NL NO PL PT RO RU
+        SK SI ES SE CH TR UA GB
+      ],
+
+      'Africa, Middle East, and India' => %w[
+        DZ AO AM AZ BH BJ BW BF CM CV TD CG EG ET GM GH GW IN IL IQ JO KE KW LB LS LR MG MW ML MR MU
+        MZ NA NE NG OM PS QA RW SA SN SC SS SL ZA SZ ST TZ TN UG AE YE ZM ZW
+      ],
+
+      'Latin America and the Caribbean' => %w[
+        AI AG AR BS BB BZ BM BO BR KY CL CO CR DM DO EC SV GD GT GY HN JM MX MS NI PA PY PE LC KN
+        VC SR TT TC UY VE VG
+      ],
+
+      'Asia Pacific' => %w[
+        AU BT BN KH CN FJ HK ID JP KZ KR KG LA MO MY FM MM MN NP NZ PK PW PG PH SG SB LK TW TJ TH TM
+        UZ VN
+      ],
+
+      'The United States and Canada' => %w[CA US]
+    }.freeze
+
+    # Find a territory by code.
+    #
+    #   AppStoreInfo::Regions.find('PT')
+    #   # => "Portugal"
+    def self.find(code)
+      territory_list[code.upcase]
+    end
+
+    def self.full_list
+      REGIONS.map do |region|
+        { region.first => region.last.map { |code| { code: code, name: TERRITORIES[code] } } }
+      end
+    end
+
+    def self.territory_list
+      TERRITORIES
+    end
+  end
+end

data/lib/appstore_info/version.rb

@@ -0,0 +1,3 @@
+module AppStoreInfo
+  VERSION = '2.0'.freeze
+end

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification
+name: eq_appstore_info
+version: !ruby/object:Gem::Version
+  version: '2.0'
+platform: ruby
+authors:
+- Ricardo Otero
+- Maximilian Szengel
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2020-10-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.49'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.49'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+description: Get details about any app in the Apple App Store
+email:
+- oterosantos@gmail.com
+- szengel@equinux.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- appstore_info.gemspec
+- bin/console
+- bin/setup
+- lib/appstore_info.rb
+- lib/appstore_info/api.rb
+- lib/appstore_info/app.rb
+- lib/appstore_info/genres.rb
+- lib/appstore_info/json_accessors.rb
+- lib/appstore_info/regions.rb
+- lib/appstore_info/version.rb
+homepage: https://github.com/equinux/appstore_info
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
+summary: App Store parser
+test_files: []