starcall 0.2.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 747f4858cbdbfc589afaea575efb50a1ab13cb6b17ea4c8a00e7d8531372ff45
-  data.tar.gz: 7343bf8040d4a954f7f9c28724053bfad8d97ea4c145d1a028607b900d539bb3
+  metadata.gz: 29a7b323bcbf19c0a0fae436919ee5ec3d3698cc608090ef59f770dd0bef4fc1
+  data.tar.gz: 6ad054eb9ae3fa78169e56543753293802aca6d5f093787763ad6bd081d52e61
 SHA512:
-  metadata.gz: 7d648c379749197d1c35f5a18ffffa6661741a12b704cb1ca10ab27df84c81640c2f56650ee7feb32363276beb222a0bedec5806702a5dc0b19d6c66dad64e7f
-  data.tar.gz: cd19a5a3963fc1a6240877ebba5f2020c76165b56f12d9d887ee2d3a961c75ec70134252227626527b6b5be0844c951e037facf95a2ab92d5b44d22752db7d29
+  metadata.gz: '099f43356b97db57e5a99b2c861014468eb03f365524acdf80346f2069b772a5618e0da21966b8465b79861b8b1cb7f6edfe93312e11c7d8a09810959e661a72'
+  data.tar.gz: 765b7820ae2aa969981289540efece962e485e2756761967a83a193dc94d7c8179cacd75606f5feb75ccb147acfbe41151eb0f4bd06925c4fea8440be2162ad6

data/.rakeTasks

@@ -4,4 +4,4 @@ You are allowed to:
 1. Remove rake task
 2. Add existing rake tasks
 To add existing rake tasks automatically delete this file and reload the project.
---><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build Starcall-0.1.0.gem into the pkg directory" fullCmd="build" taksId="build" /><RakeTask description="Remove any temporary products" fullCmd="clean" taksId="clean" /><RakeTask description="Remove any generated files" fullCmd="clobber" taksId="clobber" /><RakeTask description="Build and install Starcall-0.1.0.gem into system gems" fullCmd="install" taksId="install" /><RakeGroup description="" fullCmd="" taksId="install"><RakeTask description="Build and install Starcall-0.1.0.gem into system gems without network access" fullCmd="install:local" taksId="local" /></RakeGroup><RakeTask description="Create tag v0.1.0 and build and push Starcall-0.1.0.gem to TODO: Set to 'http://mygemserver.com'" fullCmd="release[remote]" taksId="release[remote]" /><RakeTask description="Run RuboCop" fullCmd="rubocop" taksId="rubocop" /><RakeGroup description="" fullCmd="" taksId="rubocop"><RakeTask description="Auto-correct RuboCop offenses" fullCmd="rubocop:auto_correct" taksId="auto_correct" /></RakeGroup><RakeTask description="Run RSpec code examples" fullCmd="spec" taksId="spec" /><RakeGroup description="" fullCmd="" taksId="travis"><RakeTask description="Run rubocop and rspec" fullCmd="travis:run" taksId="run" /></RakeGroup><RakeTask description="" fullCmd="release" taksId="release" /><RakeGroup description="" fullCmd="" taksId="release"><RakeTask description="" fullCmd="release:guard_clean" taksId="guard_clean" /><RakeTask description="" fullCmd="release:rubygem_push" taksId="rubygem_push" /><RakeTask description="" fullCmd="release:source_control_push" taksId="source_control_push" /></RakeGroup></RakeGroup></Settings>
+--><RakeGroup description="" fullCmd="" taksId="rake" /></Settings>

data/CHANGELOG.md

@@ -13,8 +13,84 @@ None
 
 ---
 
