dotka 1.0.1 → 1.0.2

data/data/lobbies.json

@@ -0,0 +1,42 @@
+[
+    {
+        "id": "-1",
+        "name": "Invalid"
+    },
+    {
+        "id": "0",
+        "name": "Public matchmaking"
+    },
+    {
+        "id": "1",
+        "name": "Practice"
+    },
+    {
+        "id": "2",
+        "name": "Tournament"
+    },
+    {
+        "id": "3",
+        "name": "Tutorial"
+    },
+    {
+        "id": "4",
+        "name": "Co-op with bots"
+    },
+    {
+        "id": "5",
+        "name": "Team match"
+    },
+    {
+        "id": "6",
+        "name": "Solo Queue"
+    },
+    {
+        "id": "7",
+        "name": "Ranked"
+    },
+    {
+        "id": "8",
+        "name": "Solo Mid 1vs1"
+    }
+]

data/data/regions.json

@@ -0,0 +1,142 @@
+[
+    {
+        "id": "111",
+        "name": "US West"
+    },
+    {
+        "id": "112",
+        "name": "US West"
+    },
+    {
+        "id": "114",
+        "name": "US West"
+    },
+    {
+        "id": "121",
+        "name": "US East"
+    },
+    {
+        "id": "122",
+        "name": "US East"
+    },
+    {
+        "id": "123",
+        "name": "US East"
+    },
+    {
+        "id": "124",
+        "name": "US East"
+    },
+    {
+        "id": "131",
+        "name": "Europe West"
+    },
+    {
+        "id": "132",
+        "name": "Europe West"
+    },
+    {
+        "id": "133",
+        "name": "Europe West"
+    },
+    {
+        "id": "134",
+        "name": "Europe West"
+    },
+    {
+        "id": "135",
+        "name": "Europe West"
+    },
+    {
+        "id": "136",
+        "name": "Europe West"
+    },
+    {
+        "id": "142",
+        "name": "South Korea"
+    },
+    {
+        "id": "143",
+        "name": "South Korea"
+    },
+    {
+        "id": "151",
+        "name": "Southeast Asia"
+    },
+    {
+        "id": "152",
+        "name": "Southeast Asia"
+    },
+    {
+        "id": "153",
+        "name": "Southeast Asia"
+    },
+    {
+        "id": "161",
+        "name": "China"
+    },
+    {
+        "id": "163",
+        "name": "China"
+    },
+    {
+        "id": "171",
+        "name": "Australia"
+    },
+    {
+        "id": "181",
+        "name": "Russia"
+    },
+    {
+        "id": "182",
+        "name": "Russia"
+    },
+    {
+        "id": "183",
+        "name": "Russia"
+    },
+    {
+        "id": "184",
+        "name": "Russia"
+    },
+    {
+        "id": "191",
+        "name": "Europe East"
+    },
+    {
+        "id": "200",
+        "name": "South America"
+    },
+    {
+        "id": "204",
+        "name": "South America"
+    },
+    {
+        "id": "211",
+        "name": "South America"
+    },
+    {
+        "id": "212",
+        "name": "South America"
+    },
+    {
+        "id": "213",
+        "name": "South America"
+    },
+    {
+        "id": "221",
+        "name": "China"
+    },
+    {
+        "id": "222",
+        "name": "China"
+    },
+    {
+        "id": "223",
+        "name": "China"
+    },
+    {
+        "id": "231",
+        "name": "China"
+    }
+]

data/docs/todo.md

