sports-butler 1.0.0

data/lib/sports/butler/soccer_api/football_data_org/players.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Sports
+  module Butler
+    module SoccerApi
+      module FootballDataOrg
+        class Players < Sports::Butler::SoccerApi::Players
+          require 'sports/butler/soccer_api/football_data_org/base'
+          include Sports::Butler::SoccerApi::FootballDataOrg::Base
+
+          def available_endpoint_methods
+            [:by_id]
+          end
+
+          def by_id(id:, filters: {})
+            api_with_id(id, filters)
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/football_data_org/scorers.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Sports
+  module Butler
+    module SoccerApi
+      module FootballDataOrg
+        class Scorers < Sports::Butler::SoccerApi::Scorers
+          def available_endpoint_methods
+            [:by_competition]
+          end
+
+          def by_competition(competition_id:, filters: {})
+            api.get(path: "competitions/#{competition_id}/#{path}", filters: filters)
+            api
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/football_data_org/standings.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sports
+  module Butler
+    module SoccerApi
+      module FootballDataOrg
+        class Standings < Sports::Butler::SoccerApi::Standings
+          def by_competition(competition_id:, filters: {})
+            api.get(path: "competitions/#{competition_id}/#{path}", filters: filters)
+            api
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/football_data_org/teams.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Sports
+  module Butler
+    module SoccerApi
+      module FootballDataOrg
+        class Teams < Sports::Butler::SoccerApi::Teams
+          require 'sports/butler/soccer_api/football_data_org/base'
+          include Sports::Butler::SoccerApi::FootballDataOrg::Base
+
+          def by_id(id:, filters: {})
+            api_with_id(id, filters)
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/head_to_head.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class HeadToHead < Sports::Butler::SoccerApi::Base
+        def path
+          :matches
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/injuries.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Injuries < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_competition_and_season, :by_match, :by_team_and_season]
+        end
+
+        def path
+          :injuries
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/lineups.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Lineups < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_match]
+        end
+
+        def path
+          :matches
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/matches.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Matches < Sports::Butler::SoccerApi::Base
+        def path
+          :matches
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/odds.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Odds < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_match]
+        end
+
+        def path
+          :matches
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/players.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Players < Sports::Butler::SoccerApi::Base
+        def path
+          :players
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/predictions.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Predictions < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_match]
+        end
+
+        def path
+          :predictions
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/scorers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Scorers < Sports::Butler::SoccerApi::Base
+        def path
+          :scorers
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/sidelineds.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Sidelineds < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_player, :by_coach]
+        end
+
+        def path
+          :sidelined
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/standings.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Standings < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_competition]
+        end
+
+        def path
+          :standings
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/statistics.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Statistics < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_match]
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/teams.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Teams < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_id, :by_name]
+        end
+
+        def path
+          :teams
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/timezones.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Timezones < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:all]
+        end
+
+        def path
+          :timezone
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/transfers.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Transfers < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_player, :by_team]
+        end
+
+        def path
+          :transfers
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/trophies.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Trophies < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_player, :by_coach]
+        end
+
+        def path
+          :trophies
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/soccer_api/venues.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'sports/butler/soccer_api/base'
+
+module Sports
+  module Butler
+    module SoccerApi
+      class Venues < Sports::Butler::SoccerApi::Base
+        def available_endpoint_methods
+          [:by_id]
+        end
+
+        def path
+          :venues
+        end
+      end
+    end
+  end
+end

