dota 0.0.12 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 23fc49df23488bce2c5a7ba87cddf20ba521ef67
-  data.tar.gz: 67a569a29f97b37fbfd1b79a12c5ed14ad15e406
+  metadata.gz: adb79effd365cfddfeccab6653bc8ebeaa17b448
+  data.tar.gz: 866ea82ef3fb0f8e44e053c6bbcb4b4912d226c2
 SHA512:
-  metadata.gz: 23036186cdc6dc69a544c48d8c1470c286dc939a8b77911230d4cd683a6c9b6aff245d7fb93b8f950ae159ab7439ab2862d0bde2339a5a1e3677be933f929c80
-  data.tar.gz: c4dbd4ea60a50c1e49c1f4a6e9d5f98f41861a302780a1a0cf216090df4565a367cbcda81c8bcb8822877ea743a72d52600a8c0cfdb75b13ba2dd89773b85105
+  metadata.gz: 1628d277437c89febddd92971c60284e4617eb04eb3a9cc50f9f235fe7b5572b7ab96ff996a0c11967e91eb3888c3fc673e5b18fe9d35c07801f4d2c2fc34738
+  data.tar.gz: f0d9529ab46fa3adc765faa8df0c455857c910d3d3867c60110c5bcd11247370514d847a6d6fdad7b5d7bd0c3f4e87720c1b2994cb60acb7bb8b52107e69daf1

data/Guardfile

@@ -1,4 +1,4 @@
-guard :rspec, cmd: "bundle exec rspec" do
+guard :rspec, cmd: "bundle exec rspec --fail-fast" do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { "spec" } # or { |m| "spec/#{m[1]}_spec.rb" }
   watch("spec/spec_helper.rb")  { "spec" }

data/README.md