@@ -0,0 +1,70 @@
+# TODO
+
+- `match = Dotka.match(id)`:
+	- `match.id` returns an `integer`.
+	- `match.players` returns an `array` of `DotkaM::Player` instances.
+	- `match.winner` returns either `radiant` or `dire` (`string`).
+	- `match.duration` returns the match duration in seconds (`integer`).
+	- `match.start_time` returns the start time in seconds (`integer`, UTC).
+	- `match.lobby` returns an instance of `DotkaM::Lobby`.
+	- `match.game_mode` returns an instance of `DotkaM::GameMode`.
+	- `match.region` returns an instance of `DotkaM::Region`.
+	- *This method will return an instance of `DotkaM::Match`.*
+
+- `matches = Dotka.matches(conditions)` where `conditions` is an `array` with these keys:
+	- `player_name` as a `string`.
+	- `hero_id` as an `integer`.
+	- `skill_type` as an `integer`: (0, 1, 2, 3) => (Any, Normal, High, Very High).
+	- `min_date` as an `integer` (UTC).
+	- `max_date` as an `integer` (UTC).
+	- `account_id` as an `integer` (for example, `70388657`).
+	- `start_at_match_id` as an `integer`.
+	- `amount_of_matches` as an `integer`.
+	- *This method will return an `array` of `DotkaM::Match` instances.*
+
+- `player = Dotka.player(id)`:
+	- `player.account_id` returns an `integer`.
+	- `player.hero` returns an instance of `DotkaM::Hero`.
+	- `player.items` returns an `array` of `DotkaM::Item` instances.
+	- `player.kills` returns an `integer`.
+	- `player.deaths` returns an `integer`.
+	- `player.assists` returns an `integer`.
+	- `player.abandoned?` returns a `boolean`.
+	- `player.team` returns either `dire` or `radiant`.
+	- `player.gold` returns an `integer`.
+	- `player.last_hits` returns an `integer`.
+	- `player.denies` returns an `integer`.
+	- `player.gold_per_min` returns an `integer`.
+	- `player.xp_per_min` returns an `integer`.
+	- `player.hero_dmg` returns an `integer`.
+	- `player.tower_dmg` returns an `integer`.
+	- `player.hero_heal` returns an `integer`.
+	- `player.level` returns an `integer`.
+	- *This method will return an instance of `DotkaM::Player`.*
+
+- `hero = Dotka.hero(id)`:
+	- `hero.id` returns an `integer`.
+	- `hero.name` returns a `string` (internal hero name).
+	- `hero.localized_name` returns a `string` (localized hero name in English).
+	- *This method will return an instance of `DotkaM::Hero`.*
+
+- `item = Dotka.item(id)`:
+	- `item.id` returns an `integer`.
+	- `item.name` returns a `string` (internal item name).
+	- `item.localized_name` returns a `string` (localized item name in English).
+	- *This method will return an instance of `DotkaM::Item`.*
+
+- `game_mode = Dotka.game_mode(id)`:
+	- `game_mode.id` returns an `integer`.
+	- `game_mode.localized_name` returns a `string` (localized game mode name in English).
+	- *This method will return an instance of `DotkaM::GameMode`.*
+
+- `lobby = Dotka.lobby(id)`:
+	- `lobby.id` returns an `integer`.
+	- `lobby.localized_name` returns a `string` (localized lobby name in English).
+	- *This method will return an instance of `DotkaM::Lobby`.*
+
+- `region = Dotka.region(id)`:
+	- `region.id` returns an `integer`.
+	- `region.localized_name` returns a `string` (localized region name in English).
+	- *This method will return an instance of `DotkaM::Region`.*

data/dotka.gemspec

@@ -0,0 +1,12 @@
+Gem::Specification.new do |spec|
+	spec.name = 'dotka'
+	spec.version = '1.0.2'
+	spec.date = '2014-12-11'
+	spec.summary = 'Dota 2 WebAPI Wrapper'
+	spec.description = 'Makes interaction with Dota 2 WebAPI easy'
+	spec.authors = ['bound1ess']
+	spec.email = 'bound1ess.dev@gmail.com'
+	spec.files = `git ls-files`.split($/)
+	spec.license = 'MIT'
+	spec.homepage = 'https://github.com/bound1ess/dotka'
+end

data/lib/dotka/game_mode.rb

@@ -0,0 +1,12 @@
+require_relative "raw"
+
+module DotkaM
+	class GameMode < Raw
+		def id
+			@raw["id"].to_i
+		end
+		def localized_name
+			@raw["name"]
+		end
+	end
+end

data/lib/dotka/hero.rb

