rubg 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74e11b6f6090d28926b01b5370636d1974d96e3a8379371d7bdd3c6f0ab5adca
-  data.tar.gz: e5aee919fce9263f75d3fb5a8f18f98447787afabe1748eba55768cdf5628452
+  metadata.gz: a33d6af11b8d67d5a080754976bd05ff8ba813f38efb6db9a3381c92036bd930
+  data.tar.gz: d239858728b124cddd09b0a00457d84867b9fb243733243c531ddab3160c8948
 SHA512:
-  metadata.gz: 0717ccdf1144e4cc74b764906ef08cf4a71e5031cc0523bf8e0cc9da7875ff7eb0cbd3635cad6557dc6269c5b512645ae10993e0efcd0a007a2660e36328c112
-  data.tar.gz: 10dcfbaa0242892d7c543cd73ab0ceebfb459b897dce7a4096f7bec2dc5a8af964d2b703afb3bb249eaa562ccbf65504bc0c4c2ab15339b9f2af595d2fe77d3c
+  metadata.gz: 5631d4b842b7f788bddaeb5b80861b84049ca08041f97d17205855264fdc2106244a508a87ba9062a63b586b3c552726f28ba7d9a73d27f3bea002b812a3f87b
+  data.tar.gz: 749388d9a14e2caadf1669a263d5ae2e64c7152146b5c469e27a1ea5a889ce1dc36cf02db0c281012dde0364bbece6732077cfd562a497f5cb46acd09a0cc340

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rubg (0.1.4)
+    rubg (0.2.0)
       httparty (~> 0.16.2)
       json
 

data/README.md

@@ -4,23 +4,28 @@ RUBG is an unofficial Ruby PUBG API wrapper.
 
 It is also a side project I am using to build my own Ruby skills. As such, updates may be slow and this gem may not remain up to date with API changes. Please feel free to leave enhancement requests as issues, I may use that to help prioritize. 
 
+
+
 ## Status
 
 Development is very much in-progress. Note that breaking changes with new releases will be semi-frequent until initial development is complete (~1.0.0).
 
 #### Working:
 - The /status endpoint is fully functional.
-- The /players endpoint is mostly functional. Queries may be performed, and player objects returned. Match data is ID strings only.
+- The /players endpoint is mostly functional. Queries may be performed, and player objects returned.
+- The /matches endpoint is fully funtional. Match, roster, and participant data and stats are available with getter methods.
 
 #### To-do
-1. Finish /players endpoint, allowing conversion of matches to Match objects in response
-2. Add /matches endpoint to retrieve a single match, including objects for Rosters, etc.
+1. cross-object lookup convenience methods (ie. player.matches.fetch_latest or similar)
+2. gzip support
 3. Telemetry
 
 At some point in there I need to get testing coverage up to date.
 
 *Note: xbox shards may not work correctly - only pc is currently tested. If you encounter issues pulling data from Xbox shards please log an issue and I will address.*
 
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -37,9 +42,14 @@ Or install it yourself as:
 
     $ gem install rubg
 
+
+
 ## Usage
 
-Most methods take a hash as argument.
+### API Lookups
+
+Most lookup methods take a hash as argument.
+
 
 #### Create a Client
 First, create a client and provide your API key:
@@ -49,6 +59,13 @@ client = RUBG::Client.new({:api_key =>"your-api-key-here"})
     
 The client object is used to make requests. If no key is added the gem will try and find it at ENV['PUBG_API_KEY'].
 
+The response will contain either a top level object called 'errors' if unsuccessful.
+
+```ruby
+response.errors      # [{"title"=>"Not Found", "detail"=>"No players found matching criteria"}]
+```
+
+
 #### /status Endpoint
 
 Check the PUBG API status and version:
