sportradar-api 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1375039806670a04b628f8bacb62b2022cb83584
-  data.tar.gz: 806f1fac9a3328443eb81b917a9e338b07a98718
+  metadata.gz: d345b49b575483e102bdd67848aa7ed27303b171
+  data.tar.gz: d3f77c8f2ffa19e0c79250d5c8a95b4d15d8f6b1
 SHA512:
-  metadata.gz: ff799d3f643fc2bbde17e2971e9299089dad60648d019c8d6b90ddb94f779b40f88f34db33d742bc7c8c1063d3d3e420f4299ef91f63db5ad735912c817ae8fb
-  data.tar.gz: 91dbb9c76739a8d233034a0777c2d943540a9b72924bc903b60f31fd0f29a0a2ff4f8273b5010d69175a1e53e0feb1e6149b06b4c84987a76cc5b79ecfa8b0d9
+  metadata.gz: cbc84253254da9add4d9af9b6df1b43f7c33057d06fc2a4ead5efee3f46c33b318c14c9eaac91de4917b3cba2fe31c3dce2c1f3479249159b1e0a996ca9d41e5
+  data.tar.gz: 0defe4bef73aa06f60a5de722f91b604be5d7e375c0e690407e1348ccff01a41eb5db847b8ec0ede725def6b3cf4bc5f489084d8783ebbe31b368c48444dfe20

data/.env.sample

@@ -26,8 +26,6 @@ SPORTRADAR_IMAGES_MLS:       your-images_mls-api-key
 SPORTRADAR_LIVE_IMAGES_NFL:  your-live_images_nfl-api-key
 SPORTRADAR_LIVE_IMAGES_NBA:  your-live_images_nba-api-key
 SPORTRADAR_LIVE_IMAGES_MLS:  your-live_images_mls-api-key
-SPORTRADAR_CONTENT_NBA_V2:   your-content_nba_v2-api-key
-SPORTRADAR_CONTENT_NFL_V2:   your-content_nfl_v2-api-key
 SPORTRADAR_CONTENT_NBA:      your-content_nba-api-key
 SPORTRADAR_CONTENT_NFL:      your-content_nfl-api-key
 SPORTRADAR_ODDS:             your-odds-api-key

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sportradar-api (0.1.0)
+    sportradar-api (0.1.1)
       httparty (>= 0.13.3)
 
 GEM

data/README.md

