sports_data_api 0.0.3 → 0.1.0

data/lib/sports_data_api/nba/player.rb

@@ -0,0 +1,22 @@
+module SportsDataApi
+  module Nba
+    class Player
+      attr_reader :stats
+
+      def initialize(xml)
+        if xml.is_a? Nokogiri::XML::Element
+          player_ivar = self.instance_variable_set("@#{xml.name}", {})
+          self.class.class_eval { attr_reader :"#{xml.name}" }
+          xml.attributes.each do | attr_name, attr_value|
+            player_ivar[attr_name.to_sym] = attr_value.value
+          end
+
+          stats_xml = xml.xpath('statistics')
+          if stats_xml.is_a? Nokogiri::XML::NodeSet and stats_xml.count > 0
+            @stats = SportsDataApi::Stats.new(stats_xml.first)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nba/season.rb

@@ -0,0 +1,28 @@
+module SportsDataApi
+  module Nba
+    class Season
+      attr_reader :id, :year, :type, :games
+
+      def initialize(xml)
+        if xml.is_a? Nokogiri::XML::NodeSet
+          @id = xml.first["id"]
+          @year = xml.first["year"].to_i
+          @type = xml.first["type"].to_sym
+
+          @games = xml.first.xpath("games/game").map do |game_xml|
+            Game.new(year: @year, season: @type, xml: game_xml)
+          end
+        end
+      end
+
+      ##
+      # Check if the requested season is a valid
+      # NBA season type.
+      #
+      # The only valid types are: :pre, :reg, :pst
+      def self.valid?(season)
+        [:PRE, :REG, :PST].include?(season)
+      end
+    end
+  end
+end

data/lib/sports_data_api/nba/team.rb

@@ -0,0 +1,40 @@
+module SportsDataApi
+  module Nba
+    class Team
+      attr_reader :id, :name, :market, :alias, :conference, :division,
+                  :stats, :players, :points
+
+      def initialize(xml, conference = nil, division = nil)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @id = xml['id']
+          @name = xml['name']
+          @market = xml['market']
+          @alias = xml['alias']
+          @points = xml['points'] ? xml['points'].to_i : nil
+          @conference = conference
+          @division = division
+          @players = xml.xpath("players/player").map do |player_xml|
+            Player.new(player_xml)
+          end
+        end
+      end
+
+      ##
+      # Compare the Team with another team
+      def ==(other)
+        # Must have an id to compare
+        return false if self.id.nil?
+
+        if other.is_a? SportsDataApi::Nba::Team
+          return false if other.id.nil?
+          self.id === other.id
+        elsif other.is_a? Symbol
+          self.id.to_sym === other
+        else
+          super(other)
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nba/teams.rb

@@ -0,0 +1,83 @@
+module SportsDataApi
+  module Nba
+    class Teams
+      include Enumerable
+
+      attr_reader :conferences, :divisions
+
+      ##
+      # Initialize by passing the raw XML returned from the API
+      def initialize(xml)
+        @teams = []
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          xml.xpath('conference').each do |conference|
+            # Conference ID, e.g., EASTERN or WESTERN
+            cname = conference['alias']
+
+            conference.xpath('division').each do |division|
+              # Division ID, e.g., ATLANTIC, PACIFIC
+              dname = division['alias']
+
+              # Create a new team
+              @teams << division.xpath('team').map { |team| Team.new(team, cname, dname) }
+            end
+          end
+        end
+
+        @teams.flatten!
+
+        uniq_conferences = @teams.map { |team| team.conference.upcase }.uniq
+        @allowed_conferences = uniq_conferences.map { |str| str.to_sym }.concat(uniq_conferences.map { |str| str.downcase.to_sym })
+        @conferences = uniq_conferences.map { |conf| conf.to_sym }
+
+        uniq_divisions = @teams.map { |team| team.division.upcase }.uniq
+        @divisions =  @teams.map { |team| team.division.to_sym }.uniq
+        @allowed_divisions = uniq_divisions.map { |str| str.to_sym }.concat(uniq_divisions.map { |str| str.downcase.to_sym })
+      end
+
+      def [](search_index)
+        found_index = @teams.index(search_index)
+        unless found_index.nil?
+          @teams[found_index]
+        end
+      end
+
+      ##
+      #
+      def respond_to?(method)
+        @allowed_conferences.include?(method) || @allowed_divisions.include?(method)
+      end
+
+      ##
+      #
+      def method_missing(method)
+        if @allowed_conferences.include?(method)
+          return @teams.select do |team|
+            up = team.conference.upcase.to_sym
+            dw = team.conference.downcase.to_sym
+            up === method || dw === method
+          end
+        elsif @allowed_divisions.include?(method)
+          return @teams.select do |team|
+            up = team.division.upcase.to_sym
+            dw = team.division.downcase.to_sym
+            up === method || dw === method
+          end
+        end
+      end
+
+      ##
+      # Make the class Enumerable
+      def each(&block)
+        @teams.each do |team|
+          if block_given?
+            block.call team
+          else
+            yield team
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nba/venue.rb