@@ -59,49 +76,221 @@ client.status.version        # "v8.1.2"
 client.status.released_at    # "2018-04-01T18:00:20Z"
 ```
 
+
 #### /players Endpoint
-/players is now mostly functional. Queries may be performed, and player objects returned. Match data is ID strings only, which you can use to look up manually until I implement /matches.
 
 .players takes two arguments: :shard and :query_params 
 
 :shard
 - Specify the [shard](https://documentation.playbattlegrounds.com/en/making-requests.html#regions) to retreieve data from. If none is specified, "pc-na" will be used as default.
 
-"query_params" - a hash containing any query options. For .players, the hash should contain *one* of the following options:
-- "player_names" - Comma-separated list of players to search for. Names are case-sensitive.
-- "player_ids" - Comma-separated list of player IDs to search for.
+:query_params - a hash containing any query options. For .players, the hash should contain *one* of the following options:
+- :player_names - Comma-separated list of players to search for. Names are case-sensitive.
+- :player_ids - Comma-separated list of player IDs to search for.
 
-Note: If neither player_ids nor player_names are included in query_params no results will be returned - at least one name or Id must be present.
+Note: If neither player_ids nor player_names are included in query_params no results will be returned - at least one name or Id must be present. The maximum in one request is currently 6.
 
 ```ruby
 args = {:shard => "pc-na", :query_params => {:player_names => "shroud,JoshOG,PlayerUnknown"}}
-players = client.players(args)
+response = client.players(args)
+response.players     # collection of player objects
+
+response.response_ts            # Time object containing date/time of response
+response.ratelimit              # Returns the max rate limit/min for your API key.
+response.ratelimit_remaining    # Returns the number of requests your API key has remaining before hitting the ratelimit.
+```
+
+
+#### /players/{:id} Endpoint
+
+.player is similar to .players, but looks up only a single player by player_id only.
+
+:shard
+- Specify the [shard](https://documentation.playbattlegrounds.com/en/making-requests.html#regions) to retreieve data from. If none is specified, "pc-na" will be used as default.
+
+:query_params - a hash containing any query options. For .player, the hash must contain:
+- :player_id - Player ID to search for.
+
+```ruby
+args = {:shard => "pc-na", :query_params => {:player_id => "shroud"}}
+response = client.player(args)
+
+response.response_ts            # Time object containing date/time of response
+response.ratelimit              # Returns the max rate limit/min for your API key.
+response.ratelimit_remaining    # Returns the number of requests your API key has remaining before hitting the ratelimit.
+```
+
+
+#### /matches/{:id} Endpoint
+
+.match looks up a single match by match_id only.
+
+:shard
+- Specify the [shard](https://documentation.playbattlegrounds.com/en/making-requests.html#regions) to retreieve data from. If none is specified, "pc-na" will be used as default.
+
+:query_params - a hash containing any query options. For .match, the hash must contain:
+- :match_id - Player ID to search for.
+
+```ruby
+args = {:shard => "pc-na", :query_params => {:match_id => "match-id-here"}}
+response = client.match(args)
+
+response.response_ts            # Time object containing date/time of response
+response.ratelimit              # Returns the max rate limit/min for your API key.
+response.ratelimit_remaining    # Returns the number of requests your API key has remaining before hitting the ratelimit.
+
 ```
 
-The response will contain a top level object called 'errors' or 'data' and 'players', depending on if the query failed or succeeded.
+
+
+### RUBG Objects
+
+#### RUBG::Player
+
+Retrieved from .players or .player.
 
 ```ruby
-players.errors .               # [{"title"=>"Not Found", "detail"=>"No players found matching criteria"}]
+player.first.name        #"shroud"
+player.first.player_id   #"account.d50fdc18fcad49c691d38466bed6f8fd"
+player.first.match_ids   # returns array of all match IDs for the player in the last 14 days
+player.shard             # Shard the player was retrieved from
+player.stats             # Not currently in use
 ```
 
+
+#### RUBG::Match
+
+Retrieved from .match.
+
 ```ruby
