The great return of SC2

CHANGELOG.md

 Please view this file on the master branch, otherwise it may be outdated
 
+**Version 0.3.6**
+
+Fix Diablo shortcuts.
+Adding SC2 endpoints back.
+ 
+https://us.forums.blizzard.com/en/blizzard/t/starcraft-ii-community-api-update/2652/5
+
 **Version 0.3.5**
 
 Fixed a bug for generating slugs for Korean

Gemfile.lock

 PATH
   remote: .
   specs:
-    blizzard_api (0.3.5)
+    blizzard_api (0.3.6)
       redis (~> 4.1, >= 4.1.0)
 
 GEM

README.md

@@ -16,6 +16,7 @@ This gem allow you to interface with the new blizzard api (2018) using the OAuth
    - 4.1. [World of Warcraft endpoints](#41-world-of-warcraft-endpoints)
    - 4.2. [Diablo III endpoints](#42-diablo-iii-endpoints)
    - 4.3. [Hearthstone endpoints](#43-hearthstone-endpoints)
+   - 4.4. [Starcraft II endpoints](#43-starcraft-ii-endpoints)
 
 ## 1. Installation
 
@@ -284,6 +285,24 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
 * BlizzardApi::Hearthstone::Metadata
   - index
   - get :type
+  
+### 4.4. Starcraft II endpoints
+
+Every endpoint requiring a *region_id* parameter will accepts either the integer representation of the region described in the api docs or a symbol: `:US`, `:EU`, `:KO` or `:TW` 
+
+* BlizzardApi::Starcraft::League
+  - get :season_id, :queue_id, :team_type, :league_id
+* BlizzardApi::Starcraft::Profile
+  - static :region_id
+  - metadata :region_id, :realm_id, :profile_id
+  - profile :region_id, :realm_id, :profile_id
+  - ladder_summary :region_id, :realm_id, :profile_id
+  - ladder :region_id, :realm_id, :profile_id, :ladder_id
+* BlizzardApi::Starcraft::Ladder
+  - grandmaster :region_id, :options
+  - season :region_id
+* BlizzardApi::Starcraft::Account
+  - player :account_id
 
 ## Contributing
 

lib/blizzard_api.rb

@@ -7,6 +7,7 @@ require_relative 'blizzard_api/version'
 require_relative 'blizzard_api/wow'
 require_relative 'blizzard_api/diablo'
 require_relative 'blizzard_api/hearthstone'
+require_relative 'blizzard_api/starcraft'
 
 # Blizzard namespace
 module BlizzardApi

lib/blizzard_api/diablo.rb

@@ -12,13 +12,13 @@ module BlizzardApi
 
     ##
     # @return {Season}
-    def season
+    def self.season
       BlizzardApi::Diablo::Season.new
     end
 
     ##
     # @return {Era}
-    def era
+    def self.era
       BlizzardApi::Diablo::Era.new
     end
 
@@ -33,43 +33,43 @@ module BlizzardApi
 
     ##
     # @return {Act}
-    def act
+    def self.act
       BlizzardApi::Diablo::Act.new
     end
 
     ##
     # @return {Artisan}
-    def artisan
+    def self.artisan
       BlizzardApi::Diablo::Artisan.new
     end
 
     ##
     # @return {Follower}
-    def follower
+    def self.follower
       BlizzardApi::Diablo::Follower.new
     end
 
     ##
     # @return {Character}
-    def character
+    def self.character
       BlizzardApi::Diablo::Character.new
     end
 
     ##
     # @return {ItemType}
-    def item_type
+    def self.item_type
       BlizzardApi::Diablo::ItemType.new
     end
 
     ##
     # @return {Type}
-    def item
+    def self.item
       BlizzardApi::Diablo::Item.new
     end
 
     ##
     # @return {Profile}
-    def profile
+    def self.profile
       BlizzardApi::Diablo::Profile.new
     end
   end

lib/blizzard_api/diablo/community/profile.rb

@@ -22,7 +22,7 @@ module BlizzardApi
       # @see https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow
       def index(battletag, oauth_token, options = {})
         opts = { access_token: oauth_token, ttl: CACHE_TRIMESTER }.merge(options)
-        api_request "#{base_url(:community)}/data/profile/#{battletag}", opts
+        api_request "#{base_url(:community)}/data/profile/#{parse_battle_tag(battletag)}", opts
       end
 
       ##
@@ -38,7 +38,7 @@ module BlizzardApi
       # @see https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow
       def hero(battletag, oauth_token, hero_id, options = {})
         opts = { access_token: oauth_token, ttl: CACHE_TRIMESTER }.merge(options)
-        api_request "#{base_url(:community)}/data/profile/#{battletag}/hero/#{hero_id}", opts
+        api_request "#{base_url(:community)}/data/profile/#{parse_battle_tag(battletag)}/hero/#{hero_id}", opts
       end
 
       ##
@@ -54,7 +54,7 @@ module BlizzardApi
       # @see https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow
       def hero_items(battletag, oauth_token, hero_id, options = {})
         opts = { access_token: oauth_token, ttl: CACHE_TRIMESTER }.merge(options)
-        api_request "#{base_url(:community)}/data/profile/#{battletag}/hero/#{hero_id}/items", opts
+        api_request "#{base_url(:community)}/data/profile/#{parse_battle_tag(battletag)}/hero/#{hero_id}/items", opts
       end
 
       ##
@@ -70,7 +70,13 @@ module BlizzardApi
       # @see https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow
       def hero_follower_items(battletag, oauth_token, hero_id, options = {})
         opts = { access_token: oauth_token, ttl: CACHE_TRIMESTER }.merge(options)
-        api_request "#{base_url(:community)}/data/profile/#{battletag}/hero/#{hero_id}/follower-items", opts
+        api_request "#{base_url(:community)}/data/profile/#{parse_battle_tag(battletag)}/hero/#{hero_id}/follower-items", opts
+      end
+
+      private
+
+      def parse_battle_tag(battletag)
+        battletag.sub('#', '-')
       end
     end
   end

lib/blizzard_api/starcraft.rb

+# frozen_string_literal: true
+
+module BlizzardApi
+  # Starcraft II related classes
+  module Starcraft
+    require_relative 'starcraft/request'
+
+    # Starcraft II data api
+    require_relative 'starcraft/game_data/league'
+
+    ##
+    # @return {League}
+    def self.league
+      BlizzardApi::Starcraft::League.new
+    end
+
+    # Starcraft community api
+    require_relative 'starcraft/community/profile'
+    require_relative 'starcraft/community/ladder'
+    require_relative 'starcraft/community/account'
+
+    ##
+    # @return {Profile}
+    def self.profile
+      BlizzardApi::Starcraft::Profile.new
+    end
+
+    ##
+    # @return {Ladder}
+    def self.ladder
+      BlizzardApi::Starcraft::Ladder.new
+    end
+
+    ##
+    # @return {Account}
+    def self.account
+      BlizzardApi::Starcraft::Account.new
+    end
+  end
+end

lib/blizzard_api/starcraft/community/account.rb

+# frozen_string_literal: true
+
+module BlizzardApi
+  module Starcraft
+    ##
+    # This class allows access to Starcraft II league data
+    #
+    # @see https://develop.battle.net/documentation/api-reference/starcraft-2-game-data-api
+    #
+    # You can get an instance of this class using the default region as follows:
+    #   api_instance = BlizzardApi::Starcraft.account
+    class Account < Starcraft::Request
+      ##
+      # Returns information about a player account
+      #
+      # @param [Integer] account_id Account ID
+      # @!macro request_options
+      def player(account_id, options = {})
+        api_request "#{base_url(:community)}/player/#{account_id}", { ttl: CACHE_DAY }.merge(options)
+      end
+    end
+  end
+end

lib/blizzard_api/starcraft/community/ladder.rb

+# frozen_string_literal: true
+
+module BlizzardApi
+  module Starcraft
+    ##
+    # This class allows access to Starcraft II ladder data
+    #
+    # @see https://develop.battle.net/documentation/api-reference/starcraft-2-game-data-api
+    #
+    # You can get an instance of this class using the default region as follows:
+    #   api_instance = BlizzardApi::Starcraft.ladder
+    class Ladder < Starcraft::Request
+      ##
+      # Grandmaster endpoint
+      #
+      # @!macro sc2_regions
+      # @!macro request_options
+      def grandmaster(region_id, options = {})
+        reg = resolve_region(region_id)
+        api_request "#{base_url(:community)}/ladder/grandmaster/#{reg}", { ttl: CACHE_DAY }.merge(options)
+      end
+
+      ##
+      # Season endpoint
+      #
+      # @!macro sc2_regions
+      # @!macro request_options
+      def season(region_id, options = {})
+        reg = resolve_region(region_id)
+        api_request "#{base_url(:community)}/ladder/season/#{reg}", { ttl: CACHE_DAY }.merge(options)
+      end
+    end
+  end
+end

lib/blizzard_api/starcraft/community/profile.rb

+# frozen_string_literal: true
+
+module BlizzardApi
+  module Starcraft
+    ##
+    # This class allows access to Starcraft II profile data
+    #
+    # @see https://develop.battle.net/documentation/api-reference/starcraft-2-game-data-api
+    #
+    # You can get an instance of this class using the default region as follows:
+    #   api_instance = BlizzardApi::Starcraft.profile
+    class Profile < Starcraft::Request
+      ##
+      # Static profile data
+      #
+      # @!macro sc2_regions
+      # @!macro request_options
+      def static(region_id, options = {})
+        reg = resolve_region(region_id)
+        api_request "#{base_url(:community)}/static/profile/#{reg}", { ttl: CACHE_DAY }.merge(options)
+      end
+
+      ##
+      # Metadata
+      #
+      # @!macro sc2_regions
+      # @param [Integer] realm_id Realm ID
+      # @param [Integer] profile_id Profile ID
+      # @!macro request_options
+      def metadata(region_id, realm_id, profile_id, options = {})
+        reg = resolve_region(region_id)
+        opts = { ttl: CACHE_DAY }.merge(options)
+        api_request "#{base_url(:community)}/metadata/profile/#{reg}/#{realm_id}/#{profile_id}", opts
+      end
+
+      ##
+      # Profile data
+      #
+      # @!macro sc2_regions
+      # @param [Integer] realm_id Realm ID
+      # @param [Integer] profile_id Profile ID
+      # @!macro request_options
+      def profile(region_id, realm_id, profile_id, options = {})
+        reg = resolve_region(region_id)
+        opts = { ttl: CACHE_DAY }.merge(options)
+        api_request "#{base_url(:community)}/profile/#{reg}/#{realm_id}/#{profile_id}", opts
+      end
+
+      ##
+      # Ladder summary
+      #
+      # @!macro sc2_regions
+      # @param [Integer] realm_id Realm ID
+      # @param [Integer] profile_id Profile ID
+      # @!macro request_options
+      def ladder_summary(region_id, realm_id, profile_id, options = {})
+        reg = resolve_region(region_id)
+        opts = { ttl: CACHE_DAY }.merge(options)
+        api_request "#{base_url(:community)}profile/#{reg}/#{realm_id}/#{profile_id}/ladder/summary ", opts
+      end
+
+      ##
+      # Ladder data
+      #
+      # @!macro sc2_regions
+      # @param [Integer] realm_id Realm ID
+      # @param [Integer] profile_id Profile ID
+      # @!macro request_options
+      def ladder(region_id, realm_id, profile_id, ladder_id, options = {})
+        reg = resolve_region(region_id)
+        opts = { ttl: CACHE_DAY }.merge(options)
+        api_request "#{base_url(:community)}/profile/#{reg}/#{realm_id}/#{profile_id}/ladder/#{ladder_id}", opts
+      end
+    end
+  end
+end

lib/blizzard_api/starcraft/game_data/league.rb

+# frozen_string_literal: true
+
+module BlizzardApi
+  module Starcraft
+    ##
+    # This class allows access to Starcraft II league data
+    #
+    # @see https://develop.battle.net/documentation/api-reference/starcraft-2-game-data-api
+    #
+    # You can get an instance of this class using the default region as follows:
+    #   api_instance = BlizzardApi::Starcraft.league
+    class League < Starcraft::Request
+      ##
+      # Return information about league
+      #
+      # @param [Integer] season_id Season id
+      # @param [Integer] queue_id Queue id
+      # @param [Integer] team_type Team type
+      # @param [Integer] league_id League id
+      # @!macro request_options
+      def get(season_id, queue_id, team_type, league_id, options = {})
+        opts = { ttl: CACHE_DAY }.merge(options)
+        api_request "#{base_url(:game_data)}/league/#{season_id}/#{queue_id}/#{team_type}/#{league_id}", opts
+      end
+    end
+  end
+end

lib/blizzard_api/starcraft/request.rb

+# frozen_string_literal: true
+
+##
+# @!macro [new] sc2_regions
+#   @param {Symbol} region_id One of the valid Starcraft II regions *:US*, *:EU*, *:KO*, and *:TW*
+#   @note This gem do not support nor will support China endpoints
+
+module BlizzardApi
+  module Starcraft
+    ##
+    # Starcraft requests
+    class Request < BlizzardApi::Request
+      # Possible regions for the SC II API (Except China)
+      SC_REGION = { US: 1, EU: 2, KO: 3, TW: 3 }.freeze
+
+      ##
+      # @!macro regions
+      def initialize(region = nil)
+        super region
+        @game = 'sc2'
+      end
+
+      private
+
+      ##
+      # Helper method to find a region_id by its symbol
+      def resolve_region(region_arg)
+        return region_arg if region_arg.is_a? Integer
+
+        return SC_REGION[region_arg] if region_arg.is_a? Symbol
+
+        raise ArgumentError, 'Invalid region, please read the documentation'
+      end
+    end
+  end
+end

lib/blizzard_api/version.rb

@@ -2,5 +2,5 @@
 
 module BlizzardApi
   # Gem version
-  VERSION = '0.3.5'
+  VERSION = '0.3.6'
 end

test/blizzard/starcraft/community/ladder_test.rb

+# frozen_string_literal: true
+
+require 'test_helper'
+
+module BlizzardApi
+  module Starcraft
+    class LadderTest < Minitest::Test
+      def test_ladder_grandmaster
+        ladder = BlizzardApi::Starcraft::Ladder.new
+        ladder_data = ladder.grandmaster :US
+        assert ladder_data[:ladderTeams]
+      end
+
+      def test_ladder_season
+        ladder = BlizzardApi::Starcraft::Ladder.new
+        ladder_data = ladder.season :US
+        assert ladder_data[:year]
+      end
+    end
+  end
+end

test/blizzard/starcraft/community/profile_test.rb

+# frozen_string_literal: true
+
+require 'test_helper'
+
+module BlizzardApi
+  module Starcraft
+    class ProfileTest < Minitest::Test
+      def test_profile_static
+        profile = BlizzardApi::Starcraft::Profile.new
+        profile_data = profile.static :US
+        assert profile_data[:achievements]
+      end
+    end
+  end
+end

test/blizzard/starcraft/game_data/league_test.rb

+# frozen_string_literal: true
+
+require 'test_helper'
+
+module BlizzardApi
+  module Starcraft
+    class LeagueTest < Minitest::Test
+      def test_league_get
+        league = BlizzardApi::Starcraft::League.new
+        league_data = league.get 37, 201, 0, 6
+        assert league_data[:tier]
+      end
+    end
+  end
+end

test/blizzard/wow/game_data/reputation_test.rb

@@ -11,7 +11,7 @@ module BlizzardApi
 
       def test_reputation_faction_index
         reputation_data = @reputation.factions
-        assert_equal 199, reputation_data[:factions].count
+        assert reputation_data.key? :factions
       end
 
       def test_reputation_faction_get

test/blizzard/wow/profile/character_test.rb

@@ -21,7 +21,7 @@ module BlizzardApi
 
       def test_character_achievement_statistics
         character_data = @character.achievement_statistics 'Azralon', 'Schiller'
-        assert character_data.key? :statistics
+        assert character_data.key? :categories
       end
 
       def test_character_appearance
@@ -65,7 +65,7 @@ module BlizzardApi
         assert character_data.key? :in_progress
 
         character_data = @character.quests 'Azralon', 'Schiller', true
-        assert_equal 8985, character_data[:quests].count
+        assert character_data.key? :quests
       end
 
       def test_character_specializations