api-sports 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8234cba5149ee13f90f848f17a3f02d04f503474e24af99879867940da54c77b
+  data.tar.gz: d184b77cb1ab72188b09fa7a03f2fec38242119fe446eeb6b7cb3413a644a547
+SHA512:
+  metadata.gz: 3dfdacbe4e256c46f40f957dadb468b244b98b69a6068e268f55eea0dc1f4df2890675b53055bb8411911a3c89d01a89445473178019de54aaee9218384e9124
+  data.tar.gz: 8d1ed792973e3f033fcde3e52de09967b7905931ee2fe0fffb87348cac689c3392310c9b4e61e67b4efba9247d9058e1f43b06aa815442136bb8f09b6596d078

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,236 @@
+AllCops:
+  TargetRubyVersion: 2.7
+  # RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
+  # to ignore them, so only the ones explicitly set in this file are enabled.
+  DisabledByDefault: true
+  SuggestExtensions: false
+
+# Prefer &&/|| over and/or.
+Style/AndOr:
+  Enabled: true
+
+# Align `when` with `case`.
+Layout/CaseIndentation:
+  Enabled: true
+
+Layout/ClosingHeredocIndentation:
+  Enabled: true
+
+Layout/ClosingParenthesisIndentation:
+  Enabled: true
+
+# Align comments with method definitions.
+Layout/CommentIndentation:
+  Enabled: true
+
+Layout/ElseAlignment:
+  Enabled: true
+
+# Align `end` with the matching keyword or starting expression except for
+# assignments, where it should be aligned with the LHS.
+Layout/EndAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: variable
+  AutoCorrect: true
+
+Layout/EndOfLine:
+  Enabled: true
+
+Layout/EmptyLineAfterMagicComment:
+  Enabled: true
+
+Layout/EmptyLinesAroundAccessModifier:
+  Enabled: true
+  EnforcedStyle: only_before
+
+Layout/EmptyLinesAroundBlockBody:
+  Enabled: true
+
+# In a regular class definition, no empty lines around the body.
+Layout/EmptyLinesAroundClassBody:
+  Enabled: true
+
+# In a regular method definition, no empty lines around the body.
+Layout/EmptyLinesAroundMethodBody:
+  Enabled: true
+
+# In a regular module definition, no empty lines around the body.
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: true
+
+# Use Ruby >= 1.9 syntax for hashes. Prefer { a: :b } over { :a => :b }.
+Style/HashSyntax:
+  Enabled: true
+
+# Method definitions after `private` or `protected` isolated calls need one
+# extra level of indentation.
+Layout/IndentationConsistency:
+  Enabled: true
+  EnforcedStyle: indented_internal_methods
+
+# Two spaces, no tabs (for indentation).
+Layout/IndentationWidth:
+  Enabled: true
+
+Layout/LeadingCommentSpace:
+  Enabled: true
+
+Layout/SpaceAfterColon:
+  Enabled: true
+
+Layout/SpaceAfterComma:
+  Enabled: true
+
+Layout/SpaceAfterSemicolon:
+  Enabled: true
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  Enabled: true
+
+Layout/SpaceAroundKeyword:
+  Enabled: true
+
+Layout/SpaceAroundOperators:
+  Enabled: true
+
+Layout/SpaceBeforeComma:
+  Enabled: true
+
+Layout/SpaceBeforeComment:
+  Enabled: true
+
+Layout/SpaceBeforeFirstArg:
+  Enabled: true
+
+Style/DefWithParentheses:
+  Enabled: true
+
+# Defining a method with parameters needs parentheses.
+Style/MethodDefParentheses:
+  Enabled: true
+
+Style/ExplicitBlockArgument:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Style/MapToHash:
+  Enabled: true
+
+Style/RedundantFreeze:
+  Enabled: true
+
+# Use `foo {}` not `foo{}`.
+Layout/SpaceBeforeBlockBraces:
+  Enabled: true
+
+# Use `foo { bar }` not `foo {bar}`.
+Layout/SpaceInsideBlockBraces:
+  Enabled: true
+  EnforcedStyleForEmptyBraces: space
+
+# Use `{ a: 1 }` not `{a:1}`.
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: true
+
+Layout/SpaceInsideParens:
+  Enabled: true
+
+# Check quotes usage according to lint rule below.
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+# Detect hard tabs, no hard tabs.
+Layout/IndentationStyle:
+  Enabled: true
+
+# Empty lines should not have any spaces.
+Layout/TrailingEmptyLines:
+  Enabled: true
+
+# No trailing whitespace.
+Layout/TrailingWhitespace:
+  Enabled: true
+
+# Use quotes for string literals when they are enough.
+Style/RedundantPercentQ:
+  Enabled: true
+
+Lint/AmbiguousOperator:
+  Enabled: true
+
+Lint/AmbiguousRegexpLiteral:
+  Enabled: true
+
+Lint/DuplicateRequire:
+  Enabled: true
+
+Lint/DuplicateMagicComment:
+  Enabled: true
+
+Lint/DuplicateMethods:
+  Enabled: true
+
+Lint/ErbNewArguments:
+  Enabled: true
+
+Lint/EnsureReturn:
+  Enabled: true
+
+# Use my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
+Lint/RequireParentheses:
+  Enabled: true
+
+Lint/RedundantStringCoercion:
+  Enabled: true
+
+Lint/UriEscapeUnescape:
+  Enabled: true
+
+Lint/UselessAssignment:
+  Enabled: true
+
+Lint/DeprecatedClassMethods:
+  Enabled: true
+
+Style/EvalWithLocation:
+  Enabled: true
+  Exclude:
+    - "**/test/**/*"
+
+Style/ParenthesesAroundCondition:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Style/RedundantBegin:
+  Enabled: true
+
+Style/RedundantReturn:
+  Enabled: true
+  AllowMultipleReturnValues: true
+
+Style/RedundantRegexpEscape:
+  Enabled: true
+
+Style/Semicolon:
+  Enabled: true
+  AllowAsExpressionSeparator: true
+
+# Prefer Foo.method over Foo::method
+Style/ColonMethodCall:
+  Enabled: true
+
+Style/TrivialAccessors:
+  Enabled: true
+
+# Prefer a = b || c over a = b ? b : c
+Style/RedundantCondition:
+  Enabled: true

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in api_sports.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "rspec", "~> 3.0"
+
+gem "rubocop", "~> 1.21"

