opta_sd 1.0.0

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/config/opta_sd.yml

@@ -0,0 +1,2 @@
+opta_domain:     'http://api.performfeeds.com'
+opta_auth_token: 'sdapidocumentation'

data/config/parameters.yml

@@ -0,0 +1,74 @@
+core:
+  _rt: "_rt"
+  _format: "_fmt"
+  _locale: "_lcl"
+  _callback: "_clbk"
+  _sort: "_ordSrt"
+  _page_size: "_pgSz"
+  _page_number: "_pgNm"
+
+match:
+  fixture: "fx"
+  tournament: "tmcl" # tournament_calendar
+  stage: "stg"
+  competition: "comp"
+  contestant: "ctst"
+  match_time: "mt.mDt"
+  match_date: "mt.mDt"
+  live: "live"
+  lineups: "lineups"
+  status: "status"
+
+tournamentcalendar:
+  competition: "comp"
+
+squads:
+  tournament: "tmcl"
+  contestant: "ctst"
+  detailed: "detailed"
+  people: "people"
+
+possession:
+  fixture: "fx"
+
+matchevent:
+  fixture: "fx"
+
+matchstats:
+  fixture: "fx"
+  detailed: "detailed"
+
+passmatrix:
+  fixture: "fx"
+
+commentary:
+  fixture: "fx"
+  type: "type"
+
+matchfacts:
+  fixture: "fx"
+
+seasonstats:
+  tournament: "tmcl"
+  contestant: "ctst"
+  competition: "comp"
+
+standings:
+  stage: "stg"
+  tournament: "tmcl"
+  live: "live"
+  type: "type"
+
+playercareer:
+  person: "prsn"
+  active: "active"
+  contestant: "ctst"
+
+matchpreview:
+  fixture: "fx"
+
+rankings:
+  tournament: "tmcl"
+
+tournamentschedule:
+  tournament: "tmcl"

data/errors.yml

@@ -0,0 +1,21 @@
+10000: "An unexpected error has occurred"
+10001: "Page not found error"
+10010: "Outlet doesn't exist"
+10100: "Feed Unavailable"
+
+10200: "Missing request parameter"
+10201: "Unknown request parameter"
+10202: "Invalid request parameter value"
+10203: "Ambiguous/Invalid request parameters"
+10204: "Invalid request method"
+10210: "Unsupported format: _fmt parameter"
+10212: "Unsupported mode: _rt parameter"
+10217: "Invalid pagination: _pgNm, _pgSz parameters"
+10219: "_pgSz parameter above maximum"
+
+10300: "Feed Access Denied"
+10313: "User not Authorised"
+10320: "Acceptable usage exceeded"
+
+10400: "No data found"
+10401: "Data request timeout"

data/lib/opta_sd.rb

@@ -0,0 +1,42 @@
+# Project Requirements
+require 'yaml'
+require 'json'
+require 'nokogiri'
+require 'net/http'
+
+# Core Classes
+require 'opta_sd/core'
+require 'opta_sd/error'
+require 'opta_sd/soccer/soccer'
+require 'opta_sd/soccer/match'
+require 'opta_sd/soccer/squads'
+require 'opta_sd/soccer/rankings'
+require 'opta_sd/soccer/commentary'
+require 'opta_sd/soccer/possession'
+require 'opta_sd/soccer/match_event'
+require 'opta_sd/soccer/match_facts'
+require 'opta_sd/soccer/pass_matrix'
+require 'opta_sd/soccer/player_career'
+require 'opta_sd/soccer/match_preview'
+require 'opta_sd/soccer/seasonal_stats'
+require 'opta_sd/soccer/team_standings'
+require 'opta_sd/soccer/match_statistics'
+require 'opta_sd/soccer/tournament_calendar'
+require 'opta_sd/soccer/tournament_schedule'
+
+
+# Wrapper Classes
+# Soon
+
+# Add present? to Object
+class Object
+  def present?
+    !blank?
+  end
+end
+
+class NilClass
+  def blank?
+    nil?
+  end
+end