+## v0.6.0 - Annie
+![Annie](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Annie.png)
+
+### New features
+- Add Status V3 endpoint.
+- Add third party code endpoint.
+- Add Spectator endpoints.
+
+### Changes
+None
+
+### Bug fixes
+None
+
+---
+
+## v0.5.0 - Anivia
+![Anivia](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Anivia.png)
+
+### New features
+- Add Clash V1 endpoint.
+- Add the summoner endpoint.
+
+### Changes
+None
+
+### Bug fixes
+- Add Champion V3 to the endpoints file, making it accessible.
+
+---
+
+## v0.4.0 - Amumu
+![Amumu](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Amumu.png)
+
+### New features
+- Added the champion endpoints.
+
+### Changes
+None
+
+### Bug fixes
+None
+
+---
+
+## v0.3.0 - Alistar
+![Alistar](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Alistar.png)
+
+### New features
+- Added the 3 Champion Mastery Endpoints. 
+- `ApiRequests` now checks for an API key called `RIOT_API_KEY` and adds to the headers.
+- Added a region parser as the API URLs require a region, but they are not the same as the normal regions.
+
+### Changes
+- Move `ApiRequests` under the `Starcall` namespace.
+- Move errors in to their own directory.
+
+### Bug fixes
+None
+
+---
+
+## v0.2.1 - Akali
+![Akali](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Akali.png)
+
+### New features
+None
+
+### Changes
+None
+
+### Bug fixes 
+- The program now functions correctly with the details in the read me.
+
+---
+
 ## v0.2.0 - Ahri
-![Aatrox](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Ahri.png)
+![Ahri](http://ddragon.leagueoflegends.com/cdn/10.12.1/img/champion/Ahri.png)
 
 ### New features
 - Regions

data/Gemfile.lock

@@ -1,17 +1,19 @@
 PATH
   remote: .
   specs:
-    starcall (0.2.0)
+    starcall (0.5.0)
       httparty (~> 0.17)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.1)
+    coderay (1.1.3)
     diff-lcs (1.3)
     httparty (0.18.1)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
+    method_source (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2020.0512)
@@ -19,6 +21,9 @@ GEM
     parallel (1.19.2)
     parser (2.7.1.4)
       ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
     rainbow (3.0.0)
     rake (12.3.3)
     regexp_parser (1.7.1)
@@ -58,6 +63,7 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 2.0)
+  pry (~> 0.13)
   rake (~> 12.3)
   rspec (~> 3.0)
   rubocop (~> 0.86)
@@ -65,4 +71,4 @@ DEPENDENCIES
   starcall!
 
 BUNDLED WITH
-   2.0.2
+   2.1.4

data/README.md

@@ -119,6 +119,175 @@ Details about summoner spells.
 
 Details about profile icons and where they can be found on the sprite sheets.
 