data/lib/sports/butler/utility.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+# requires / includes
+require 'terminal-table'
+require 'term/ansicolor'
+include Term::ANSIColor
+
+module Sports
+  module Butler
+    class Utility
+
+      class << self
+        def endpoints
+          linebreak
+
+          Configuration::AVAILABLE_SPORT_API.each.with_index(1) do |(sport, api_names), idx|
+
+            print white,  "#{idx}. SPORT: #{sport}\n"
+            puts "==============================\n"
+            puts "Endpoints for this Sport:\n\n"
+
+            all_endpoints = "Sports::Butler::#{sport.to_s.capitalize}::ENDPOINTS".constantize
+            all_endpoints.sort.each.with_index(1) do |endpoint, idx_endpoint|
+              row_hash = {}
+              row_hash[:available_endpoint_methods] = []
+              rows_apis = []
+
+              aliases = Sports::Butler::Base::ALIASES.map{ |key, value| key if value == endpoint }.compact
+              print white, "#{idx_endpoint}. #{endpoint} [ Aliases: #{aliases.present? ? aliases.join(', ') : '-'} ]\n"
+
+              # get all methods from all apis
+              api_names.each.with_index(1) do |api_name, _idx_api_name|
+                butler = Sports::Butler.new(sport: sport, api_name: api_name)
+
+                next unless butler.available_endpoints.include?(endpoint.to_s)
+                available_endpoint_methods = butler.send(endpoint).available_endpoint_methods
+
+                row_hash[:available_endpoint_methods] += available_endpoint_methods
+                row_hash[:available_endpoint_methods].uniq!
+
+                rows_apis << api_name
+              end
+
+              rows_meths = []
+              row_hash[:available_endpoint_methods].each.with_index(1) do |available_endpoint_method, idx_available|
+                yes_no = []
+                meth_params = []
+                api_names.each.with_index(1) do |api_name, _idx_api_name|
+                  butler = Sports::Butler.new(sport: sport, api_name: api_name)
+
+                  next unless butler.available_endpoints.include?(endpoint.to_s)
+                  available_endpoint_methods = butler.send(endpoint).available_endpoint_methods
+
+                  res = available_endpoint_methods.include?(available_endpoint_method) ? 'YES' : '-'
+                  yes_no << res
+
+                  if available_endpoint_methods.include?(available_endpoint_method)
+                    params = butler.send(endpoint).method(available_endpoint_method).parameters
+
+                    res = params.present? ? params : 'none'
+                    meth_params << res
+                  else
+                    meth_params << '-'
+                  end
+                end
+
+                rows_meths << [available_endpoint_method] + yes_no
+                rows_meths << [''] + meth_params
+                rows_meths << :separator unless idx_available == row_hash[:available_endpoint_methods].size
+              end
+
+              table = Terminal::Table.new rows: rows_meths
+              table.title = "Endpoint #{endpoint} [#{sport}]"
+              table.headings = ['Method'] + rows_apis
+
+              print magenta, table
+
+              linebreak
+              linebreak
+            end
+            linebreak
+          end
+          linebreak
+
+          true
+        end
+
+        # output
+        def linebreak
+          puts "\n"
+        end
+
+      end
+
+    end
+  end
+end

data/lib/sports/butler/version.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+module Sports
+  module Butler
+    # Initial Release Version:
+    # November 2021
+    #
+    # Supported Sports:
+    # - Football (aka Soccer)
+    # - Basketball
+    #
+    # Supported APIs:
+    # - https://api-football.com (>= 1.0.0)
+    # - https://apifootball.com (>= 1.0.0)
+    # - https://www.football-data.org (>= 1.0.0)
+    # - https://api-basketball.com (>= 1.0.0)
+    VERSION = "1.0.0"
+  end
+end

data/lib/sports/butler.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+require 'httparty'
+
+require "sports/butler/utility"
+require 'sports/butler/api'
+require "sports/butler/version"
+require "sports/butler/configuration"
+require "sports/butler/soccer"
+require "sports/butler/basketball"
+
+module Sports
+  module Butler
+
+    DEFAULT_SPORT = :soccer
+    DEFAULT_API   = :api_football_com
+
+    class << self
+
+      # Sports::Butler Object build
+      def new(sport: DEFAULT_SPORT, api_name: DEFAULT_API)
+        if Sports::Butler::Configuration.valid_sport_api?(sport, api_name)
+          "Sports::Butler::#{sport.to_s.capitalize}".constantize.new(sport: sport, api_name: api_name)
+        else
+          text_error_sport_api
+        end
+      end
+
+      # Sports::Butler direct API call without Endpoint Classes
+      def get(url:, sport: nil, api_name: nil, filters: {}, headers: {})
+        Api.get(url: url, sport: sport, api_name: api_name, filters: filters, headers: headers)
+      end
+
+      # Sports::Butler show all endpoints in console output (info)
+      def show_endpoints
+        Sports::Butler::Utility.endpoints
+      end
+
+      private
+
+      def text_error_sport_api
+        text  = "Invalid sport / api parameter. "
+        text += "Available sports: #{Sports::Butler::Configuration::AVAILABLE_SPORTS.join(', ')}. "
+        text += "Available apis: #{Sports::Butler::Configuration::AVAILABLE_APIS.join(', ')}"
+        text
+      end
+    end
+  end
+end