data/lib/opta_sd/core.rb

@@ -0,0 +1,119 @@
+module OptaSD
+  class Core
+
+    PARAMETERS = YAML::load(File.open(File.expand_path('../../../config/parameters.yml', __FILE__)))
+
+    attr_reader :data
+
+    # The Initialize
+    def initialize
+      set_configuration
+      @params = Hash.new
+    end
+
+    # Build the Request and get the Data
+    def get
+      response = Net::HTTP.get(build_uri)
+      @data = parse_data(response)
+      self
+    end
+
+    # Parse The Response
+    def parse_data(response)
+      case @params[:_fmt]
+      when 'json' then parse_json(response)
+      when 'xml'  then parse_xml(response)
+      else response end
+    end
+
+    # Parse JSON Response
+    def parse_json(response)
+      data = JSON.parse(response)
+      fail OptaSD::Error.new(data), ErrorMessage.get_message(data['errorCode'].to_i) if data['errorCode']
+      data
+    end
+
+    # Parse XML Response
+    def parse_xml(response)
+      data = Nokogiri::XML(response) do |config| config.strict.noblanks end
+      fail OptaSD::Error.new(xml_error_to_hast(data)), ErrorMessage.get_message(data.children.first.content.to_i) if data.css('errorCode').first.present?
+      data
+    end
+
+    # Define Core API Parameters
+    PARAMETERS['core'].keys.each do |param_name|
+      define_method param_name do |value|
+        @params[PARAMETERS['core'][param_name].to_sym] = value
+        self
+      end
+    end
+
+    private
+
+    # Load OPTA SD API Configurations from `config_file`
+    def set_configuration
+      config      = config_file
+      @domain     = config['opta_domain']
+      @auth_token = config['opta_auth_token']
+    end
+
+    # Load Configurations file 'config/opta_sd_api.yml'
+    def config_file
+      YAML::load(File.open(File.expand_path('../../../config/opta_sd.yml', __FILE__)))
+    end
+
+    # Build the Base URL of the Request
+    def build_url
+      [
+        @domain,
+        @sport,
+        @feed_name,
+        @auth_token,
+        @resource
+      ].compact.join('/')
+    end
+
+    # Convert Params from Hash To URI Query
+    def build_params
+      self._format('json') unless @params[:_fmt]
+      self._rt('b')        unless @params[:_rt]
+      URI.encode_www_form(@params)
+    end
+
+    # Generate valid URI for the request
+    def build_uri
+      # puts [build_url, build_params].join('?')
+      URI.parse([build_url, build_params].join('?'))
+    end
+
+    def xml_error_to_hast(data)
+      {
+        "errorCode" => data.children.first.content.to_i,
+        "token"     => data.children.first['token']
+      }
+    end
+
+    ## ---------------------------------------- ##
+
+    # Define resource for Boolean Parameters
+    def self.boolean_params(model , *args)
+      args.each do |param_name|
+        define_method param_name do |value = true|
+          @params[PARAMETERS[model.to_s][param_name.to_s]] = value ? 'yes' : 'no'
+          self
+        end
+      end
+    end
+
+    # Define Pesource Parameters
+    def self.resource_params(model, *args)
+      args.each do |param_name|
+        define_method param_name do |value|
+          @params[PARAMETERS[model.to_s][param_name.to_s] || param_name.to_s] = value
+          self
+        end
+      end
+    end
+
+  end
+end

data/lib/opta_sd/error.rb

@@ -0,0 +1,31 @@
+module OptaSD
+  class Error < StandardError
+    attr_reader :env, :message
+    attr_reader :response, :error_code, :token
+
+    def initialize(response)
+
+      unless response.instance_of? Hash
+        fail ::ArgumentError, 'Response passed to OptaSD::Error must be a hash'
+      end
+
+      @error_code = response["errorCode"]
+      @message    = ErrorMessage.get_message(@error_code.to_i)
+      @token      = response["token"]
+
+      log_error
+    end
+
+    private
+
+    def log_error
+    end
+  end
+
+  class ErrorMessage
+    def self.get_message(error_code)
+      errors = YAML::load(File.open(File.expand_path('../../../errors.yml', __FILE__)))
+      errors[error_code.to_i]
+    end
+  end
+end