@@ -13,6 +13,7 @@ Currently supported endpoints:
 - [GetRarities](https://wiki.teamfortress.com/wiki/WebAPI/GetRarities)
 - [GetTeamInfoByTeamID](https://wiki.teamfortress.com/wiki/WebAPI/GetTeamInfoByTeamID)
 - [GetLiveLeagueGames](https://wiki.teamfortress.com/wiki/WebAPI/GetLiveLeagueGames)
+- [GetScheduledLeagueGames](https://wiki.teamfortress.com/wiki/WebAPI/GetScheduledLeagueGames)
 
 Unsupported endpoints can still be queried via [custom requests](#custom-requests).
 
@@ -23,7 +24,6 @@ This gem is in alpha, keep that in mind when upgrading.
 - Support for more endpoints
   - [GetMatchHistoryBySequenceNum](https://wiki.teamfortress.com/wiki/WebAPI/GetMatchHistoryBySequenceNum)
   - [GetPlayerSummaries](https://wiki.teamfortress.com/wiki/WebAPI/GetPlayerSummaries)
-  - [GetScheduledLeagueGames](https://wiki.teamfortress.com/wiki/WebAPI/GetScheduledLeagueGames)
   - [GetTournamentPlayerStats](https://wiki.teamfortress.com/wiki/WebAPI/GetTournamentPlayerStats)
   - [GetTournamentPrizePool](https://wiki.teamfortress.com/wiki/WebAPI/GetTournamentPrizePool)
 - Validations and error classes
@@ -61,42 +61,52 @@ Get your Steam API key [here](http://steamcommunity.com/dev/apikey).
 ```ruby
 api = Dota.api
 
-api.heroes(43)                 # => (Cached) A single hero - "Death Prophet"
-api.heroes                     # => (Cached) All heroes
-
-api.items(114)                 # => (Cached) A single item - "Heart of Tarrasque"
-api.items                      # => (Cached) All items
-
-api.cosmetic_rarities          # => All cosmetic rarities
-
-api.teams(1375614)             # => A single team - "Newbee"
-api.teams                      # => A list of teams
-api.teams(after: 1375614)      #    Allowed options:
-                               #
-                               #    :after - Integer, With team IDs equal or greater than this
-                               #    :limit - Integer, Amount of teams to return (default is 100)
-
-api.leagues                    # => All leagues
-
-api.matches(789645621)         # => A single match - "Newbee vs Vici Gaming"
-api.matches                    # => A list of matches
-api.matches(hero_id: 43)       #    Allowed options:
-                               #
-                               #    :hero_id     - Integer, With this hero. See Dota::API::Hero::MAPPING
-                               #    :after       - Integer, With match IDs equal or greater than this
-                               #    :player_id   - Integer, With this player (32-bit Steam ID)
-                               #    :league_id   - Integer, In this league. Use Dota.leagues to get a list of leagues
-                               #    :mode_id     - Integer, In this game mode. See Dota::API::Match::MODES
-                               #    :skill_level - Integer, In this skill level (ignored if :player_id is provided). See Dota::API::Match::SKILL_LEVELS
-                               #    :from        - Integer, Minimum timestamp
-                               #    :to          - Integer, Maximum timestamp
-                               #    :min_players - Integer, With at least this number of players
-                               #    :league_only - Boolean, Only league matches
-                               #    :limit       - Integer, Amount of matches to return (default is 100)
-
-api.live_matches               # => A list of live matches
-
-api.friends(76561198052976237) # => All friends of user
+api.heroes(43)                   # => (Cached) A single hero - "Death Prophet"
+api.heroes                       # => (Cached) All heroes
+
+api.items(114)                   # => (Cached) A single item - "Heart of Tarrasque"
+api.items                        # => (Cached) All items
+
+api.cosmetic_rarities            # => All cosmetic rarities
+
+api.teams(1375614)               # => A single team - "Newbee"
+api.teams                        # => A list of teams
+api.teams(after: 1375614)        #    Allowed options:
+                                 #
+                                 #    :after - Integer, With team IDs equal or greater than this
+                                 #    :limit - Integer, Amount of teams to return (default is 100)
+
+api.leagues                      # => All leagues
+
+api.matches(789645621)           # => A single match - "Newbee vs Vici Gaming"
+api.matches                      # => A list of matches
+api.matches(hero_id: 43)         #    Allowed options:
+                                 #
+                                 #    :hero_id     - Integer, With this hero. See Dota::API::Hero::MAPPING
+                                 #    :after       - Integer, With match IDs equal or greater than this
+                                 #    :player_id   - Integer, With this player (32-bit Steam ID)
+                                 #    :league_id   - Integer, In this league. Use Dota.leagues to get a list of leagues
+                                 #    :mode_id     - Integer, In this game mode. See Dota::API::Match::MODES
+                                 #    :skill_level - Integer, In this skill level (ignored if :player_id is provided). See Dota::API::Match::SKILL_LEVELS
+                                 #    :from        - Integer, Minimum timestamp
+                                 #    :to          - Integer, Maximum timestamp
+                                 #    :min_players - Integer, With at least this number of players
+                                 #    :league_only - Boolean, Only league matches
+                                 #    :limit       - Integer, Amount of matches to return (default is 100)
+
+api.live_matches                 # => All live league matches
+api.live_matches(league_id: 600) #    Allowed options:
+                                 #
+                                 #    :league_id - Integer, In this league. Use Dota.leagues to get a list of leagues
+                                 #    :match_id  - Integer, With this match
+
+api.scheduled_matches            # => All scheduled league matches
+api.scheduled_matches(from: 123) #    Allowed options:
+                                 #
+                                 #    :from - Integer, Minimum timestamp
+                                 #    :to   - Integer, Maximum timestamp
+
+api.friends(76561198052976237)   # => All friends of user
 ```
 
 #### Custom Requests
@@ -157,72 +167,112 @@ Caveat: Getting a list of matches via `api.matches` will call [GetMatchHistory](
 When an instance method in a `Dota::API::Match` class returns `nil`, it most likely means the endpoint called doesn't provide it yet.
 
 ```ruby
-match.id                      # Integer, ID of the match
-match.league_id               # Integer, ID of the league this match was a part of
-match.type                    # String, See Dota::API::Match::TYPES
-match.type_id                 # Integer, See Dota::API::Match::TYPES
-match.mode                    # String, See Dota::API::Match::MODES
-match.mode_id                 # Integer, See Dota::API::Match::MODES
-match.sequence                # Integer, A 'sequence number', representing the order in which matches were recorded
-match.season                  # Integer, Season the match was played in
-match.cluster                 # Integer, Server cluster the match was played on
-match.drafts                  # Array[Dota::API::Match::Draft], Picks and bans in the match, if the game mode is "Captains Mode"
-match.players                 # Array[Dota::API::Match::Player], Players in the match
-match.players_count           # Integer, Number of players in the match
-match.starts_at               # Time, When the match started
-match.first_blood             # Integer, Seconds since the match started when first blood occured
-match.duration                # Integer, Length of the match, in seconds since the match began.
-match.winner                  # Symbol, :radiant or :dire
-match.positive_votes          # Integer, Number of thumbs-up the game has received
-match.negative_votes          # Integer, Number of thumbs-down the game has received
-
-match.radiant_id              # Integer, Radiant team's ID
-match.radiant_captain_id      # Integer, Radiant captain's 32-bit Steam ID
-match.radiant_logo_id         # Integer, Radiant logo's UGC ID
-match.radiant_name            # String, Radiant team's name
-match.radiant_complete?       # Boolean, true if the Radiant team's roster is complete
-match.radiant_tower_status    # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails # Tower_Status
-match.radiant_barracks_status # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails # Barracks_Status
-
-match.dire_id                 # Integer, Dire team's ID
-match.dire_captain_id         # Integer, Dire captain's 32-bit Steam ID
-match.dire_logo_id            # Integer, Dire logo's UGC ID
-match.dire_name               # String, Dire team's name
-match.dire_complete?          # Boolean, true if the Dire team's roster is complete
-match.dire_tower_status       # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails # Tower_Status
-match.dire_barracks_status    # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails # Barracks_Status
+match.radiant        # Dota::API::Match::Side, Info about the team on the Radiant side
+match.dire           # Dota::API::Match::Side, Info about the team on the Dire side
+
+match.id             # Integer, ID of the match
+match.league_id      # Integer, ID of the league this match was a part of
+match.type           # String, See Dota::API::Match::TYPES
+match.type_id        # Integer, See Dota::API::Match::TYPES
+match.mode           # String, See Dota::API::Match::MODES
+match.mode_id        # Integer, See Dota::API::Match::MODES
+match.sequence       # Integer, A 'sequence number', representing the order in which matches were recorded
+match.season         # Integer, Season the match was played in
+match.cluster        # Integer, Server cluster the match was played on
+match.starts_at      # Time, When the match started
+match.first_blood    # Integer, Seconds since the match started when first blood occured
+match.duration       # Integer, Length of the match, in seconds since the match began
+match.winner         # Symbol, :radiant or :dire
+match.positive_votes # Integer, Number of thumbs-up the game has received
+match.negative_votes # Integer, Number of thumbs-down the game has received
+match.players_count  # Integer, Number of players in the match
+
+match.drafts         # Array[Dota::API::Match::Draft], Picks and bans in the match, if the game mode is "Captains Mode"
+
+# Dota::API::Match::Draft
+draft.order          # Integer, 1-20
+draft.pick?          # Boolean, true if the draft is a pick, and not a ban
+draft.team           # Symbol, :radiant or :dire
+draft.hero           # Dota::API::Hero, Picked or banned hero
 ```
 
-#### Players
+#### Live Matches
+
+```ruby
+live_match.radiant          # Dota::API::LiveMatch::Side, Info about the team on the Radiant side
+live_match.dire             # Dota::API::LiveMatch::Side, Info about the team on the Dire side
+
+live_match.id               # Integer, ID of the match
+live_match.lobby_id         # Integer, ID of the lobby
+live_match.spectators_count # Integer, Number of spectators watching on DotaTV
+live_match.league_id        # Integer, ID of the league
+live_match.stream_delay     # Integer, Number of seconds the stream is behind actual game time
+live_match.series_type      # Integer, Best of X series
+live_match.league_tier      # String, What tier the match's league is
+live_match.duration         # Integer, Length of the match, in seconds since the match began
+live_match.roshan_timer     # Integer, Seconds until Roshan respawns
+```
+
+#### Scheduled Matches
 
 ```ruby
-player.id           # Integer, 32-bit Steam ID
-player.hero         # Dota::API::Hero, Player's hero
-player.items        # Array[Dota::API::Item], Player's inventory (6 items)
-player.slot         # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails#Player_Slot
-player.status       # Symbol, :played, :left_safe, :abandoned, or :bot
-player.level        # Integer, The player's level at match end
-player.kills        # Integer, Number of kills attributed to this player
-player.deaths       # Integer, Times this player died during the match
-player.assists      # Integer, Number of assists the player got
-player.last_hits    # Integer, Number of last-hits the player got
-player.denies       # Integer, Number of denies the player got
-player.gold         # Integer, Amount of gold the player had remaining at the end of the match
-player.gold_spent   # Integer, Amount of gold the player spent
-player.gpm          # Integer, Player's overall gold/minute
-player.xpm          # Integer, Player's overall experience/minute
-player.hero_damage  # Integer, Amount of damage the player dealt to heroes
-player.tower_damage # Integer, Amount of damage the player dealt to towers
-player.hero_healing # Integer, Amount of health the player had healed on heroes
+scheduled_match.league_id   # Integer, ID of the league 
+scheduled_match.game_id     # Integer, ID of the game
+scheduled_match.teams       # Array[Dota::API::Team], List of teams who are playing each other
+scheduled_match.starts_at   # Time, When the match is scheduled to start
+scheduled_match.description # String, Description of the match
+scheduled_match.final?      # Boolean, true if the game is the last of the series
 ```
 
-#### Drafts
+#### Sides - Radiant/Dire
 
 ```ruby
-draft.order # Integer, 1-20
-draft.pick? # Boolean, true if the draft is a pick, and not a ban
-draft.team  # Symbol, :radiant or :dire
-draft.hero  # Dota::API::Hero, Picked or banned hero
+radiant.id          # Integer, Team's ID
+radiant.logo_id     # Integer, Team logo's UGC ID
+radiant.name        # String, Team's name
+radiant.complete?   # Boolean, true if the team's roster is complete
+radiant.players     # Array[Dota::API::Match::Player|Dota::API::LiveMatch::Player], Players in the match
+
+# Additional methods in Match::Side
+radiant.captain_id  # Integer, Team captain's 32-bit Steam ID
+
+# Additional methods in LiveMatch::Side
+radiant.score       # Integer, The team's current score
+radiant.series_wins # Integer, Number of wins in the series so far
+```
+
+#### Players
+
+```ruby
+player.id                # Integer, 32-bit Steam ID
+player.hero              # Dota::API::Hero, Player's hero
+player.items             # Array[Dota::API::Item], Player's inventory (6 items)
+player.slot              # Integer, See https://wiki.teamfortress.com/wiki/WebAPI/GetMatchDetails#Player_Slot
+player.level             # Integer, The player's level at match end
+player.kills             # Integer, Number of kills attributed to this player
+player.deaths            # Integer, Times this player died during the match
+player.assists           # Integer, Number of assists the player got
+player.last_hits         # Integer, Number of last-hits the player got
+player.denies            # Integer, Number of denies the player got
+player.gold              # Integer, Amount of gold the player had remaining at the end of the match
+player.gpm               # Integer, Player's overall gold/minute
+player.xpm               # Integer, Player's overall experience/minute
+
+# Additional methods in Match::Player
+player.status            # Symbol, :played, :left_safe, :abandoned, or :bot
+player.gold_spent        # Integer, Amount of gold the player spent
+player.hero_damage       # Integer, Amount of damage the player dealt to heroes
+player.tower_damage      # Integer, Amount of damage the player dealt to towers
+player.hero_healing      # Integer, Amount of health the player had healed on heroes
+
+# Additional methods in LiveMatch::Player
+player.name              # String, Name of the player
+player.net_worth         # Integer
+player.ultimate_state    # Integer
+player.ultimate_cooldown # Integer
+player.respawn_timer     # Integer
+player.position_x        # Float
+player.position_y        # Float
 ```
 
 #### Cosmetic Rarities
@@ -242,23 +292,6 @@ friend.relationship # String, Relation to the player
 friend.made_at      # Time, When the friend was added to the player's friend list
 ```
 
-#### Live Matches
-```ruby
-live_matches.id                   # Integer, ID of the match
-live_matches.lobby_id             # Integer, ID of the lobby
-live_matches.spectators_count     # Integer, Number of spectators watching on DotaTV
-live_matches.league_id            # Integer, ID of the league
-live_matches.stream_delay         # Integer, Number of seconds the stream is behind actual game time
-live_matches.radiant_series_wins  # Integer, Number of wins the Radiant team has in the series
-live_matches.dire_series_wins     # Integer, Number of wins the Dire team has in the series
-live_matches.radiant              # Dota::API::LiveMatch::Side, Info about the team on the Radiant side
-live_matches.dire                 # Dota::API::LiveMatch::Side, Info about the team on the Dire side
-live_matches.series_type          # Integer, Best of X series
-live_matches.league_tier          # String, What tier the match's league is
-live_matches.players              # Array[Dota::API::LiveMatch::Players], High level info about the players in the match (some redundant info in scoreboard)
-live_matches.scoreboard           # Hash, Details of the scoreboard (to be converted soon to an object and/or integrated with our players class)
-```
-
 ## Contributing
 
 1. [Fork it!](https://github.com/vinnicc/dota/fork)

data/data/heroes.yml

@@ -0,0 +1,327 @@
+1:
+  - antimage
+  - Anti-Mage
+2:
+  - axe
+  - Axe
+3:
+  - bane
+  - Bane
+4:
+  - bloodseeker
+  - Bloodseeker
+5:
+  - crystal_maiden
+  - Crystal Maiden
+6:
+  - drow_ranger
+  - Drow Ranger
+7:
+  - earthshaker
+  - Earthshaker
+8:
+  - juggernaut
+  - Juggernaut
+9:
+  - mirana
+  - Mirana
+10:
+  - morphling
+  - Morphling
+11:
+  - nevermore
+  - Shadow Fiend
+12:
+  - phantom_lancer
+  - Phantom Lancer
+13:
+  - puck
+  - Puck
+14:
+  - pudge
+  - Pudge
+15:
+  - razor
+  - Razor
+16:
+  - sand_king
+  - Sand King
+17:
+  - storm_spirit
+  - Storm Spirit
+18:
+  - sven
+  - Sven
+19:
+  - tiny
+  - Tiny
+20:
+  - vengefulspirit
+  - Vengeful Spirit
+21:
+  - windrunner
+  - Windranger
+22:
+  - zuus
+  - Zeus
+23:
+  - kunkka
+  - Kunkka
+25:
+  - lina
+  - Lina
+26:
+  - lion
+  - Lion
+27:
+  - shadow_shaman
+  - Shadow Shaman
+28:
+  - slardar
+  - Slardar
+29:
+  - tidehunter
+  - Tidehunter
+30:
+  - witch_doctor
+  - Witch Doctor
+31:
+  - lich
+  - Lich
+32:
+  - riki
+  - Riki
+33:
+  - enigma
+  - Enigma
+34:
+  - tinker
+  - Tinker
+35:
+  - sniper
+  - Sniper
+36:
+  - necrolyte
+  - Necrophos
+37:
+  - warlock
+  - Warlock
+38:
+  - beastmaster
+  - Beastmaster
+39:
+  - queenofpain
+  - Queen of Pain
+40:
+  - venomancer
+  - Venomancer
+41:
+  - faceless_void
+  - Faceless Void
+42:
+  - skeleton_king
+  - Wraith King
+43:
+  - death_prophet
+  - Death Prophet
+44:
+  - phantom_assassin
+  - Phantom Assassin
+45:
+  - pugna
+  - Pugna
+46:
+  - templar_assassin
+  - Templar Assassin
+47:
+  - viper
+  - Viper
+48:
+  - luna
+  - Luna
+49:
+  - dragon_knight
+  - Dragon Knight
+50:
+  - dazzle
+  - Dazzle
+51:
+  - rattletrap
+  - Clockwerk
+52:
+  - leshrac
+  - Leshrac
+53:
+  - furion
+  - Nature's Prophet
+54:
+  - life_stealer
+  - Lifestealer
+55:
+  - dark_seer
+  - Dark Seer
+56:
+  - clinkz
+  - Clinkz
+57:
+  - omniknight
+  - Omniknight
+58:
+  - enchantress
+  - Enchantress
+59:
+  - huskar
+  - Huskar
+60:
+  - night_stalker
+  - Night Stalker
+61:
+  - broodmother
+  - Broodmother
+62:
+  - bounty_hunter
+  - Bounty Hunter
+63:
+  - weaver
+  - Weaver
+64:
+  - jakiro
+  - Jakiro
+65:
+  - batrider
+  - Batrider
+66:
+  - chen
+  - Chen
+67:
+  - spectre
+  - Spectre
+68:
+  - ancient_apparition
+  - Ancient Apparition
+69:
+  - doom_bringer
+  - Doom
+70:
+  - ursa
+  - Ursa
+71:
+  - spirit_breaker
+  - Spirit Breaker
+72:
+  - gyrocopter
+  - Gyrocopter
+73:
+  - alchemist
+  - Alchemist
+74:
+  - invoker
+  - Invoker
+75:
+  - silencer
+  - Silencer
+76:
+  - obsidian_destroyer
+  - Outworld Devourer
+77:
+  - lycan
+  - Lycan
+78:
+  - brewmaster
+  - Brewmaster
+79:
+  - shadow_demon
+  - Shadow Demon
+80:
+  - lone_druid
+  - Lone Druid
+81:
+  - chaos_knight
+  - Chaos Knight
+82:
+  - meepo
+  - Meepo
+83:
+  - treant
+  - Treant Protector
+84:
+  - ogre_magi
+  - Ogre Magi
+85:
+  - undying
+  - Undying
+86:
+  - rubick
+  - Rubick
+87:
+  - disruptor
+  - Disruptor
+88:
+  - nyx_assassin
+  - Nyx Assassin
+89:
+  - naga_siren
+  - Naga Siren
+90:
+  - keeper_of_the_light
+  - Keeper of the Light
+91:
+  - wisp
+  - Io
+92:
+  - visage
+  - Visage
+93:
+  - slark
+  - Slark
+94:
+  - medusa
+  - Medusa
+95:
+  - troll_warlord
+  - Troll Warlord
+96:
+  - centaur
+  - Centaur Warrunner
+97:
+  - magnataur
+  - Magnus
+98:
+  - shredder
+  - Timbersaw
+99:
+  - bristleback
+  - Bristleback
+100:
+  - tusk
+  - Tusk
+101:
+  - skywrath_mage
+  - Skywrath Mage
+102:
+  - abaddon
+  - Abaddon
+103:
+  - elder_titan
+  - Elder Titan
+104:
+  - legion_commander
+  - Legion Commander
+105:
+  - techies
+  - Techies
+106:
+  - ember_spirit
+  - Ember Spirit
+107:
+  - earth_spirit
+  - Earth Spirit
+109:
+  - terrorblade
+  - Terrorblade
+110:
+  - phoenix
+  - Phoenix
+111:
+  - oracle
+  - Oracle