@@ -0,0 +1,20 @@
+module SportsDataApi
+  module Nba
+    class Venue
+      attr_reader :id, :name, :address, :city, :state, :zip, :country, :capacity
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @id = xml['id']
+          @name = xml['name']
+          @address = xml['address']
+          @city = xml['city']
+          @state = xml['state']
+          @zip = xml['zip']
+          @country = xml['country']
+          @capacity = xml['capacity']
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nba.rb

@@ -0,0 +1,71 @@
+module SportsDataApi
+  module Nba
+
+    class Exception < ::Exception
+    end
+
+    DIR = File.join(File.dirname(__FILE__), 'nba')
+    BASE_URL = 'http://api.sportsdatallc.org/nba-%{access_level}%{version}'
+    DEFAULT_VERSION = 3
+    SPORT = :nba
+
+    autoload :Team, File.join(DIR, 'team')
+    autoload :Teams, File.join(DIR, 'teams')
+    autoload :Player, File.join(DIR, 'player')
+    autoload :Game, File.join(DIR, 'game')
+    autoload :Games, File.join(DIR, 'games')
+    autoload :Season, File.join(DIR, 'season')
+    autoload :Venue, File.join(DIR, 'venue')
+    autoload :Broadcast, File.join(DIR, 'broadcast')
+
+    ##
+    # Fetches NBA season schedule for a given year and season
+    def self.schedule(year, season, version = DEFAULT_VERSION)
+      season = season.to_s.upcase.to_sym
+      raise SportsDataApi::Nba::Exception.new("#{season} is not a valid season") unless Season.valid?(season)
+
+      response = self.response_xml(version, "/games/#{year}/#{season}/schedule.xml")
+
+      return Season.new(response.xpath("/league/season-schedule"))
+    end
+
+    ##
+    # Fetches NBA team roster
+    def self.team_roster(team, version = DEFAULT_VERSION)
+      response = self.response_xml(version, "/teams/#{team}/profile.xml")
+
+      return Team.new(response.xpath("team"))
+    end
+
+    ##
+    # Fetches NBA game summary for a given game
+    def self.game_summary(game, version = DEFAULT_VERSION)
+      response = self.response_xml(version, "/games/#{game}/summary.xml")
+
+      return Game.new(xml: response.xpath("/game"))
+    end
+
+    ##
+    # Fetches all NBA teams
+    def self.teams(version = DEFAULT_VERSION)
+      response = self.response_xml(version, "/league/hierarchy.xml")
+
+      return Teams.new(response.xpath('/league'))
+    end
+
+    ##
+    # Fetches NBA daily schedule for a given date
+    def self.daily(year, month, day, version = DEFAULT_VERSION)
+      response = self.response_xml(version, "/games/#{year}/#{month}/#{day}/schedule.xml")
+
+      return Games.new(response.xpath('league/daily-schedule'))
+    end
+
+    private
+    def self.response_xml(version, url)
+      base_url = BASE_URL % { access_level: SportsDataApi.access_level(SPORT), version: version }
+      response = SportsDataApi.generic_request("#{base_url}#{url}", SPORT)
+      Nokogiri::XML(response.to_s).remove_namespaces!
+    end
+  end
+end

data/lib/sports_data_api/nfl/broadcast.rb

@@ -0,0 +1,15 @@
+module SportsDataApi
+  module Nfl
+    class Broadcast
+      attr_reader :network, :satellite, :internet
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @network = xml['network']
+          @satellite = xml['satellite']
+          @internet = xml['internet']
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/game.rb