data/lib/opta_sd/soccer/commentary.rb

@@ -0,0 +1,21 @@
+module OptaSD
+  module Soccer
+    class Commentary < OptaSD::Soccer::SoccerCore
+
+      resource_params 'commentary', :fixture, :type
+
+      def initialize
+        super
+        @feed_name = 'commentary'
+      end
+
+      %w(auto fallback manual).each do |type_value|
+        define_method type_value do
+          self.type(type_value)
+          self
+        end
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/match.rb

@@ -0,0 +1,20 @@
+module OptaSD
+  module Soccer
+    class Match < OptaSD::Soccer::SoccerCore
+
+      boolean_params  'match', :live,    :lineups
+      resource_params 'match', :fixture, :tournament, :stage, :competition, :contestant, :match_time, :match_date, :status
+
+      def initialize
+        super
+        @feed_name = 'match'
+      end
+
+      def time_range(from, to)
+        match_time("[#{from.strftime('%Y-%m-%dT%H:%M:%SZ')} TO #{to.strftime('%Y-%m-%dT%H:%M:%SZ')}]")
+        return self
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/match_event.rb

@@ -0,0 +1,13 @@
+module OptaSD
+  module Soccer
+    class MatchEvent < OptaSD::Soccer::SoccerCore
+
+      resource_params 'matchevent', :fixture
+
+      def initialize
+        super
+        @feed_name = 'matchevent'
+      end
+    end
+  end
+end

data/lib/opta_sd/soccer/match_facts.rb

@@ -0,0 +1,14 @@
+module OptaSD
+  module Soccer
+    class MatchFacts < OptaSD::Soccer::SoccerCore
+
+      resource_params 'matchfacts', :fixture
+
+      def initialize
+        super
+        @feed_name = 'matchfacts'
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/match_preview.rb

@@ -0,0 +1,14 @@
+module OptaSD
+  module Soccer
+    class MatchPreview < OptaSD::Soccer::SoccerCore
+
+      resource_params 'matchpreview', :fixture
+
+      def initialize
+        super
+        @feed_name = 'matchpreview'
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/match_statistics.rb

@@ -0,0 +1,14 @@
+module OptaSD
+  module Soccer
+    class MatchStatistics < OptaSD::Soccer::SoccerCore
+
+      boolean_params  'matchstats', :detailed
+      resource_params 'matchstats', :fixture
+
+      def initialize
+        super
+        @feed_name = 'matchstats'
+      end
+    end
+  end
+end

data/lib/opta_sd/soccer/pass_matrix.rb

@@ -0,0 +1,14 @@
+module OptaSD
+  module Soccer
+    class PassMatrix < OptaSD::Soccer::SoccerCore
+
+      resource_params 'passmatrix', :fixture
+
+      def initialize
+        super
+        @feed_name = 'passmatrix'
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/player_career.rb

@@ -0,0 +1,15 @@
+module OptaSD
+  module Soccer
+    class PlayerCareer < OptaSD::Soccer::SoccerCore
+
+      boolean_params  'playercareer', :active
+      resource_params 'playercareer', :person, :contestant
+
+      def initialize
+        super
+        @feed_name = 'playercareer'
+      end
+
+    end
+  end
+end

data/lib/opta_sd/soccer/possession.rb

@@ -0,0 +1,13 @@
+module OptaSD
+  module Soccer
+    class Possession < OptaSD::Soccer::SoccerCore
+
+      resource_params 'possession', :fixture
+
+      def initialize
+        super
+        @feed_name = 'possession'
+      end
+    end
+  end
+end