-players.data                      # Returns retrieved player data.
+match.match_id                      # Unique match ID
+match.created                       # Match creation time
+match.duration                      # Match duration in seconds
+match.mode                          # Match gamemode ("squad-fpp", "tequilafpp")
+match.map                           # Miramar or Erangel
+match.shard                         # Shard the match was played on
+match.stats                         # Not currently in use
+match.telemetry_id                  # ID for match telemetry file
+match.telemetry_link                # Link to match telemetry file
+
+match.participants                  # Collection of RUBG::Participant objects for all participants in the match.
+match.rosters                       # Collection of RUBG::Response objects for all rosters in the match.
+match.winners                       # Retrieves the RUBG::Roster object for the winning team.
+
+match.player_count                  # Count of players in the match.
+match.roster_count                  # Count of teams in the match.
+match.names                         # List of names for all players in the match.
+match.survived                      # Collection of RUBG::Participant objects for players alive at the end.
+match.dbnos                         # Total non-lethal knockdowns. (down but not outs)
+match.assists                       # Total assists.
+match.boosts                        # Total boosts used.
+match.damage_dealt                  # Total damage dealt.
+match.damage_dealt_avg              # Avg damage dealt per player.
+match.headshot_kills                # Total headshot kills.
+match.heals                         # Total heals used.
+match.kills                         # Total kills by players.
+match.ride_distance_avg             # Avg distance traveled in vehicle per player.
+match.revives                       # Total revives from downed state.
+match.road_kills                    # Total road kills.
+match.team_kills                    # Total team kills.
+match.time_survived_avg             # Avg time survived per player in seconds.
+match.vehicle_destroys              # Total vehicle destroys.
+match.walk_distance_avg             # Avg walk distance per player.
+match.weapons_acquired              # Total weapons acquired. Always 0 at present.
+```
+
 
-players.players.first.name        #"shroud"
-players.players.first.name        #"account.d50fdc18fcad49c691d38466bed6f8fd"
-players.players.first.match_ids   #returns array of all match IDs for the player
+#### RUBG::Roster
 
-players.response_ts            # Time object containing date/time of response
-players.ratelimit              # Returns the max rate limit/min for your API key.
-players.ratelimit_remaining    # Returns the number of requests your API key has remaining before hitting the ratelimit.
+Retrieved from .match and available in .rosters method. Not available as an independent resource.
+
+```ruby
+match.rosters[0].roster_id                     # Unique roster ID
+match.rosters[0].shard                         # Shard the match was played on
+match.rosters[0].team_id                       # Randomly assigned integer identifying the roster during the match.
+match.rosters[0].rank                          # Roster placement at end of match.
+match.rosters[0].won                           # true/false
+match.rosters[0].size                          # Count of participants in roster.
+
+match.rosters[0].participants                  # Collection of RUBG::Participant objects for roster members.
+
+match.rosters[0].names                         # List of names for all players on the roster.
+match.rosters[0].survived                      # Collection of RUBG::Participant objects roster members alive at the end.
+match.rosters[0].downed                        # Times roster members downed.
+match.rosters[0].assists                       # Total assists by roster.
+match.rosters[0].boosts                        # Total boosts used by roster.
+match.rosters[0].damage_dealt                  # Total damage dealt by roster.
+match.rosters[0].damage_dealt_avg              # Avg damage dealt per player.
+match.rosters[0].headshot_kills                # Total headshot kills by roster.
+match.rosters[0].heals                         # Total heals used by roster.
+match.rosters[0].kills                         # Total kills by roster.
+match.rosters[0].ride_distance                 # Total distance traveled in vehicle by roster.
+match.rosters[0].ride_distance_avg             # Avg distance traveled in vehicle per player.
+match.rosters[0].revives                       # Total teammate revives from downed state by roster.
+match.rosters[0].road_kills                    # Total road kills by roster.
+match.rosters[0].team_kills                    # Total team kills by roster.
+match.rosters[0].time_survived                 # Total time survived by roster in seconds.
+match.rosters[0].time_survived_avg             # Avg time survived per player in seconds.
+match.rosters[0].vehicle_destroys              # Total vehicle destroys by roster.
+match.rosters[0].walk_distance                 # Total walk distance by roster.
+match.rosters[0].walk_distance_avg             # Avg walk distance by roster per player.
+match.rosters[0].weapons_acquired              # Total weapons acquired by roster. Always 0 at present.
+```
+
+
+#### RUBG::Participant
+
+Retrieved from .match and available in .participants or .rosters[].participants methods. Not available as an independent resource. Match-specific stats for a player.
+
+```ruby
+match.participants[0].participant_id                # Unique participant ID
+match.participants[0].shard                         # Shard the match was played on
+
+match.participants[0].downed                        # Times participant downed.
+match.participants[0].assists                       # Total assists by participant.
+match.participants[0].boosts                        # Total boosts used by participant.
+match.participants[0].damage_dealt                  # Total damage dealt by participant.
+match.participants[0].damage_dealt                  # Total damage dealt by participant.
+match.participants[0].headshot_kills                # Total headshot kills by participant.
+match.participants[0].heals                         # Total heals used by participant.
+match.participants[0].kill_placement                # Kill placement vs other platers.
+match.participants[0].kill_streaks                  # Total kill streaks by participant.
+match.participants[0].kills                         # Total kills by participant.
+match.participants[0].longest_kill                  # Distance of longest kill by player.
+match.participants[0].most damage                   # Always seems to be 0, unknown.
+match.participants[0].name                          # Participant name.
+match.participants[0].player_id                     # Unique player ID for participant.
+match.participants[0].revives                       # Total teammate revives from downed state by participant.
+match.participants[0].ride_distance                 # Total distance traveled in vehicle by roster.
+match.participants[0].road_kills                    # Total road kills by roster.
+match.participants[0].team_kills                    # Total team kills by roster.
+match.participants[0].time_survived                 # Total time survived by roster in seconds.
+match.participants[0].vehicle_destroys              # Total vehicle destroys by roster.
+match.participants[0].walk_distance                 # Total walk distance by roster.
+match.participants[0].weapons_acquired              # Total weapons acquired by roster. Always 0 at present.
+
+match.participants[0].kill_ranking_before...........# Kill ranking before match.
+match.participants[0].kill_ranking_gained...........# Kill ranking gain or loss.
+match.participants[0].win_ranking_before........... # Win ranking before match.
+match.participants[0].win_ranking_gained........... # Win ranking gain or loss.
+match.participants[0].overall_ranking_gained........# Overall ranking gained.
 
 ```
 
+
+
+## Resources
+[Offical PUBG API Documentation](https://documentation.playbattlegrounds.com/en/introduction.html)
+
+[Official PUBG API Discord](https://discord.gg/FcsT7t3)
+
+[Unofficial PUBG Developer Wiki](http://www.pubgwiki.org/Main_Page)
+
+
 ## Contributing
 
 Bug reports are welcome on GitHub at https://github.com/dor-edras/rubg. Given that I am using this as a teaching tool for myself I will not be accepting contributions for the time being - this may change in future. That said, feel free to fork the repository and update it yourself as you'd like.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/rubg.rb

@@ -1,10 +1,13 @@
 require "rubg/version"
 require "rubg/client"
 require "rubg/rubg_endpoint"
-require "rubg/match"
-require "rubg/matches"
 require "rubg/player"
-require "rubg/players"
+require "rubg/player_collection"
+require "rubg/match"
+require "rubg/match_collection"
+require "rubg/roster"
+require "rubg/participant"
+require "rubg/telemetry"
 require "rubg/status"
 
 

data/lib/rubg/client.rb

@@ -22,7 +22,7 @@ module RUBG
 
     def players( args )
       args = {:client => self }.merge(args)
-      RUBG::Players.fetch( args )
+      RUBG::PlayerCollection.fetch( args )
     end
 
   
@@ -37,8 +37,9 @@ module RUBG
     end
 
 
-    def match
-
+    def match ( args )
+      args = {:client => self }.merge(args)
+      RUBG::Match.fetch( args )
     end
 
 

data/lib/rubg/match.rb

@@ -1,5 +1,164 @@
-module RUBG
-  class Match
+module RUBG 
+  class Match < RubgEndpoint
+    attr_reader :match_id, :created, :duration, :mode, :map, :patch_version, :shard, :stats,
+      :tags, :title_id, :telemetry_id, :rounds, :spectators, :link, :telemetry_link,
+      :player_count, :roster_count, :winners, :names, :survived, :dbnos, 
+      :assists, :boosts, :damage_dealt, :damage_dealt_avg, :death_types, :headshot_kills,
+    :heals, :kills, :ride_distance_avg, :revives, :road_kills, :team_kills, 
+    :time_survived_avg, :vehicle_destroys, :walk_distance_avg, :weapons_acquired
+
+    attr_accessor   :rosters, :participants
+    alias_method    :winner,  :winners
+
+    def initialize( args )
+      args                  = self.class.defaults.merge(args)
+      super({
+        :response => args[:response]
+        })
+      if args[:response]["data"]
+        @match_id         = args[:match_data]["id"]
+        @created          = args[:match_data]["attributes"]["createdAt"]
+        @duration         = args[:match_data]["attributes"]["duration"]
+        @mode             = args[:match_data]["attributes"]["gameMode"]
+        @map              = convert_map_name(args[:match_data]["attributes"]["mapName"])
+        @patch_version    = args[:match_data]["attributes"]["patchVersion"]
+        @shard            = args[:match_data]["attributes"]["shardId"]
+        @stats            = args[:match_data]["attributes"]["stats"]
+        @tags             = args[:match_data]["attributes"]["tags"]
+        @title_id         = args[:match_data]["attributes"]["titleId"]
+        @telemetry_id     = args[:match_data]["relationships"]["assets"]["data"][0]["id"]
+        @rounds           = args[:match_data]["relationships"]["rounds"]["data"]
+        @spectators       = args[:match_data]["relationships"]["spectators"]["data"]
+        @link             = args[:match_data]["links"]["self"]
+        @telemetry_link   = args[:match_included].detect {|i| i["type"] == "asset" }["attributes"]["URL"]
+        
+        @rosters          = []
+        @participants     = []
+        generate_roster_objects(args[:match_included])
+        
+
+        @player_count     = @participants.count
+        @roster_count     = @rosters.count
+        @winners          = @rosters.detect {|r| r.won}
+
+
+        #aggregates
+        @names              = @participants.collect(&:name).sort!
+        @survived           = @participants.select {|m| m.death_type == "alive"}
+        @dbnos              = @participants.sum {|m| m.dbnos}
+        @assists            = @participants.sum {|m| m.assists}
+        @boosts             = @participants.sum {|m| m.boosts}
+        @damage_dealt       = @participants.sum {|m| m.damage_dealt}
+        @damage_dealt_avg   = ((participants.sum {|m| m.damage_dealt}).to_f/self.player_count.to_f).to_i
+        @headshot_kills     = @participants.sum {|m| m.headshot_kills}
+        @heals              = @participants.sum {|m| m.heals}
+        @kills              = @participants.sum {|m| m.kills}
+        @ride_distance_avg  = ((participants.sum {|m| m.ride_distance}).to_f/self.player_count.to_f).to_i
+        @revives            = @participants.sum {|m| m.revives}
+        @road_kills         = @participants.sum {|m| m.road_kills}
+        @team_kills         = @participants.sum {|m| m.team_kills}
+        @time_survived_avg  = ((participants.sum {|m| m.time_survived}).to_f/self.player_count.to_f).to_i
+        @vehicle_destroys   = @participants.sum {|m| m.vehicle_destroys}
+        @walk_distance_avg  = ((participants.sum {|m| m.walk_distance}).to_f/self.player_count.to_f).to_i
+        @weapons_acquired   = @participants.sum {|m| m.weapons_acquired}
+      end
+    end
+
+
+    def self.fetch( args )
+      args                  = self.defaults.merge(args)
+
+      endpoint = "match"
+      
+      match_id = args[:query_params][:match_id]
+      args[:query_params].delete(:match_id)
+
+      super({
+        :client         => args[:client],
+        :endpoint       => endpoint,
+        :lookup_id      => match_id,
+        :shard          => args[:shard],
+        :query_params   => args[:query_params]
+        })
+      
+      match_data      = @response["data"]
+      match_included  = @response["included"] 
+      
+      RUBG::Match.new({
+        :client         => args[:client],
+        :response       => @response,
+        :match_data     => match_data,
+        :match_included => match_included
+        })
+    end
+
+
+    private
+
+      def self.defaults
+        super
+      end
+
+      def convert_map_name (map_name)
+        if map_name == "Desert_Main"
+          "Miramar"
+        elsif map_name == "Erangel_Main"
+          "Erangel"
+        else
+          map_name
+        end
+      end
+
+
+      def participant_id_array(data)
+        participant_ids = []
+        data.map do |pt|
+          id = pt["id"]
+          participant_ids << id
+        end
+        return participant_ids
+      end
+
+
+      def generate_roster_objects (i)
+        rosters          = i.select {|i| i["type"] == "roster"}
+        participants     = i.select {|i| i["type"] == "participant"}
+        
+        rosters.map do |roster|
+          roster_participants = find_roster_participants({
+            :roster       => roster,
+            :participants => participants
+            })
+
+
+          roster_object = RUBG::Roster.new({
+            :roster_hash        => roster,
+            :participant_array  => roster_participants
+            })
+          @rosters << roster_object
+          @participants += roster_object.participants
+        end
+
+        @rosters.sort_by! {|r| r.rank}
+        @participants.sort_by! {|pt| pt.kill_place}
+
+        return @rosters, @participants
+      end
+
+
+      def find_roster_participants( args )
+        ids = participant_id_array(args[:roster]["relationships"]["participants"]["data"])
+
+        roster_participants = []
+
+        ids.map do |id|
+
+          participant_object = args[:participants].detect {|pt| pt["id"] == id}
+          roster_participants << participant_object
+        end
+
+        return roster_participants
+      end
 
   end
-end
+end

data/lib/rubg/match_collection.rb

@@ -0,0 +1,5 @@
+module RUBG
+  class MatchCollection
+    
+  end
+end

data/lib/rubg/participant.rb

@@ -0,0 +1,59 @@
+module RUBG 
+  class Participant
+    attr_reader :participant_id, :actor, :shard, :dbnos, :assists, :boosts, :damage_dealt, 
+    :death_type, :headshot_kills, :heals, :kill_place, :kill_ranking_before, :kill_ranking_gained, 
+    :kill_streaks, :kills, :last_kill_points, :last_win_points, :longest_kill, :most_damage, 
+    :name, :player_id, :revives, :ride_distance, :road_kills, :team_kills, :time_survived, 
+    :vehicle_destroys, :walk_distance, :weapons_acquired, :win_place, :win_ranking_before,  
+    :win_ranking_gained, :overall_ranking_gained, :stats
+
+    alias_method :downed, :dbnos
+
+    def initialize( args )
+
+      if args[:participant_hash]
+        @participant_id          = args[:participant_hash]["id"]
+        @actor                   = args[:participant_hash]["attributes"]["actor"]
+        @shard                   = args[:participant_hash]["attributes"]["shardId"]
+        @dbnos                   = args[:participant_hash]["attributes"]["stats"]["DBNOs"]
+        @assists                 = args[:participant_hash]["attributes"]["stats"]["assists"]
+        @boosts                  = args[:participant_hash]["attributes"]["stats"]["boosts"]
+        @damage_dealt            = args[:participant_hash]["attributes"]["stats"]["damageDealt"]
+        @death_type              = args[:participant_hash]["attributes"]["stats"]["deathType"]
+        @headshot_kills          = args[:participant_hash]["attributes"]["stats"]["headshotKills"]
+        @heals                   = args[:participant_hash]["attributes"]["stats"]["heals"]
+        @kill_place              = args[:participant_hash]["attributes"]["stats"]["killPlace"]
+        @kill_ranking_before     = args[:participant_hash]["attributes"]["stats"]["killPoints"]
+        @kill_ranking_gained     = args[:participant_hash]["attributes"]["stats"]["killPointsDelta"].to_i
+        @kill_streaks            = args[:participant_hash]["attributes"]["stats"]["killStreaks"]
+        @kills                   = args[:participant_hash]["attributes"]["stats"]["kills"]
+        @last_kill_points        = args[:participant_hash]["attributes"]["stats"]["lastKillPoints"]
+        @last_win_points         = args[:participant_hash]["attributes"]["stats"]["lastWinPoints"]
+        @longest_kill            = args[:participant_hash]["attributes"]["stats"]["longestKill"]
+        @most_damage             = args[:participant_hash]["attributes"]["stats"]["mostDamage"]
+        @name                    = args[:participant_hash]["attributes"]["stats"]["name"]
+        @player_id               = args[:participant_hash]["attributes"]["stats"]["playerId"]
+        @revives                 = args[:participant_hash]["attributes"]["stats"]["revives"]
+        @ride_distance           = args[:participant_hash]["attributes"]["stats"]["rideDistance"]
+        @road_kills              = args[:participant_hash]["attributes"]["stats"]["roadKills"]
+        @team_kills              = args[:participant_hash]["attributes"]["stats"]["teamKills"]
+        @time_survived           = args[:participant_hash]["attributes"]["stats"]["timeSurvived"]
+        @vehicle_destroys        = args[:participant_hash]["attributes"]["stats"]["vehicleDestroys"]
+        @walk_distance           = args[:participant_hash]["attributes"]["stats"]["walkDistance"]
+        @weapons_acquired        = args[:participant_hash]["attributes"]["stats"]["weaponsAcquired"]
+        @win_place               = args[:participant_hash]["attributes"]["stats"]["winPlace"]
+        @win_ranking_before      = args[:participant_hash]["attributes"]["stats"]["winPoints"]
+        @win_ranking_gained      = args[:participant_hash]["attributes"]["stats"]["winPointsDelta"].to_i
+        @overall_ranking_gained  = ( 
+          args[:participant_hash]["attributes"]["stats"]["winPointsDelta"] + 
+          ( args[:participant_hash]["attributes"]["stats"]["killPointsDelta"] * 0.2)
+          ).to_i
+        @stats                   = args[:participant_hash]["attributes"]["stats"]
+
+      end
+    end
+
+    private
+
+  end
+end

data/lib/rubg/player.rb

@@ -16,7 +16,7 @@ module RUBG
         @created        = args[:player_data]["attributes"]["createdAt"]
         @updated        = args[:player_data]["attributes"]["updatedAt"]
         @patch_version  = args[:player_data]["attributes"]["patchVersion"]
-        @shard_id       = args[:player_data]["attributes"]["shardId"]
+        @shard          = args[:player_data]["attributes"]["shardId"]
         @stats          = args[:player_data]["attributes"]["stats"]
         @title_id       = args[:player_data]["attributes"]["titleId"]
         @assets         = args[:player_data]["relationships"]["assets"]["data"]
@@ -29,7 +29,7 @@ module RUBG
 
     def self.fetch( args )
       args                  = self.defaults.merge(args)
-      STDERR.puts args.inspect
+
       endpoint = "player"
       
       player_id = args[:query_params][:player_id]

data/lib/rubg/{players.rb → player_collection.rb}

@@ -1,5 +1,5 @@
 module RUBG 
-  class Players < RubgEndpoint
+  class PlayerCollection < RubgEndpoint
     attr_reader :players
 
     def initialize( args )
@@ -37,7 +37,7 @@ module RUBG
         :query_params  => args[:query_params]
         })
 
-      RUBG::Players.new({
+      RUBG::PlayerCollection.new({
         :client   => args[:client],
         :response => @response
         })

data/lib/rubg/roster.rb

@@ -0,0 +1,84 @@
+module RUBG 
+  class Roster
+    attr_reader :roster_id, :shard, :team_id, :team, :rank, :won, :participant_ids, :size,
+    :names, :survived, :dbnos, :assists, :boosts, :damage_dealt, :damage_dealt_avg, :death_types, :headshot_kills,
+    :heals, :kills, :ride_distance, :ride_distance_avg, :revives, :road_kills, :team_kills, :time_survived, 
+    :time_survived_avg, :vehicle_destroys, :walk_distance, :walk_distance_avg, :weapons_acquired
+
+    attr_accessor :participants
+    alias_method :player_count, :size
+    alias_method :downed, :dbnos
+
+    def initialize( args )
+
+      if args[:roster_hash]
+        @roster_id        = args[:roster_hash]["id"]
+        @shard            = args[:roster_hash]["attributes"]["shardId"]
+        @team_id          = args[:roster_hash]["attributes"]["stats"]["teamId"]
+        @team             = args[:roster_hash]["relationships"]["team"]["data"]
+        @rank             = args[:roster_hash]["attributes"]["stats"]["rank"]
+        @won              = args[:roster_hash]["attributes"]["won"] == "true" ? true : false
+        @participants     = []
+        generate_participant_objects(args[:participant_array])
+        @size             = @participants.count
+
+        #aggregate roster stats
+        @names              = @participants.collect(&:name)
+        @survived           = @participants.select {|m| m.death_type == "alive"}
+        @dbnos              = @participants.sum {|m| m.dbnos}
+        @assists            = @participants.sum {|m| m.assists}
+        @boosts             = @participants.sum {|m| m.boosts}
+        @damage_dealt       = @participants.sum {|m| m.damage_dealt}
+        @damage_dealt_avg   = ((participants.sum {|m| m.damage_dealt}).to_f/self.size.to_f).to_i
+        @death_types        = @participants.collect(&:death_type)
+        @headshot_kills     = @participants.sum {|m| m.headshot_kills}
+        @heals              = @participants.sum {|m| m.heals}
+        @kills              = @participants.sum {|m| m.kills}
+        @ride_distance      = @participants.sum {|m| m.ride_distance}
+        @ride_distance_avg  = ((participants.sum {|m| m.ride_distance}).to_f/self.size.to_f).to_i
+        @revives            = @participants.sum {|m| m.revives}
+        @road_kills         = @participants.sum {|m| m.road_kills}
+        @team_kills         = @participants.sum {|m| m.team_kills}
+        @time_survived      = @participants.sum {|m| m.time_survived}
+        @time_survived_avg  = ((participants.sum {|m| m.time_survived}).to_f/self.size.to_f).to_i
+        @vehicle_destroys   = @participants.sum {|m| m.vehicle_destroys}
+        @walk_distance      = @participants.sum {|m| m.walk_distance}
+        @walk_distance_avg  = ((participants.sum {|m| m.walk_distance}).to_f/self.size.to_f).to_i
+        @weapons_acquired   = @participants.sum {|m| m.weapons_acquired}
+      end
+    end
+
+
+    def won?
+      @won
+    end
+
+    private
+
+      def participant_id_array(data)
+        participant_ids = []
+
+        data.each do |pt|
+          id = pt["id"]
+          participant_ids << id
+        end
+
+        return participant_ids
+      end
+
+      def generate_participant_objects(participants)
+        participants.map do |participant|
+          participant_object = RUBG::Participant.new({
+            :participant_hash => participant
+            })
+
+          @participants << participant_object
+        end
+      
+        @participants.sort_by! {|pt| pt.name}
+
+        return @participants
+      end
+
+  end
+end

data/lib/rubg/rubg_endpoint.rb

@@ -56,9 +56,12 @@ module RUBG
           uri = '/status'
         elsif args[:endpoint] == 'player'
           uri = "/shards/#{args[:shard]}/players/#{args[:lookup_id]}"
+        elsif args[:endpoint] == 'match'
+          uri = "/shards/#{args[:shard]}/matches/#{args[:lookup_id]}"
         else
           uri = "/shards/#{args[:shard]}/#{args[:endpoint]}"
         end
+
         return uri
       end
 
@@ -82,7 +85,7 @@ module RUBG
           remove_spaces(value) if value
         end
         query = args[:query_params]
-        
+
         return query
       end
 

data/lib/rubg/status.rb

@@ -1,6 +1,6 @@
 module RUBG
   class Status < RubgEndpoint
-    attr_reader :released_at, :version
+    attr_reader :released_at, :version, :alive
     
     def initialize( args )
       args     = self.class.defaults.merge(args)

data/lib/rubg/version.rb

@@ -1,3 +1,3 @@
 module RUBG
-  VERSION = "0.1.4"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubg
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Dor
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-06 00:00:00.000000000 Z
+date: 2018-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -99,11 +99,14 @@ files:
 - lib/rubg.rb
 - lib/rubg/client.rb
 - lib/rubg/match.rb
-- lib/rubg/matches.rb
+- lib/rubg/match_collection.rb
+- lib/rubg/participant.rb
 - lib/rubg/player.rb
-- lib/rubg/players.rb
+- lib/rubg/player_collection.rb
+- lib/rubg/roster.rb
 - lib/rubg/rubg_endpoint.rb
 - lib/rubg/status.rb
+- lib/rubg/telemetry.rb
 - lib/rubg/version.rb
 - rubg.gemspec
 homepage: https://github.com/dor-edras/rubg

data/lib/rubg/matches.rb

@@ -1,5 +0,0 @@
-module RUBG
-  class Matches
-
-  end
-end