data/Gemfile.lock

@@ -0,0 +1,63 @@
+PATH
+  remote: .
+  specs:
+    api_sports (0.1.0)
+      faraday (~> 2.7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    diff-lcs (1.5.0)
+    faraday (2.7.4)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-net_http (3.0.2)
+    json (2.6.3)
+    parallel (1.22.1)
+    parser (3.2.1.1)
+      ast (~> 2.4.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.7.0)
+    rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.1)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.48.1)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.26.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.27.0)
+      parser (>= 3.2.1.0)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    unicode-display_width (2.4.2)
+
+PLATFORMS
+  x86_64-darwin-22
+
+DEPENDENCIES
+  api_sports!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.21)
+
+BUNDLED WITH
+   2.4.5

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2023] [Bryan Byrne]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,65 @@
+# ApiSports API Rubygem [BETA]
+
+An unofficial ruby gem to integrate [API-Sports](https://api-sports.io/#) sports data into your app.
+
+[API-Sports](https://api-sports.io/) provides sports data APIs. This gem is an unofficial wrapper providing lightweight integration of sports data into an application or service. This library does not attempt to support all API capabilities but instead focuses on the most used endpoints (e.g. retrieving game data). Coverage summary:
+
+| Sport                   | API-Sports Documentation                                                 | Library Support    |
+| :---------------------- | :----------------------------------------------------------------------- | :----------------- |
+| Football/Soccer         | [API-Football Docs](https://api-sports.io/documentation/football/v3)     | :white_check_mark: |
+| Basketball              | [API-Basketball Docs](https://api-sports.io/documentation/basketball/v1) | :construction:     |
+| American Football (NFL) | [API-NFL Docs](https://api-sports.io/documentation/nfl/v1)               | :construction:     |
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add api-sports
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install api-sports
+
+## Usage
+
+**Prerequisite:** Set an environment variable `API_SPORTS_KEY` that contains the API key provided by [API-Sports](https://api-sports.io).
+
+```ruby
+client = ApiSports::Client.new(api_key: ENV["API_SPORTS_KEY"])
+
+# client has a reference to instances of resource objects corresponding API endpoints
+# e.g. client.leagues will access `/leagues` endpoint data.
+# e.g. client.fixtures will access `/fixtures` endpoint data.
+# etc.
+# Parameters can be passed as needed to respective methods.
+fixtures = client.fixtures.list(
+  league: 39, # Premier League
+  season: 2022,
+  date: "2022-09-03",
+  status: "FT"
+)
+
+# Additional resources (e.g. `/fixtures/lineups`) can be accessed
+# by chaining the method calls. For clarify required parameters have been
+# identified and made required paremeters when possible (additional parameters may be passed also)
+fixtures = client.fixtures.head_to_head(first_team_id: 33, second_team_id: 34)
+
+# Responses will include pagination information included in `paging` attribute of API responses
+fixtures.total
+fixtures.current_page
+fixtures.total_pages
+```
+
+## Acknowledgements
+
+Hat tip to [tolbkni](vultr.rb) and [GoRails](https://gorails.com/episodes/api-requests-with-faraday) for inspiration on how to structure this library.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/irishbryan/api_sports.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/api_sports/client.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Client
+    BASE_URL = "https://v3.football.api-sports.io/"
+
+    attr_reader :api_key, :adapter
+
+    def initialize(api_key:, adapter: Faraday.default_adapter, stubs: nil)
+      @api_key = api_key
+      @adapter = adapter
+
+      # Test stubs for requests
+      @stubs = stubs
+    end
+
+    def countries
+      CountriesResource.new(self)
+    end
+
+    def timezones
+      TimezonesResource.new(self)
+    end
+
+    def leagues
+      LeaguesResource.new(self)
+    end
+
+    def seasons
+      SeasonsResource.new(self)
+    end
+
+    def teams
+      TeamsResource.new(self)
+    end
+
+    def venues
+      VenuesResource.new(self)
+    end
+
+    def standings
+      StandingsResource.new(self)
+    end
+
+    def fixtures
+      FixturesResource.new(self)
+    end
+
+    def predictions
+      PredictionsResource.new(self)
+    end
+
+    def odds
+      OddsResource.new(self)
+    end
+
+    def connection
+      @connection ||= Faraday.new(BASE_URL) do |conn|
+        conn.headers = { "x-apisports-key": api_key }
+        conn.response :json, content_type: "application/json"
+        conn.adapter adapter, @stubs
+      end
+    end
+  end
+end

data/lib/api_sports/collection.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Collection
+    attr_reader :data, :total, :current_page, :total_pages
+
+    def self.from_response(response, type:, &block)
+      body = response.body
+      new(
+        data: block.nil? ? body["response"].map { |attrs| type.new(attrs) } : yield(body),
+        total: body["results"],
+        current_page: body["paging"]["current"],
+        total_pages: body["paging"]["total"]
+      )
+    end
+
+    def initialize(data:, total:, current_page:, total_pages:)
+      @data = data
+      @total = total
+      @current_page = current_page
+      @total_pages = total_pages
+    end
+  end
+end

data/lib/api_sports/error.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Error < StandardError
+  end
+end

data/lib/api_sports/object.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module ApiSports
+  # Class to make access to response data easier
+  # e.g. response.name instead of response['name']
+  # Inspired by https://github.com/tolbkni/vultr.rb
+  # and https://gorails.com/episodes/api-requests-with-faraday
+
+  class Object < OpenStruct
+    def initialize(attributes)
+      super to_ostruct(attributes)
+    end
+
+    def to_ostruct(obj)
+      if obj.is_a?(Hash)
+        OpenStruct.new(obj.transform_values { | value | to_ostruct(value) })
+      elsif obj.is_a?(Array)
+        obj.map { |o| to_ostruct(o) }
+      else
+        obj # Assumed to be primitive type
+      end
+    end
+  end
+end

data/lib/api_sports/objects/bet.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Bet < Object
+  end
+end

data/lib/api_sports/objects/bookmaker.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Bookmaker < Object
+  end
+end

data/lib/api_sports/objects/country.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Country < Object
+  end
+end

data/lib/api_sports/objects/event.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Event < Object
+  end
+end

data/lib/api_sports/objects/fixture.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Fixture < Object
+  end
+end

data/lib/api_sports/objects/fixture_round.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class FixtureRound < Object
+    def initialize(name)
+      super({ name: name })
+    end
+  end
+end

data/lib/api_sports/objects/league.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class League < Object
+  end
+end

data/lib/api_sports/objects/lineup.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Lineup < Object
+  end
+end

data/lib/api_sports/objects/odds.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Odds < Object
+  end
+end

data/lib/api_sports/objects/player.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Player < Object
+  end
+end

data/lib/api_sports/objects/prediction.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Prediction < Object
+  end
+end

data/lib/api_sports/objects/season.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Season < Object
+    def initialize(year)
+      super({ year: year })
+    end
+  end
+end

data/lib/api_sports/objects/standing.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Standing < Object
+  end
+end

data/lib/api_sports/objects/statistics.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Statistics < Object
+  end
+end

data/lib/api_sports/objects/team.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Team < Object
+  end
+end

data/lib/api_sports/objects/timezone.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Timezone < Object
+    def initialize(name)
+      super({ name: name })
+    end
+  end
+end

data/lib/api_sports/objects/venue.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Venue < Object
+  end
+end

data/lib/api_sports/resource.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class Resource
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def get_request(url, params: {}, headers: {})
+      handle_response client.connection.get(url, params, headers)
+    end
+
+    def get_single_resource(url, params: {}, headers: {}, &dig_block)
+      response = get_request(url, params: params, headers: headers)
+      yield(response)
+    end
+
+    def handle_response(response)
+      errors = response.body["errors"]
+
+      if errors.empty?
+        response
+      else
+        raise Error, errors
+      end
+    end
+  end
+end

data/lib/api_sports/resources/countries.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class CountriesResource < Resource
+    def list(**params)
+      response = get_request("countries", params: params)
+      Collection.from_response(response, type: Country)
+    end
+  end
+end

data/lib/api_sports/resources/fixtures.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class FixturesResource < Resource
+    def list(**params)
+      response = get_request("fixtures", params: params)
+      Collection.from_response(response, type: Fixture)
+    end
+
+    def rounds(league_id:, season_id:, current_round_only: false)
+      response = get_request("fixtures/rounds",
+                             params: { league: league_id,
+                                       season: season_id,
+                                       current: current_round_only }.compact)
+      Collection.from_response(response, type: FixtureRound)
+    end
+
+    def head_to_head(first_team_id:, second_team_id:, **params)
+      response = get_request("fixtures/headtohead", params: { h2h: "#{first_team_id}-#{second_team_id}" }.merge(params))
+      Collection.from_response(response, type: Fixture)
+    end
+
+    def statistics(fixture_id:, **params)
+      response = get_request("fixtures/statistics", params: { fixture: fixture_id }.merge(params))
+      Collection.from_response(response, type: Statistics)
+    end
+
+    def events(fixture_id:, **params)
+      response = get_request("fixtures/events", params: { fixture: fixture_id }.merge(params))
+      Collection.from_response(response, type: Event)
+    end
+
+    def lineups(fixture_id:, **params)
+      response = get_request("fixtures/lineups", params: { fixture: fixture_id }.merge(params))
+      Collection.from_response(response, type: Lineup)
+    end
+
+    def player_statistics(fixture_id:, **params)
+      response = get_request("fixtures/players", params: { fixture: fixture_id }.merge(params))
+      Collection.from_response(response, type: Player)
+    end
+  end
+end

data/lib/api_sports/resources/leagues.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class LeaguesResource < Resource
+    def list(**params)
+      response = get_request("leagues", params: params)
+      Collection.from_response(response, type: League)
+    end
+
+    def retrieve(league_id:)
+      response = get_single_resource("leagues", params: { id: league_id }) do |r|
+        r.body["response"].first.dig("league")
+      end
+      League.new(response)
+    end
+
+    def seasons
+      response = get_request("leagues/seasons")
+      Collection.from_response(response, type: Season)
+    end
+
+  end
+end

data/lib/api_sports/resources/odds.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class OddsResource < Resource
+    def pre_match_odds(fixture_id:, bookmaker_id: nil, **params)
+      response = get_request("odds",
+                             params: { fixture: fixture_id,
+                                       bookmaker: bookmaker_id }.compact.merge(params))
+      Collection.from_response(response, type: Odds)
+    end
+
+    def mapping(**params)
+      response = get_request("odds/mapping", params: params)
+      Collection.from_response(response, type: Fixture)
+    end
+
+    def bookmakers
+      response = get_request("odds/bookmakers")
+      Collection.from_response(response, type: Bookmaker)
+    end
+
+    def pre_match_bets
+      response = get_request("odds/bets")
+      Collection.from_response(response, type: Bet)
+    end
+
+    def live_odds(fixture_id:, bookmaker_id: nil, **params)
+      response = get_request("odds/live",
+                             params: { fixture: fixture_id,
+                                       bookmaker: bookmaker_id }.compact.merge(params))
+      Collection.from_response(response, type: Odds)
+    end
+
+    def live_bets
+      response = get_request("odds/live/bets")
+      Collection.from_response(response, type: Bet)
+    end
+  end
+end

data/lib/api_sports/resources/standings.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class StandingsResource < Resource
+    def retrieve(league_id:, season_id: nil, team_id: nil)
+      response = get_request("standings",
+                             params: { league: league_id,
+                                       season: season_id,
+                                       team: team_id }.compact)
+      Collection.from_response(response, type: Standing) do |body|
+        body["response"].first["league"]["standings"].first.map { |attrs| Standing.new(attrs) }
+      end
+    end
+  end
+end

data/lib/api_sports/resources/teams.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class TeamsResource < Resource
+    def list(**params)
+      response = get_request("teams", params: params)
+      Collection.from_response(response, type: Team)
+    end
+
+    def retrieve(team_id:)
+      response = get_single_resource("teams", params: { id: team_id }) do |r|
+        r.body["response"].first.dig("team")
+      end
+      Team.new(response)
+    end
+
+    def statistics(league_id:, season_id:, team_id:)
+      response = get_request("teams/statistics", params: { team: team_id, league: league_id, season: season_id })
+      Statistics.new(response.body["response"])
+    end
+
+    def seasons(team_id:)
+      response = get_request("teams/seasons", params: { team: team_id })
+      Collection.from_response(response, type: Season)
+    end
+  end
+end

data/lib/api_sports/resources/timezones.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class TimezonesResource < Resource
+    def list(**params)
+      response = get_request("timezone", params: params)
+      Collection.from_response(response, type: Timezone)
+    end
+  end
+end

data/lib/api_sports/resources/venues.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ApiSports
+  class VenuesResource < Resource
+    def retrieve(**params)
+      response = get_single_resource("venues", params: params) do |r|
+        r.body["response"].first
+      end
+      Venue.new(response)
+    end
+  end
+end

data/lib/api_sports/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ApiSports
+  VERSION = "0.1.0"
+end

data/lib/api_sports.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "faraday"
+require_relative "api_sports/version"
+
+module ApiSports
+  autoload :Client, "api_sports/client"
+  autoload :Object, "api_sports/object"
+  autoload :Collection, "api_sports/collection"
+  autoload :Error, "api_sports/error"
+  autoload :Resource, "api_sports/resource"
+
+  # Classes used to return a nicer object wrapping the response data
+  autoload :Country, "api_sports/objects/country"
+  autoload :Timezone, "api_sports/objects/timezone"
+  autoload :League, "api_sports/objects/league"
+  autoload :Season, "api_sports/objects/season"
+  autoload :Team, "api_sports/objects/team"
+  autoload :Venue, "api_sports/objects/venue"
+  autoload :Statistics, "api_sports/objects/statistics"
+  autoload :Standing, "api_sports/objects/standing"
+  autoload :Fixture, "api_sports/objects/fixture"
+  autoload :Event, "api_sports/objects/event"
+  autoload :Lineup, "api_sports/objects/lineup"
+  autoload :Player, "api_sports/objects/player"
+  autoload :FixtureRound, "api_sports/objects/fixture_round"
+  autoload :Prediction, "api_sports/objects/prediction"
+  autoload :Bookmaker, "api_sports/objects/bookmaker"
+  autoload :Odds, "api_sports/objects/odds"
+  autoload :Bet, "api_sports/objects/bet"
+
+  # Category of API calls
+  autoload :CountriesResource, "api_sports/resources/countries"
+  autoload :TimezonesResource, "api_sports/resources/timezones"
+  autoload :LeaguesResource, "api_sports/resources/leagues"
+  autoload :SeasonsResource, "api_sports/resources/seasons"
+  autoload :TeamsResource, "api_sports/resources/teams"
+  autoload :VenuesResource, "api_sports/resources/venues"
+  autoload :StandingsResource, "api_sports/resources/standings"
+  autoload :FixturesResource, "api_sports/resources/fixtures"
+  autoload :PredictionsResource, "api_sports/resources/predictions"
+  autoload :OddsResource, "api_sports/resources/odds"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: api-sports
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- irishbryan
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-03-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+description:
+email:
+- bbyrne@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/api_sports.rb
+- lib/api_sports/client.rb
+- lib/api_sports/collection.rb
+- lib/api_sports/error.rb
+- lib/api_sports/object.rb
+- lib/api_sports/objects/bet.rb
+- lib/api_sports/objects/bookmaker.rb
+- lib/api_sports/objects/country.rb
+- lib/api_sports/objects/event.rb
+- lib/api_sports/objects/fixture.rb
+- lib/api_sports/objects/fixture_round.rb
+- lib/api_sports/objects/league.rb
+- lib/api_sports/objects/lineup.rb
+- lib/api_sports/objects/odds.rb
+- lib/api_sports/objects/player.rb
+- lib/api_sports/objects/prediction.rb
+- lib/api_sports/objects/season.rb
+- lib/api_sports/objects/standing.rb
+- lib/api_sports/objects/statistics.rb
+- lib/api_sports/objects/team.rb
+- lib/api_sports/objects/timezone.rb
+- lib/api_sports/objects/venue.rb
+- lib/api_sports/resource.rb
+- lib/api_sports/resources/countries.rb
+- lib/api_sports/resources/fixtures.rb
+- lib/api_sports/resources/leagues.rb
+- lib/api_sports/resources/odds.rb
+- lib/api_sports/resources/standings.rb
+- lib/api_sports/resources/teams.rb
+- lib/api_sports/resources/timezones.rb
+- lib/api_sports/resources/venues.rb
+- lib/api_sports/version.rb
+homepage: https://github.com/irishbryan/api-sports
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/irishbryan/api-sports
+  source_code_uri: https://github.com/irishbryan/api-sports
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Ruby bindings for the api-sports.io API (Unofficial)
+test_files: []