@@ -0,0 +1,83 @@
+module SportsDataApi
+  module Nfl
+    class Game
+      attr_reader :id, :scheduled, :home, :home_team, :away,
+        :away_team, :status, :quarter, :clock, :venue, :broadcast, :weather,
+        :year, :season, :week
+
+      def initialize(year, season, week, xml)
+        @year = year.to_i
+        @season = season.to_sym
+        @week = week.to_i
+
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @id = xml['id']
+          @scheduled = Time.parse xml['scheduled']
+          @home = xml['home']
+          @away = xml['away']
+          @status = xml['status']
+          @quarter = xml['quarter'].to_i
+          @clock = xml['clock']
+
+          team_xml = xml.xpath('team')
+          @home_team = Team.new(team_xml.first)
+          @away_team = Team.new(team_xml.last)
+          @venue = Venue.new(xml.xpath('venue'))
+          @broadcast = Broadcast.new(xml.xpath('broadcast'))
+          @weather = Weather.new(xml.xpath('weather'))
+        end
+      end
+
+      ##
+      # Wrapper for Nfl.statistics
+      # TODO
+      def statistics
+        raise NotImplementedError
+      end
+
+      ##
+      # Wrapper for Nfl.summary
+      # TODO
+      def summary
+        raise NotImplementedError
+      end
+
+      ##
+      # Wrapper for Nfl.pbp (Nfl.play_by_play)
+      # TODO
+      def pbp
+        raise NotImplementedError
+      end
+
+      ##
+      # Wrapper for Nfl.boxscore these helper methods are used
+      # to provide similar functionality as the links attribute
+      # found in the weekly schedule example.
+      def boxscore
+        Nfl.boxscore(year, season, week, home, away, 1)
+      end
+
+      ##
+      # Wrapper for Nfl.roster
+      # TODO
+      def roster
+        raise NotImplementedError
+      end
+
+      ##
+      # Wrapper for Nfl.injuries
+      # TODO
+      def injuries
+        raise NotImplementedError
+      end
+
+      ##
+      # Wrapper for Nfl.depthchart
+      # TODO
+      def depthchart
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/games.rb

@@ -0,0 +1,29 @@
+module SportsDataApi
+  module Nfl
+    class Games
+      include Enumerable
+      attr_reader :games, :year, :season, :week
+
+      def initialize(xml)
+        @year = xml.first['season'].to_i
+        @season = xml.first['type'].to_sym
+        @week = xml.first['week'].to_i
+
+        @games = xml.xpath("game").map do |game_xml|
+          Game.new(@year, @season, @week, game_xml)
+        end
+      end
+
+      def each &block
+        @games.each do |game|
+          if block_given?
+            block.call game
+          else
+            yield game
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/sports_data_api/nfl/injuries.rb

@@ -0,0 +1,9 @@
+module SportsDataApi
+  module Nfl
+    class Injuries
+      include Enumerable
+      attr_reader :injuries
+
+    end
+  end
+end

data/lib/sports_data_api/nfl/player.rb

@@ -0,0 +1,15 @@
+module SportsDataApi
+  module Nfl
+    class Player
+      def initialize(xml)
+        if xml.is_a? Nokogiri::XML::Element
+          player_ivar = self.instance_variable_set("@#{xml.name}", {})
+          self.class.class_eval { attr_reader :"#{xml.name}" }
+          xml.attributes.each do | attr_name, attr_value|
+            player_ivar[attr_name.to_sym] = attr_value.value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/player_season_stats.rb

@@ -0,0 +1,26 @@
+module SportsDataApi
+  module Nfl
+    class PlayerSeasonStats
+      attr_reader :stats, :id, :players
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        @players = []
+        xml.xpath("player").each do | p |
+          player = {}
+          stats = []
+
+          p.children.each do | stat |
+            if stat.name == "text"
+              next
+            end
+            stats << SportsDataApi::Stats.new(stat)
+          end
+
+          player[:id] = p['id']
+          player[:stats] = stats
+          @players << player
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/season.rb

@@ -0,0 +1,27 @@
+module SportsDataApi
+  module Nfl
+    class Season
+      attr_reader :year, :type, :weeks
+
+      def initialize(xml)
+        @weeks = []
+        if xml.is_a? Nokogiri::XML::NodeSet
+          @year = xml.first["season"].to_i
+          @type = xml.first["type"].to_sym
+          @weeks = xml.first.xpath("week").map do |week_xml|
+            Week.new(@year, @type, week_xml)
+          end
+        end
+      end
+
+      ##
+      # Check if the requested season is a valid
+      # NFL season type.
+      #
+      # The only valid types are: :PRE, :REG, :PST
+      def self.valid?(season)
+        [:PRE, :REG, :PST].include?(season)
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/team.rb

@@ -0,0 +1,46 @@
+module SportsDataApi
+  module Nfl
+    class Team
+      attr_reader :id, :name, :conference, :division, :market, :remaining_challenges, :remaining_timeouts, :score, :quarters
+
+      def initialize(xml, conference = nil, division = nil)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @id = xml['id']
+          @name = xml['name']
+          @conference = conference
+          @division = division
+          @market = xml['market']
+          @remaining_challenges = xml['remaining_challenges'].to_i
+          @remaining_timeouts = xml['remaining_timeouts'].to_i
+          @quarters = xml.xpath('scoring/quarter').map do |quarter|
+            quarter['points'].to_i
+          end
+          @quarters = @quarters.fill(0, @quarters.size, 4 - @quarters.size)
+        end
+      end
+
+      # Sum the score of each quarter
+      def score
+        @quarters.inject(:+)
+      end
+
+      ##
+      # Compare the Team with another team
+      def ==(other)
+        # Must have an id to compare
+        return false if self.id.nil?
+
+        if other.is_a? SportsDataApi::Nfl::Team
+          return false if other.id.nil?
+          self.id === other.id
+        elsif other.is_a? Symbol
+          self.id.to_sym === other
+        else
+          super(other)
+        end
+      end
+
+    end
+  end
+end