@@ -0,0 +1,15 @@
+require_relative "raw"
+
+module DotkaM
+	class Hero < Raw
+		def id
+			@raw["id"].to_i
+		end
+		def name
+			@raw["name"]
+		end
+		def localized_name
+			@raw["localized_name"]
+		end			
+	end
+end

data/lib/dotka/item.rb

@@ -0,0 +1,15 @@
+require_relative "raw"
+
+module DotkaM
+	class Item < Raw
+		def id
+			@raw["id"].to_i
+		end
+		def name
+			@raw["name"]
+		end
+		def localized_name
+			@raw["localized_name"]
+		end
+	end
+end

data/lib/dotka/lobby.rb

@@ -0,0 +1,12 @@
+require_relative "raw"
+
+module DotkaM
+	class Lobby < Raw
+		def id
+			@raw["id"].to_i
+		end
+		def localized_name
+			@raw["name"]
+		end
+	end
+end

data/lib/dotka/match.rb

@@ -0,0 +1,39 @@
+require_relative "raw"
+require_relative "player"
+require_relative "lobby"
+require_relative "game_mode"
+require_relative "region"
+require_relative "storage"
+
+module DotkaM
+	class Match < Raw
+		def id
+			@raw["match_id"].to_i
+		end
+		def players
+			players = Array.new
+			@raw["players"].each { |player|
+				players.push Player.new(player)
+			}
+			players
+		end
+		def winner
+			(!! @raw["radiant_win"]) ? "radiant" : "dire"
+		end
+		def duration
+			@raw["duration"].to_i
+		end
+		def start_time
+			@raw["start_time"].to_i
+		end
+		def lobby
+			Lobby.new Storage.new.get("lobbies", {"id" => @raw["lobby_type"]}) 
+		end
+		def game_mode
+			GameMode.new Storage.new.get("game_modes", {"id" => @raw["game_mode"]})
+		end
+		def region
+			Region.new Storage.new.get("regions", {"id" => @raw["cluster"]})
+		end
+	end
+end

data/lib/dotka/player.rb

@@ -0,0 +1,68 @@
+require_relative "raw"
+require_relative "storage"
+require_relative "hero"
+require_relative "item"
+
+module DotkaM
+	class Player < Raw
+		def account_id
+			@raw["account_id"].to_i
+		end
+		def hero
+			Hero.new Storage.new.get("heroes", {"id" => @raw["hero_id"]})
+		end
+		def items
+			storage = Storage.new
+			[
+				Item.new(storage.get "items", {"id" => @raw["item_0"]}),
+				Item.new(storage.get "items", {"id" => @raw["item_1"]}),
+				Item.new(storage.get "items", {"id" => @raw["item_2"]}),
+				Item.new(storage.get "items", {"id" => @raw["item_3"]}),
+				Item.new(storage.get "items", {"id" => @raw["item_4"]}),
+				Item.new(storage.get "items", {"id" => @raw["item_5"]})
+			]
+		end
+		def kills
+			@raw["kills"].to_i
+		end
+		def deaths
+			@raw["deaths"].to_i
+		end
+		def assists
+			@raw["assists"].to_i
+		end
+		def abandoned?
+			@raw["leaver_status"].to_i == 1
+		end
+		def team
+			@raw["player_slot"].to_i > 4 ? "dire" : "radiant"
+		end
+		def gold
+			@raw["gold"].to_i + @raw["gold_spent"].to_i
+		end
+		def last_hits
+			@raw["last_hits"].to_i
+		end
+		def denies
+			@raw["denies"].to_i
+		end
+		def gold_per_min
+			@raw["gold_per_min"].to_i
+		end
+		def xp_per_min
+			@raw["xp_per_min"].to_i
+		end
+		def hero_dmg
+			@raw["hero_damage"].to_i
+		end
+		def tower_dmg
+			@raw["tower_damage"].to_i
+		end
+		def hero_heal
+			@raw["hero_healing"].to_i
+		end
+		def level
+			@raw["level"].to_i
+		end
+	end
+end

data/lib/dotka/raw.rb

@@ -0,0 +1,8 @@
+module DotkaM
+	class Raw
+		attr_accessor "raw"
+		def initialize raw
+			@raw = raw
+		end
+	end
+end