@@ -1,3 +1,9 @@
+[![Gem Version](https://badge.fury.io/rb/sportradar-api.svg)](https://badge.fury.io/rb/sportradar-api)
+[![Build Status](https://travis-ci.org/beneggett/sportradar-api.svg?branch=master)](https://travis-ci.org/beneggett/sportradar-api)
+[![Code Climate](https://codeclimate.com/github/beneggett/sportradar-api/badges/gpa.svg)](https://codeclimate.com/github/beneggett/sportradar-api)
+[![Coverage Status](https://coveralls.io/repos/github/beneggett/sportradar-api/badge.svg?branch=master)](https://coveralls.io/github/beneggett/sportradar-api?branch=master)
+
+
 # Sportradar API
 
 The SportRadar API extensively covers league & sports data. This gem wraps it up, marshals the data into Ruby Objects we know and love.

data/lib/sportradar/api.rb

@@ -10,6 +10,8 @@ require "sportradar/api/request"
 
 require "sportradar/api/soccer"
 require "sportradar/api/nfl"
+require "sportradar/api/images"
+require "sportradar/api/live_images"
 
 module Sportradar
   module Api
@@ -48,7 +50,7 @@ module Sportradar
     end
 
     def self.api_key(api)
-      ENV.fetch("SPORTRADAR_#{api.to_s.upcase}", "api_key missing for #{api}")
+      ENV.fetch("SPORTRADAR_#{api.to_s.upcase.gsub('-', '_')}", "api_key missing for #{api}")
     end
 
     def self.version(api)

data/lib/sportradar/api/error.rb

@@ -5,6 +5,8 @@ module Sportradar
       class NoApiKey < AuthenticationError; end
       class InvalidResponseFormat < TypeError; end
       class InvalidLeague < StandardError; end
+      class InvalidSeason < StandardError; end
+      class InvalidSport < StandardError; end
       class InvalidAccessLevel < StandardError; end
       class InvalidSeason < StandardError; end
       class Timeout < Timeout::Error ; end

data/lib/sportradar/api/images.rb

@@ -0,0 +1,118 @@
+module Sportradar
+  module Api
+    class Images < Request
+      attr_accessor :sport, :league, :access_level
+      def initialize( sport, league = nil, access_level = 't')
+        raise Sportradar::Api::Error::InvalidSport unless allowed_sports.include? sport
+        @sport = sport
+        raise Sportradar::Api::Error::InvalidLeague unless soccer_leagues.include?(league) || league.nil?
+        @league = league
+
+        raise Sportradar::Api::Error::InvalidAccessLevel unless allowed_access_levels.include? access_level
+        @access_level = access_level
+      end
+
+      def player_manifests(year = Date.today.year)
+        if league
+          get request_url("#{league}/#{image_type}/players/#{year}/manifest")
+        else
+          get request_url("players/#{image_type}/manifests/all_assets")
+        end
+      end
+      alias_method :all_players, :player_manifests
+      # Coach Manifests
+
+      def coach_manifests
+        raise Sportradar::Api::Error::InvalidLeague unless league.nil?
+        get request_url("coaches/#{image_type}/manifests/all_assets")
+      end
+      alias_method :all_coaches, :coach_manifests
+
+      def venue_manifests
+        raise Sportradar::Api::Error::InvalidLeague unless league.nil?
+        get request_url("venues/manifests/all_assets")
+      end
+      alias_method :all_venues, :venue_manifests
+
+      # The Player Images, Coach Images, Venue Images APIs aren't really meant to be used directly, the manifests return an href path of an image we can pass it into the image_url method to get the entire image url
+      def image_url(href)
+        href.slice!(0) # remove initial '/'
+        set_base request_url(href) + api_key_query_string
+      end
+      alias_method :player_images, :image_url
+      alias_method :coach_images, :image_url
+      alias_method :venue_images, :image_url
+
+      private
+
+      def request_url(path)
+        "/#{sport}-images-#{access_level}#{version}/#{provider}/#{path}"
+      end
+
+      def api_key
+        if league
+          Sportradar::Api.api_key_params("images_#{league}")
+        else
+          Sportradar::Api.api_key_params("images_#{sport}")
+        end
+      end
+
+      def api_key_query_string
+        "?#{api_key.keys.first}=#{api_key.values.first}"
+      end
+
+      def provider
+        if uses_v2_api?
+          'usat'
+        elsif uses_v3_api?
+          'reuters'
+        end
+      end
+
+      def version
+        if uses_v2_api?
+          Sportradar::Api.version('images')
+        elsif uses_v3_api?
+          3
+        end
+      end
+
+      def image_type
+        'headshots'
+      end
+
+      def uses_v2_api?
+        v2_api_sports.include?(sport)
+      end
+
+      def uses_v3_api?
+        v3_api_sports.include?(sport)
+      end
+
+      def allowed_access_levels
+        ['p', 't']
+      end
+
+      def allowed_sports
+        v2_api_sports + v3_api_sports
+      end
+
+      def v2_api_sports
+        ['golf', 'mlb', 'nascar', 'nba', 'nfl', 'nhl', 'ncaafb', 'ncaamb', 'mls']
+      end
+
+      def v3_api_sports
+        ['soccer', 'cricket', 'f1', 'rugby', 'tennis']
+      end
+
+      def soccer_leagues
+        ['bundesliga', 'epl', 'serie-a', 'la-liga', 'ligue-1']
+      end
+
+      def additional_content_sports
+        ['mlb', 'nba', 'nfl', 'nhl']
+      end
+
+    end
+  end
+end

data/lib/sportradar/api/live_images.rb

@@ -0,0 +1,60 @@
+module Sportradar
+  module Api
+    class LiveImages < Request
+      attr_accessor :sport, :league, :access_level
+
+      def initialize( sport, league = nil, access_level = 't')
+        raise Sportradar::Api::Error::InvalidSport unless allowed_sports.include? sport
+        @sport = sport
+        raise Sportradar::Api::Error::InvalidAccessLevel unless allowed_access_levels.include? access_level
+        @access_level = access_level
+      end
+
+      def daily_manifest(date = Date.today )
+        get request_url("#{image_type }/#{date.to_s}/manifests/all_assets")
+      end
+      alias_method :all_images, :daily_manifest
+
+      # The Event images APIs aren't really meant to be used directly, the manifests return an href path of an image we can pass it into the image_url method to get the entire image url
+      def image_url(href)
+        href.slice!(0) # remove initial '/'
+        set_base request_url(href) + api_key_query_string
+      end
+
+      private
+
+      def request_url(path)
+        "/#{sport}-liveimages-#{access_level}#{version}/#{provider}/#{path}"
+      end
+
+      def api_key
+        Sportradar::Api.api_key_params("live_images_#{sport}")
+      end
+
+      def api_key_query_string
+        "?#{api_key.keys.first}=#{api_key.values.first}"
+      end
+
+      def provider
+        'usat'
+      end
+
+      def version
+        Sportradar::Api.version('live_images')
+      end
+
+      def image_type
+        'news'
+      end
+
+      def allowed_access_levels
+        ['p', 't']
+      end
+
+      def allowed_sports
+        ['golf', 'mlb', 'nascar', 'nba', 'nfl', 'nhl', 'ncaafb', 'ncaamb', 'mls']
+      end
+
+    end
+  end
+end

data/lib/sportradar/api/nfl.rb

@@ -1,7 +1,8 @@
 module Sportradar
   module Api
-    class Nfl
+    class Nfl < Request
       attr_accessor :league, :access_level
+
       def initialize( access_level = 'ot')
         @league = 'nfl'
         raise Sportradar::Api::Error::InvalidAccessLevel unless allowed_access_levels.include? access_level
@@ -9,65 +10,65 @@ module Sportradar
       end
 
       def league_hierarchy
-        results = Sportradar::Api::Request.new.get(request_url("league/hierarchy"), api_key )
+        get request_url("league/hierarchy")
       end
 
       def schedule(year = Date.today.year, season = 'reg')
-        raise Sportradar::Api::Error::InvalidLeague unless allowed_seasons.include? season
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ year }/#{ season }/schedule"), api_key )
+        raise Sportradar::Api::Error::InvalidSeason unless allowed_seasons.include? season
+        get request_url("games/#{ year }/#{ season }/schedule")
       end
 
       def weekly_schedule(year = Date.today.year, season = 'reg', week = 1)
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ year }/#{ season }/#{ week }/schedule"), api_key )
+        get request_url("games/#{ week_path(year, season, week) }/schedule")
       end
 
       def standings(year = Date.today.year)
-        results = Sportradar::Api::Request.new.get(request_url("seasontd/#{ year }/standings"), api_key )
+        get request_url("seasontd/#{ year }/standings")
       end
 
       def weekly_depth_charts(year = Date.today.year, season = 'reg', week = 1)
-        results = Sportradar::Api::Request.new.get(request_url("seasontd/#{ year }/#{ season }/#{ week }/depth_charts"), api_key )
+        get request_url("seasontd/#{ week_path(year, season, week) }/depth_charts")
       end
 
       def weekly_injuries(year = Date.today.year, season = 'reg', week = 1)
-        results = Sportradar::Api::Request.new.get(request_url("seasontd/#{ year }/#{ season }/#{ week }/injuries"), api_key )
+        get request_url("seasontd/#{ week_path(year, season, week) }/injuries")
       end
 
       def daily_change_log(date = Date.today)
-        results = Sportradar::Api::Request.new.get(request_url("league/#{ date.year }/#{ date.month }/#{ date.day }/changes"), api_key )
+        get request_url("league/#{date_path(date)}/changes")
       end
 
       # past_game_id = "0141a0a5-13e5-4b28-b19f-0c3923aaef6e"
       # future_game_id = "28290722-4ceb-4a4c-a4e5-1f9bec7283b3"
       def game_boxscore(game_id)
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ game_id }/boxscore"), api_key )
+        get request_url("games/#{ game_id }/boxscore")
       end
 
       def game_roster(game_id)
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ game_id }/roster"), api_key )
+        get request_url("games/#{ game_id }/roster")
       end
 
       def game_statistics(game_id)
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ game_id }/statistics"), api_key )
+        get request_url("games/#{ game_id }/statistics")
       end
 
       def play_by_play(game_id)
-        results = Sportradar::Api::Request.new.get(request_url("games/#{ game_id }/pbp"), api_key )
+        get request_url("games/#{ game_id }/pbp")
       end
 
       # player_id = "ede260be-5ae6-4a06-887b-e4a130932705"
       def player_profile(player_id)
-        results = Sportradar::Api::Request.new.get(request_url("players/#{ player_id }/profile"), api_key )
+        get request_url("players/#{ player_id }/profile")
       end
 
       # team_id = "97354895-8c77-4fd4-a860-32e62ea7382a"
       def seasonal_statistics(team_id, year = Date.today.year, season = 'reg')
          raise Sportradar::Api::Error::InvalidLeague unless allowed_seasons.include? season
-        results = Sportradar::Api::Request.new.get(request_url("seasontd/#{ year }/#{ season }/teams/#{ team_id }/statistics"), api_key )
+        get request_url("seasontd/#{ year }/#{ season }/teams/#{ team_id }/statistics")
       end
 
       def team_profile(team_id)
-        results = Sportradar::Api::Request.new.get(request_url("teams/#{ team_id }/profile"), api_key )
+        get request_url("teams/#{ team_id }/profile")
       end
 
       private

data/lib/sportradar/api/request.rb

@@ -7,7 +7,7 @@ module Sportradar
       attr_reader :url, :headers, :timeout, :api_key
 
       def base_setup(path, options={})
-        @url = set_base(path)
+        @url = set_base(path) + format
         @headers = set_headers
         @api_key = options[:api_key]
         @timeout = options.delete(:api_timeout) || Sportradar::Api.config.api_timeout
@@ -15,7 +15,8 @@ module Sportradar
 
       def get(path, options={})
         base_setup(path, options)
-        results = self.class.get(url, headers: headers, query: options, timeout: timeout)
+        puts url
+        results = self.class.get(url, headers: headers, query: options.merge(api_key), timeout: timeout)
         rescue Net::ReadTimeout, Net::OpenTimeout
           raise Sportradar::Api::Error::Timeout
         rescue EOFError
@@ -28,13 +29,28 @@ module Sportradar
         protocol = !!Sportradar::Api.config.use_ssl ? "https://" : "http://"
         url = "#{protocol}api.sportradar.us"
         url += path
-        url += ".#{Sportradar::Api.config.format}"
+      end
+
+      def date_path(date = Date.today)
+        "#{date.year}/#{date.month}/#{date.day}"
+      end
+
+      def week_path(year, season, week)
+        "#{ year }/#{ season }/#{ week }"
+      end
+
+
+      def format
+        ".#{Sportradar::Api.config.format}"
       end
 
       def set_headers
         {'Content-Type' => "application/#{Sportradar::Api.config.format}", 'Accept' => "application/#{Sportradar::Api.config.format}"}
       end
 
+      def api_key
+        raise Sportradar::Api::Error::NoApiKey
+      end
     end
   end
 end

data/lib/sportradar/api/soccer.rb

@@ -1,6 +1,6 @@
 module Sportradar
   module Api
-    class Soccer
+    class Soccer < Request
       attr_accessor :league, :access_level
       def initialize(league = 'na', access_level = 't')
         raise Sportradar::Api::Error::InvalidAccessLevel unless allowed_access_levels.include? access_level
@@ -10,51 +10,51 @@ module Sportradar
       end
 
       def schedule
-        results = Sportradar::Api::Request.new.get(request_url("matches/schedule"), api_key )
+        get request_url("matches/schedule")
       end
 
       def daily_schedule(date = Date.today)
-        results = Sportradar::Api::Request.new.get(request_url("matches/#{date.year}/#{date.month}/#{date.day}/schedule"), api_key )
+        get request_url("matches/#{date_path(date)}/schedule")
       end
 
       def daily_summary(date = Date.today)
-        results = Sportradar::Api::Request.new.get(request_url("matches/#{date.year}/#{date.month}/#{date.day}/summary"), api_key )
+        get request_url("matches/#{date_path(date)}/summary")
       end
 
       def daily_boxscore(date = Date.today)
-        results = Sportradar::Api::Request.new.get(request_url("matches/#{date.year}/#{date.month}/#{date.day}/boxscore"), api_key )
+        get request_url("matches/#{date_path(date)}/boxscore")
       end
 
       # match_id  = "357607e9-87cd-4848-b53e-0485d9c1a3bc"
       def match_summary(match_id)
-        results = Sportradar::Api::Request.new.get(request_url("matches/#{match_id}/summary"), api_key )
+        get request_url("matches/#{match_id}/summary")
       end
 
       # match_id  = "357607e9-87cd-4848-b53e-0485d9c1a3bc"
       def match_boxscore(match_id)
-        results = Sportradar::Api::Request.new.get(request_url("matches/#{match_id}/boxscore"), api_key )
+        get request_url("matches/#{match_id}/boxscore")
       end
 
       def team_hierarchy
-        results = Sportradar::Api::Request.new.get(request_url("teams/hierarchy"), api_key )
+        get request_url("teams/hierarchy")
       end
 
       # team_id = "b78b9f61-0697-4347-a1b6-b7685a130eb1"
       def team_profile(team_id)
-        results = Sportradar::Api::Request.new.get(request_url("teams/#{team_id}/profile"), api_key )
+        get request_url("teams/#{team_id}/profile")
       end
 
       def team_standings
-        results = Sportradar::Api::Request.new.get(request_url("teams/standing"), api_key )
+        get request_url("teams/standing")
       end
 
       # player_id = "2aeacd39-3f9c-42af-957e-9df8573973c4"
       def player_profile(player_id)
-        results = Sportradar::Api::Request.new.get(request_url("players/#{player_id}/profile"), api_key )
+        get request_url("players/#{player_id}/profile")
       end
 
       def player_rankings
-        results = Sportradar::Api::Request.new.get(request_url("players/leader"), api_key )
+        get request_url("players/leader")
       end
 
       private

data/lib/sportradar/api/version.rb

@@ -1,5 +1,5 @@
 module Sportradar
   module Api
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sportradar-api
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ben Eggett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-07-14 00:00:00.000000000 Z
+date: 2016-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -213,6 +213,8 @@ files:
 - lib/sportradar/api.rb
 - lib/sportradar/api/config.rb
 - lib/sportradar/api/error.rb
+- lib/sportradar/api/images.rb
+- lib/sportradar/api/live_images.rb
 - lib/sportradar/api/nfl.rb
 - lib/sportradar/api/request.rb
 - lib/sportradar/api/soccer.rb