data/lib/sports_data_api/nfl/team_roster.rb

@@ -0,0 +1,17 @@
+module SportsDataApi
+  module Nfl
+    class TeamRoster
+      attr_reader :players
+
+      def initialize(xml)
+        @players = []
+        xml.children.each do | player |
+          if player.name == "text"
+            next
+          end
+          @players << Player.new(player)
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/team_season_stats.rb

@@ -0,0 +1,19 @@
+module SportsDataApi
+  module Nfl
+    class TeamSeasonStats
+      attr_reader :id, :stats
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        @id = xml['id']
+        @stats = []
+        xml.xpath("players").remove
+        xml.children.each do | stat |
+          if stat.name == "text"
+            next
+          end
+          @stats << SportsDataApi::Stats.new(stat)
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/teams.rb

@@ -0,0 +1,84 @@
+module SportsDataApi
+  module Nfl
+    class Teams
+      include Enumerable
+
+      attr_reader :conferences, :divisions
+
+      ##
+      # Initialize by passing the raw XML returned from the API
+      def initialize(xml)
+        @teams = []
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          xml.xpath('conference').each do |conference|
+            # Conference ID, e.g., AFC or NFC
+            cid = conference['id']
+
+            conference.xpath('division').each do |division|
+              # Division ID, e.g., AFC_EAST, NFC_NORTH
+              did = division['id']
+
+              # Create a new team
+              @teams << division.xpath('team').map { |team| Team.new(team, cid, did) }
+            end
+          end
+        end
+
+        @teams.flatten!
+
+        uniq_conferences = @teams.map { |team| team.conference.upcase }.uniq
+        @allowed_conferences = uniq_conferences.map { |str| str.to_sym }.concat(uniq_conferences.map { |str| str.downcase.to_sym })
+        @conferences = uniq_conferences.map { |conf| conf.to_sym }
+
+        uniq_divisions = @teams.map { |team| team.division.upcase }.uniq
+        @divisions =  @teams.map { |team| team.division.to_sym }.uniq
+        @allowed_divisions = uniq_divisions.map { |str| str.to_sym }.concat(uniq_divisions.map { |str| str.downcase.to_sym })
+      end
+
+      def [](search_index)
+        found_index = @teams.index(search_index)
+        unless found_index.nil?
+          @teams[found_index]
+        end
+      end
+
+      ##
+      #
+      def respond_to?(method)
+        @allowed_conferences.include?(method) || @allowed_divisions.include?(method)
+      end
+
+      ##
+      #
+      def method_missing(method)
+        if @allowed_conferences.include?(method)
+          return @teams.select do |team|
+            up = team.conference.upcase.to_sym
+            dw = team.conference.downcase.to_sym
+            up === method || dw === method
+          end
+        elsif @allowed_divisions.include?(method)
+          return @teams.select do |team|
+            up = team.division.upcase.to_sym
+            dw = team.division.downcase.to_sym
+            up === method || dw === method
+          end
+        end
+      end
+
+      ##
+      # Make the class Enumerable
+      def each(&block)
+        @teams.each do |team|
+          if block_given?
+            block.call team
+          else
+            yield team
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/sports_data_api/nfl/venue.rb

@@ -0,0 +1,22 @@
+module SportsDataApi
+  module Nfl
+    class Venue
+      attr_reader :id, :name, :address, :city, :state, :zip, :country, :capacity, :type, :surface
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @id = xml['id']
+          @name = xml['name']
+          @address = xml['address']
+          @city = xml['city']
+          @state = xml['state']
+          @zip = xml['zip']
+          @country = xml['country']
+          @capacity = xml['capacity']
+          @type = xml['type']
+          @surface = xml['surface']
+        end
+      end
+    end
+  end
+end

data/lib/sports_data_api/nfl/weather.rb

@@ -0,0 +1,17 @@
+module SportsDataApi
+  module Nfl
+    class Weather
+      attr_reader :temperature, :condition, :humidity, :wind_speed, :wind_direction
+      def initialize(xml)
+        xml = xml.first if xml.is_a? Nokogiri::XML::NodeSet
+        if xml.is_a? Nokogiri::XML::Element
+          @temperature = xml['temperature'].to_i
+          @condition = xml['condition']
+          @humidity = xml['humidity'].to_i
+          @wind_speed = xml.xpath('wind').first['speed'].to_i
+          @wind_direction = xml.xpath('wind').first['direction']
+        end
+      end
+    end
+  end
+end