+## Endpoints
+The below commands require a Riot API key.
+It needs to be saved as an ENV var and called `RIOT_API_KEY`
+### SummonerV4
+#### `by_account_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#summoner-v4/GET_getByAccountId)
+
+Required fields:
+- `encrypted_summoner_id` (The encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
+#### `by_summoner_name`
+[Riot API Documentation](https://developer.riotgames.com/apis#summoner-v4/GET_getBySummonerName)
+
+Required fields:
+- `summoner_name` (The summoner name for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
+#### `by_puuid`
+[Riot API Documentation](https://developer.riotgames.com/apis#summoner-v4/GET_getByPUUID)
+
+Required fields:
+- `puuid` (The puuid for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
+#### `by_summoner_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#summoner-v4/GET_getBySummonerId)
+
+Required fields:
+- `summoner_id` (The summoner id for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
+### Champion Mastery V4
+
+#### `summoner`
+[Riot API Documentation](https://developer.riotgames.com/apis#champion-mastery-v4/GET_getAllChampionMasteries)
+
+Required fields:
+- `encrypted_summoner_id` (The encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+#### `summoner_on_champion`
+[Riot API Documentation](https://developer.riotgames.com/apis#champion-mastery-v4/GET_getChampionMastery)
+
+Required fields:
+- `encrypted_summoner_id` (The encrypted summoner ID for the summoner you want to know about.)
+- `champion_id` (The ID number of the champion that you want to know about.)
+- `region` (The region that the summoner is in.)
+
+#### `summoner_total_mastery`
+[Riot API Documentation](https://developer.riotgames.com/apis#champion-mastery-v4/GET_getChampionMasteryScore)
+
+Required fields:
+- `encrypted_summoner_id` (the encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+### Champion V3
+#### `champion_rotations`
+[Riot API Documentation](https://developer.riotgames.com/apis#champion-v3/GET_getChampionInfo)
+
+Required fields:
+- None
+
+Optional fields:
+- `region` (By default it will assume `euw`, if you want to know for a specific region, you can pass that in.)
+
+### Clash V3
+#### `clash_by_summoner_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#clash-v1/GET_getPlayersBySummoner)
+
+Required fields:
+- `encrypted_summoner_id` (the encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+- None
+
+#### `clash_by_team_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#clash-v1/GET_getTeamById)
+
+Required fields:
+- `team_id` (the team ID for the team you want to know about.)
+- `region` (The region that the team is in.)
+
+Optional fields:
+- None
+
+#### `clash_tournaments`
+[Riot API Documentation](https://developer.riotgames.com/apis#clash-v1/GET_getTournaments)
+
+Required fields:
+- `region` (The region that you want to know about.)
+
+Optional fields:
+- None
+
+#### `clash_tournaments_by_team_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#clash-v1/GET_getTournaments)
+
+Required fields:
+- `team_id` (the team ID for the team you want to know about.)
+- `region` (The region that the team is in.)
+
+Optional fields:
+- None
+
+#### `clash_tournaments_by_tournament_id`
+[Riot API Documentation](https://developer.riotgames.com/apis#clash-v1/GET_getTournaments)
+
+Required fields:
+- `tournament_id` (the tournament ID for the tournament you want to know about.)
+- `region` (The region that the tournament is in.)
+
+Optional fields:
+- None
+
+### SpectatorV4
+#### `summoner_game_info`
+[Riot API Documentation](https://developer.riotgames.com/apis#spectator-v4/GET_getCurrentGameInfoBySummoner)
+
+Required fields:
+- `encrypted_summoner_id` (The encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
+#### `featured_games`
+[Riot API Documentation](https://developer.riotgames.com/apis#spectator-v4/GET_getFeaturedGames)
+
+Required fields:
+None
+
+Optional fields:
+- `region` (By default it will assume `euw`, if you want to know for a specific region, you can pass that in.)
+
+### Status V3
+#### `status_data`
+[Riot API Documentation](https://developer.riotgames.com/apis#lol-status-v3/GET_getShardData)
+
+Required fields:
+- None
+
+Optional fields:
+- `region` (By default it will assume `euw`, if you want to know for a specific region, you can pass that in.)
+
+### ThirdPartyCodeV4
+#### `check_for_summoner`
+[Riot API Documentation](https://developer.riotgames.com/apis#third-party-code-v4)
+
+Required fields:
+- `encrypted_summoner_id` (The encrypted summoner ID for the summoner you want to know about.)
+- `region` (The region that the summoner is in.)
+
+Optional fields:
+None
+
 ## Development
 
 After checking out the repo, run `bundle install` to install dependencies. 

data/lib/starcall.rb

@@ -1,7 +1,12 @@
 # frozen_string_literal: true
 
+require 'starcall/endpoints/endpoints'
+require 'starcall/errors/errors'
+require 'starcall/languages'
+require 'starcall/regions'
+require 'starcall/static_data'
 require 'starcall/version'
 
+# The root of it all
 module Starcall
-  class Error < StandardError; end
 end

data/lib/starcall/api_requests.rb

@@ -2,9 +2,12 @@
 
 require 'httparty'
 
-# A small class to make a HTTP get request using the passed in URL
-class ApiRequests
-  def self.make_request(url:)
-    HTTParty.get(url).parsed_response
+module Starcall
+  # A small class to make a HTTP get request using the passed in URL
+  # Intened to only be used my internal Gem classes and not be called directly.
+  class ApiRequests
+    def self.make_request(url:)
+      HTTParty.get(url, { headers: { 'X-Riot-Token' => ENV['RIOT_API_KEY'] } }).parsed_response
+    end
   end
 end

data/lib/starcall/endpoints/champion_mastery_v4.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods used to call the Champion Mastery endpoints.
+    class ChampionMasteryV4
+      # Get all champion mastery entries sorted by number of champion points descending.
+      def self.summoner(encrypted_summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/champion-mastery/v4/champion-masteries/by-summoner/#{encrypted_summoner_id}"
+        )
+      end
+
+      # Get a champion mastery by player ID and champion ID.
+      def self.summoner_on_champion(encrypted_summoner_id:, champion_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/champion-mastery/v4/champion-masteries/by-summoner/#{encrypted_summoner_id}"\
+               "/by-champion/#{champion_id}"
+        )
+      end
+
+      # Get a player's total champion mastery score, which is the sum of individual champion mastery levels.
+      def self.summoner_total_mastery(encrypted_summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/champion-mastery/v4/scores/by-summoner/#{encrypted_summoner_id}"
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/champion_v3.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods used to call the Champion endpoints.
+    class ChampionV3
+      # Returns champion rotations, including free-to-play and low-level free-to-play rotations
+      def self.champion_rotations(region: 'euw')
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               '/lol/platform/v3/champion-rotations'
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/clash_v1.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods used to get information about clash
+    class ClashV1
+      # Get players by summoner ID.
+      def self.clash_by_summoner_id(encrypted_summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/clash/v1/players/by-summoner/#{encrypted_summoner_id}"
+        )
+      end
+
+      # Get team by ID.
+      def self.clash_by_team_id(team_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/clash/v1/teams/#{team_id}"
+        )
+      end
+
+      # Get all active or upcoming tournaments.
+      def self.clash_tournaments(region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com/lol/clash/v1/tournaments"
+        )
+      end
+
+      # Get tournament by team ID.
+      def self.clash_tournaments_by_team_id(team_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/clash/v1/tournaments/by-team/#{team_id}"
+        )
+      end
+
+      # Get tournament by ID
+      def self.clash_tournaments_by_tournament_id(tournament_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/clash/v1/tournaments/#{tournament_id}"
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/endpoints.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative 'champion_mastery_v4'
+require_relative 'champion_v3'
+require_relative 'clash_v1'
+require_relative 'summoner_v4'
+require_relative 'status_v3'
+require_relative 'spectator_v4'
+require_relative 'third_party_code_v4'

data/lib/starcall/endpoints/spectator_v4.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods for getting spectator information
+    class SpectatorV4
+      # Get current game information for the given summoner ID
+      def self.summoner_game_info(encrypted_summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/spectator/v4/active-games/by-summoner/#{encrypted_summoner_id}"
+        )
+      end
+
+      # Get list of featured games
+      def self.featured_games(region: 'euw')
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               '/lol/spectator/v4/featured-games'
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/status_v3.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Method to check the status of services in a region
+    class StatusV3
+      # Get League of Legends status for the given shard
+      def self.status_data(region: 'euw')
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               '/lol/status/v3/shard-data'
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/summoner_v4.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods used to get information about summoners.
+    class SummonerV4
+      # Get a summoner by account ID.
+      def self.by_account_id(encrypted_account_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/summoner/v4/summoners/by-account/#{encrypted_account_id}"
+        )
+      end
+
+      # Get a summoner by summoner name.
+      def self.by_summoner_name(summoner_name:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/summoner/v4/summoners/by-name/#{summoner_name}"
+        )
+      end
+
+      # Get a summoner by PUUID.
+      def self.by_puuid(puuid:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/summoner/v4/summoners/by-puuid/#{puuid}"
+        )
+      end
+
+      # Get a summoner by summoner ID.
+      def self.by_summoner_id(summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/summoner/v4/summoners/#{summoner_id}"
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/endpoints/third_party_code_v4.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'starcall/helpers/region_parser'
+require 'starcall/api_requests'
+
+module Starcall
+  module Endpoints
+    # Methods to check 3rd party codes
+    class ThirdPartyCodeV4
+      # Get third party code for a given summoner ID
+      def self.check_for_summoner(encrypted_summoner_id:, region:)
+        Starcall::Regions.valid?(region: region)
+        Starcall::ApiRequests.make_request(
+          url: "https://#{parse_region(region: region)}.api.riotgames.com"\
+               "/lol/platform/v4/third-party-code/by-summoner/#{encrypted_summoner_id}"
+        )
+      end
+
+      def self.parse_region(region:)
+        Starcall::Helpers::RegionParser.parse(region: region)
+      end
+
+      private_class_method :parse_region
+    end
+  end
+end

data/lib/starcall/errors/errors.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'invalid_language'
+require_relative 'invalid_region'

data/lib/starcall/{error.rb → errors/invalid_language.rb}

@@ -1,23 +1,7 @@
 # frozen_string_literal: true
 
 module Starcall
-  module Error
-    # A Custom error message, used when an incorrect region is passed.
-    class InvalidRegion < StandardError
-      def initialize(region:)
-        super
-        @region = region
-      end
-
-      def message
-        "#{region} is not a valid region. Please consult Starcall::Regions.list for a list of valid regions."
-      end
-
-      private
-
-      attr_reader :region
-    end
-
+  module Errors
     # A Custom error message, used when an incorrect language is passed.
     class InvalidLanguage < StandardError
       def initialize(language:)

data/lib/starcall/errors/invalid_region.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Starcall
+  module Errors
+    # A Custom error message, used when an incorrect region is passed.
+    class InvalidRegion < StandardError
+      def initialize(region:)
+        super
+        @region = region
+      end
+
+      def message
+        "#{region} is not a valid region. Please consult Starcall::Regions.list for a list of valid regions."
+      end
+
+      private
+
+      attr_reader :region
+    end
+  end
+end

data/lib/starcall/helpers/region_parser.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'starcall/regions'
+
+module Starcall
+  module Helpers
+    # The API URLs don't use the actual region name, they used different ones.
+    # This converts from a region name to the URL string.
+    class RegionParser
+      def self.parse(region:)
+        Starcall::Regions.valid?(region: region)
+
+        region_matchup = {
+          br: 'br1',
+          eune: 'eun1',
+          euw: 'euw1',
+          lan: 'la1',
+          las: 'la2',
+          na: 'na1',
+          oce: 'oc1',
+          ru: 'ru',
+          tr: 'tr1',
+          jp: 'jp1',
+          kr: 'kr'
+        }
+        region_matchup[region.to_sym]
+      end
+    end
+  end
+end

data/lib/starcall/languages.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'starcall/error'
-
 module Starcall
   # This class is used to list and validate languages.
   class Languages
@@ -45,7 +43,7 @@ module Starcall
     def self.valid?(language:)
       return true if list.include? language
 
-      raise Starcall::Error::InvalidLanguage.new(language: language)
+      raise Starcall::Errors::InvalidLanguage.new(language: language)
     end
   end
 end

data/lib/starcall/regions.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'starcall/error'
-
 module Starcall
   # This class is used to list and validate regions.
   class Regions
@@ -26,7 +24,7 @@ module Starcall
     def self.valid?(region:)
       return true if list.include? region
 
-      raise Starcall::Error::InvalidRegion.new(region: region)
+      raise Starcall::Errors::InvalidRegion.new(region: region)
     end
   end
 end

data/lib/starcall/static_data.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 require 'starcall/api_requests'
-require 'starcall/regions'
-require 'starcall/languages'
 
 module Starcall
   # This class is used for all things Static Data related.
@@ -20,29 +18,29 @@ module Starcall
     # Season ids are used in match history to indicate which season a match was played.
     # A full list of season ids can be retrieved with the below method.
     def season_ids
-      ApiRequests.make_request(url: static_url(search_term: 'seasons'))
+      Starcall::ApiRequests.make_request(url: static_url(search_term: 'seasons'))
     end
 
     # Queue ids show up in several places throughout the API and are used to indicate which kind of match was played.
     # A full list of queue ids can be can be retrieved with the below method.
     def queue_ids
-      ApiRequests.make_request(url: static_url(search_term: 'queues'))
+      Starcall::ApiRequests.make_request(url: static_url(search_term: 'queues'))
     end
 
     # Map ids are used in match history to indicate which map a match was played.
     # A full list of map ids can be can be retrieved with the below method.
     def map_ids
-      ApiRequests.make_request(url: static_url(search_term: 'maps'))
+      Starcall::ApiRequests.make_request(url: static_url(search_term: 'maps'))
     end
 
     # A full list of game modes can be can be retrieved with the below method.
     def game_modes
-      ApiRequests.make_request(url: static_url(search_term: 'gameModes'))
+      Starcall::ApiRequests.make_request(url: static_url(search_term: 'gameModes'))
     end
 
     # A full list of game types can be can be retrieved with the below method.
     def game_types
-      ApiRequests.make_request(url: static_url(search_term: 'gameTypes'))
+      Starcall::ApiRequests.make_request(url: static_url(search_term: 'gameTypes'))
     end
 
     # All valid Data Dragon versions  can be can be retrieved with the below method.
@@ -51,39 +49,39 @@ module Starcall
     # This typically occurs when there's an error in the original build.
     # As such, you should always use the most recent Data Dragon version for a given patch for the best results.
     def dd_versions
-      ApiRequests.make_request(url: dd_versions_url)
+      Starcall::ApiRequests.make_request(url: dd_versions_url)
     end
 
     # Data Dragon versions aren't always equivalent to the League of Legends client version in a region.
     def dd_region_versions
-      ApiRequests.make_request(url: dd_region_version_url)
+      Starcall::ApiRequests.make_request(url: dd_region_version_url)
     end
 
     # This returns a list of all champion with a brief summary, including stats, id and blurb.
     def dd_champions
-      ApiRequests.make_request(url: dd_url(game_component: 'champion'))
+      Starcall::ApiRequests.make_request(url: dd_url(game_component: 'champion'))
     end
 
     # For me detailed and specific information about a champion, this call can be used.
     def dd_specific_champion(champion_name:)
-      ApiRequests.make_request(url: dd_specific_champion_url(champion_name: champion_name))
+      Starcall::ApiRequests.make_request(url: dd_specific_champion_url(champion_name: champion_name))
     end
 
     # Data Dragon also provides detail for every item in the game.
     # with this method you can find info such as the item's description, purchase value, sell value,
     # items it builds from, items it builds into, and stats granted from the item.
     def dd_items
-      ApiRequests.make_request(url: dd_url(game_component: 'item'))
+      Starcall::ApiRequests.make_request(url: dd_url(game_component: 'item'))
     end
 
     # Details about summoner spells.
     def dd_summoner_spells
-      ApiRequests.make_request(url: dd_url(game_component: 'summoner'))
+      Starcall::ApiRequests.make_request(url: dd_url(game_component: 'summoner'))
     end
 
     # Details about profile icons and where they can be found on the sprite sheets.
     def dd_profile_icons
-      ApiRequests.make_request(url: dd_url(game_component: 'profileicon'))
+      Starcall::ApiRequests.make_request(url: dd_url(game_component: 'profileicon'))
     end
 
     private
@@ -107,7 +105,7 @@ module Starcall
 
     # This gets the current version of specific game components, such as champions.
     def dd_current_data_version(game_component:)
-      ApiRequests.make_request(url: dd_region_version_url)['n'][game_component]
+      Starcall::ApiRequests.make_request(url: dd_region_version_url)['n'][game_component]
     end
 
     # This builds the data dragon url for specific components such as champions,

data/lib/starcall/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Starcall
-  VERSION = '0.2.0'
+  VERSION = '0.6.0'
 end

data/starcall.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'pry', '~> 0.13'
   spec.add_development_dependency 'rake', '~> 12.3'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rubocop', '~> 0.86'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: starcall
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Kelvin Samuel
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-28 00:00:00.000000000 Z
+date: 2020-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -114,7 +128,18 @@ files:
 - Rakefile
 - lib/starcall.rb
 - lib/starcall/api_requests.rb
-- lib/starcall/error.rb
+- lib/starcall/endpoints/champion_mastery_v4.rb
+- lib/starcall/endpoints/champion_v3.rb
+- lib/starcall/endpoints/clash_v1.rb
+- lib/starcall/endpoints/endpoints.rb
+- lib/starcall/endpoints/spectator_v4.rb
+- lib/starcall/endpoints/status_v3.rb
+- lib/starcall/endpoints/summoner_v4.rb
+- lib/starcall/endpoints/third_party_code_v4.rb
+- lib/starcall/errors/errors.rb
+- lib/starcall/errors/invalid_language.rb
+- lib/starcall/errors/invalid_region.rb
+- lib/starcall/helpers/region_parser.rb
 - lib/starcall/languages.rb
 - lib/starcall/regions.rb
 - lib/starcall/static_data.rb
@@ -143,7 +168,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
 summary: A Helper Gem for calling Riots API