mlb 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e82207f5345873c47ef01b18d32ed5dc131a7a2a2531b5c5adf2ca87e2c5d397
-  data.tar.gz: 597c40742c137216cc3210362b9a157dc28ef25cd5dacff689489821323cb804
+  metadata.gz: 7cffb04037de85352415288a1c8756fb223d79181b7051322fa671e60a264580
+  data.tar.gz: 141e7eb182d2130fb4906aa9a6d93fdd640562f432004b29ecca505a8c96dd5d
 SHA512:
-  metadata.gz: c9e096ebd1e2a1d88d618507c8e3d15b540f06c146b29c3dff1abe2dbf581521858fbf1b6362ad251c241db89330f3d2c4d6fb94753d8236056b5ec2910bfb69
-  data.tar.gz: e962f38e4fc333cafb5618ab1c5bdf66e53aed74b12a2e8be708877a2a8100af96410bfd8e196ce51ad4570490da98c4ade2eaefee845c9cf9230dacb2a7f5a2
+  metadata.gz: 98a59eca40923bdeaecb637dbf863282fe9958c554afe15a3e75964745129aec710bcb24c8e2eeacc709190f37ac3a97bc76babc9531432e589985222ab3bfaf
+  data.tar.gz: ba7675aab23a6167c94adcb9b554b9f5b1645182d452152a690a1904af9a2af58fb9aec19624e671b3fc14cc23a4ae4ad57e2f366fa4b795905b491733e09775

data/CHANGELOG.md

@@ -1,2 +1,11 @@
-## [0.8.0] - 2024-05-02
+## [0.10.0] - 2025-04-30
+* Drop support for Ruby 3.1
+* Add equalizer for object identity
+* Add Seasons, Conferences, and Awards
+* Add Players.find and Players.find_all
+
+## [0.9.0] - 2024-05-22
+* Rewrite to use MLB Stats API
+
+## [0.8.0] - 2024-05-06
 * Rewrite

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020-2024 Erik Berlin, Nilesh Trivedi
+Copyright (c) 2020-2025 Erik Berlin, Nilesh Trivedi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,14 +1,15 @@
 [![Tests](https://github.com/sferik/mlb-ruby/actions/workflows/test.yml/badge.svg)](https://github.com/sferik/mlb-ruby/actions/workflows/test.yml)
-[![Linter](https://github.com/sferik/mlb-ruby/actions/workflows/lint.yml/badge.svg)](https://github.com/sferik/mlb-ruby/actions/workflows/lint.yml)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/fc32f80cb778b773a5b2/test_coverage)](https://codeclimate.com/github/sferik/mlb-ruby/test_coverage)
 [![Mutant](https://github.com/sferik/mlb-ruby/actions/workflows/mutant.yml/badge.svg)](https://github.com/sferik/mlb-ruby/actions/workflows/mutant.yml)
-[![Typer Checker](https://github.com/sferik/mlb-ruby/actions/workflows/steep.yml/badge.svg)](https://github.com/sferik/mlb-ruby/actions/workflows/steep.yml)
+[![Linter](https://github.com/sferik/mlb-ruby/actions/workflows/lint.yml/badge.svg)](https://github.com/sferik/mlb-ruby/actions/workflows/lint.yml)
+[![Maintainability](https://api.codeclimate.com/v1/badges/fc32f80cb778b773a5b2/maintainability)](https://codeclimate.com/github/sferik/mlb-ruby/maintainability)
 [![Gem Version](https://badge.fury.io/rb/mlb.svg)](https://rubygems.org/gems/mlb)
 
-# A [Ruby](https://www.ruby-lang.org) interface to the [MLB Data API](https://appac.github.io/mlb-data-api-docs/)
+# A [Ruby](https://www.ruby-lang.org) interface to the [MLB Stats API](https://statsapi.mlb.com)
 
 ## Follow
 
-For updates and announcements, follow [@sferik](https://x.com/sferik) on X.
+For updates and announcements, follow [@sferik](https://x.com/sferik).
 
 ## Installation
 
@@ -25,33 +26,34 @@ Or, if Bundler is not being used to manage dependencies:
 ```ruby
 require "mlb"
 
-dbacks = MLB::Team.all(season: 2024).first
-dbacks.name_display_full       # => "Arizona Diamondbacks"
-dbacks.name_display_brief      # => "D-backs"
-dbacks.name_abbrev             # => "AZ"
-dbacks.city                    # => "Phoenix"
-dbacks.league_full             # => "National League"
-dbacks.league_abbrev           # => "NL"
-dbacks.spring_league_full      # => "Cactus League"
-dbacks.spring_league_abbrev    # => "CL"
-dbacks.division_full           # => "National League West"
-dbacks.division_abbrev         # => "NLW"
-dbacks.first_year_of_play      # => "1996"
-dbacks.venue_name              # => "Chase Field"
-
-blaze = dbacks.roster.first
-blaze.name_display_first_last  # => "Blaze Alexander"
-blaze.jersey_number            # => "9"
-blaze.primary_position         # => "6"
-blaze.position_txt             # => "SS"
-blaze.height_feet              # => "5"
-blaze.height_inches            # => "11"
-blaze.weight                   # => "160"
-blaze.bats                     # => "R"
-blaze.throws                   # => "R"
-blaze.birth_date               # => "1999-06-11T00:00:00"
-blaze.start_date               # => "2022-11-15T00:00:00"
-blaze.pro_debut_date           # => "2024-03-28T00:00:00"
+mets = MLB::Teams.all(season: 2024).last
+mets.name                   # => "New York Mets"
+mets.short_name             # => "NY Mets"
+mets.abbreviation           # => "NYM"
+mets.league.name            # => "National League"
+mets.spring_league.name     # => "Grapefruit League"
+mets.division.name          # => "National League East"
+mets.first_year_of_play     # => 1962
+mets.location_name          # => "Flushing"
+mets.venue.name             # => "Citi Field"
+
+adam = MLB::Players.find(mets.roster.first.player)
+
+adam.full_name              # => "Adam Ottavino"
+adam.primary_number         # => 0
+adam.primary_position.name  # => "Pitcher"
+adam.pitch_hand.description # => "Right"
+adam.bat_side.description   # => "Switch"
+adam.current_age            # => 38
+adam.birth_date.to_s        # => "1985-11-22"
+adam.birth_city             # => "New York"
+adam.birth_state_province   # => "NY"
+adam.birth_country          # => "USA"
+adam.draft_year             # => 2006
+adam.mlb_debut_date.to_s    # => "2010-05-29"
+adam.height                 # => "6' 5\""
+adam.weight                 # => 246
+adam.active?                # => true
 ```
 
 ## Sponsorship
@@ -68,6 +70,82 @@ Building and maintaining an open-source project like this takes a considerable a
 
 [Click here to sponsor this project.](https://github.com/sponsors/sferik)
 
+## TODO
+
+Many of the MLB Stats API endpoints have not yet been implemented in this library. You can contribute to this library by implementing one or more of these endpoinds. If you are financially unable to sponsor this project, you can contribute code instead.
+
+- [ ] /attendance
+- [ ] /baseballStats
+- [ ] /draft{prospects}{year}{latest}
+- [ ] /eventTypes
+- [ ] /game/changes
+- [ ] /game/{gamePk}/boxscore
+- [ ] /game/{gamePk}/content
+- [ ] /game/{gamePk}/contextMetrics
+- [ ] /game/{gamePk}/feed/color
+- [ ] /game/{gamePk}/feed/color/diffPatch
+- [ ] /game/{gamePk}/feed/color/timestamps
+- [ ] /game/{gamePk}/feed/live
+- [ ] /game/{gamePk}/feed/live/diffPatch
+- [ ] /game/{gamePk}/feed/live/timestamps
+- [ ] /game/{gamePk}/linescore
+- [ ] /game/{gamePk}/playByPlay
+- [ ] /game/{gamePk}/winProbability
+- [ ] /gamePace
+- [ ] /gameStatus
+- [ ] /gameTypes
+- [ ] /highLow/{orgType}
+- [ ] /hitTrajectories
+- [ ] /homeRunDerby/{gamePk}{bracket}{pool}
+- [ ] /jobTypes
+- [ ] /jobs
+- [ ] /jobs/datacasters
+- [ ] /jobs/officialScorers
+- [ ] /jobs/umpires
+- [ ] /jobs/umpires/games/{umpireId}
+- [ ] /languages
+- [ ] /league/{leagueId}/allStarBallot
+- [ ] /league/{leagueId}/allStarFinalVote
+- [ ] /league/{leagueId}/allStarWriteIns
+- [ ] /leagueLeaderTypes
+- [ ] /logicalEvents
+- [ ] /metrics
+- [ ] /people/changes
+- [ ] /people/freeAgents
+- [ ] /people/{personId}
+- [ ] /people/{personId}/stats/game/{gamePk}
+- [ ] /pitchCodes
+- [ ] /pitchTypes
+- [ ] /platforms
+- [ ] /positions
+- [ ] /reviewReasons
+- [ ] /rosterTypes
+- [ ] /schedule
+- [ ] /schedule/games/tied
+- [ ] /schedule/postseason
+- [ ] /schedule/postseason/series
+- [ ] /schedule/postseason/tuneIn
+- [ ] /scheduleEventTypes
+- [ ] /situationCodes
+- [ ] /sky
+- [ ] /standings
+- [ ] /standingsTypes
+- [ ] /statGroups
+- [ ] /statTypes
+- [ ] /stats
+- [ ] /stats/leaders
+- [ ] /stats/streaks
+- [ ] /teams/affiliates
+- [ ] /teams/history
+- [ ] /teams/stats
+- [ ] /teams/{teamId}/alumni
+- [ ] /teams/{teamId}/coaches
+- [ ] /teams/{teamId}/leaders
+- [ ] /teams/{teamId}/personnel
+- [ ] /teams/{teamId}/roster
+- [ ] /teams/{teamId}/stats
+- [ ] /windDirection
+
 ## Development
 
 1. Checkout and repo:
@@ -112,10 +190,6 @@ Pull requests will only be accepted if they meet all the following criteria:
 
        bundle exec rake mutant
 
-5. RBS type signatures (in `sig/mlb.rbs`). This can be verified with:
-
-       bundle exec rake steep
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/mlb/award.rb

@@ -0,0 +1,48 @@
+require "equalizer"
+require "shale"
+require "uri"
+require_relative "league"
+require_relative "sport"
+require_relative "player"
+
+module MLB
+  class Award < Shale::Mapper
+    include Comparable
+    include Equalizer.new(:id, :player, :season)
+
+    attribute :id, Shale::Type::String
+    attribute :name, Shale::Type::String
+    attribute :notes, Shale::Type::String
+    attribute :votes, Shale::Type::Integer
+    attribute :date, Shale::Type::Date
+    attribute :season, Shale::Type::Integer
+    attribute :sport, Sport
+    attribute :player, Player
+    attribute :league, League
+    attribute :sort_order, Shale::Type::Integer
+
+    json do
+      map "id", to: :id
+      map "name", to: :name
+      map "sport", to: :sport
+      map "league", to: :league
+      map "player", to: :player
+      map "sortOrder", to: :sort_order
+      map "season", to: :season
+      map "notes", to: :notes
+      map "votes", to: :votes
+    end
+
+    def <=>(other)
+      sort_order <=> other.sort_order
+    end
+
+    def recipients(season: Time.now.year)
+      params = {season:}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("awards/#{id}/recipients?#{query_string}")
+      awards = Awards.from_json(response)
+      awards.awards
+    end
+  end
+end

data/lib/mlb/awards.rb

@@ -0,0 +1,22 @@
+require "shale"
+require_relative "award"
+
+module MLB
+  class Awards < Shale::Mapper
+    attribute :copyright, Shale::Type::String
+    attribute :awards, Award, collection: true
+
+    def self.all
+      response = CLIENT.get("awards")
+      awards = from_json(response)
+      awards.awards.sort!
+    end
+
+    def self.find(award)
+      id = award.respond_to?(:id) ? award.id : award
+      response = CLIENT.get("awards")
+      awards = from_json(response)
+      awards.awards.find { |a| a.id.eql?(id) }
+    end
+  end
+end

data/lib/mlb/client.rb

@@ -2,17 +2,15 @@ require "forwardable"
 require_relative "connection"
 require_relative "redirect_handler"
 require_relative "request_builder"
-require_relative "response_parser"
+require_relative "error_handler"
 
 module MLB
   class Client
     extend Forwardable
 
-    DEFAULT_BASE_URL = "https://lookup-service-prod.mlb.com/json/".freeze
-    DEFAULT_ARRAY_CLASS = Array
-    DEFAULT_OBJECT_CLASS = Hash
+    DEFAULT_BASE_URL = "https://statsapi.mlb.com/api/v1/".freeze
 
-    attr_accessor :base_url, :default_array_class, :default_object_class
+    attr_accessor :base_url
 
     def_delegators :@connection, :open_timeout, :read_timeout, :write_timeout, :proxy_url, :debug_output
     def_delegators :@connection, :open_timeout=, :read_timeout=, :write_timeout=, :proxy_url=, :debug_output=
@@ -25,47 +23,38 @@ module MLB
       write_timeout: Connection::DEFAULT_WRITE_TIMEOUT,
       debug_output: Connection::DEFAULT_DEBUG_OUTPUT,
       proxy_url: nil,
-      default_array_class: DEFAULT_ARRAY_CLASS,
-      default_object_class: DEFAULT_OBJECT_CLASS,
       max_redirects: RedirectHandler::DEFAULT_MAX_REDIRECTS)
-
       @base_url = base_url
-      initialize_default_classes(default_array_class, default_object_class)
       @connection = Connection.new(open_timeout:, read_timeout:, write_timeout:, debug_output:, proxy_url:)
       @request_builder = RequestBuilder.new
       @redirect_handler = RedirectHandler.new(connection: @connection, request_builder: @request_builder, max_redirects:)
-      @response_parser = ResponseParser.new
+      @error_handler = ErrorHandler.new
     end
 
-    def get(endpoint, headers: {}, array_class: default_array_class, object_class: default_object_class)
-      execute_request(:get, endpoint, headers:, array_class:, object_class:)
+    def get(endpoint, headers: {})
+      execute_request(:get, endpoint, headers:)
     end
 
-    def post(endpoint, body = nil, headers: {}, array_class: default_array_class, object_class: default_object_class)
-      execute_request(:post, endpoint, body:, headers:, array_class:, object_class:)
+    def post(endpoint, body = nil, headers: {})
+      execute_request(:post, endpoint, body:, headers:)
     end
 
-    def put(endpoint, body = nil, headers: {}, array_class: default_array_class, object_class: default_object_class)
-      execute_request(:put, endpoint, body:, headers:, array_class:, object_class:)
+    def put(endpoint, body = nil, headers: {})
+      execute_request(:put, endpoint, body:, headers:)
     end
 
-    def delete(endpoint, headers: {}, array_class: default_array_class, object_class: default_object_class)
-      execute_request(:delete, endpoint, headers:, array_class:, object_class:)
+    def delete(endpoint, headers: {})
+      execute_request(:delete, endpoint, headers:)
     end
 
     private
 
-    def initialize_default_classes(default_array_class, default_object_class)
-      @default_array_class = default_array_class
-      @default_object_class = default_object_class
-    end
-
-    def execute_request(http_method, endpoint, body: nil, headers: {}, array_class: default_array_class, object_class: default_object_class)
+    def execute_request(http_method, endpoint, headers:, body: nil)
       uri = URI.join(base_url, endpoint)
       request = @request_builder.build(http_method:, uri:, body:, headers:)
       response = @connection.perform(request:)
       response = @redirect_handler.handle(response:, request:, base_url:)
-      @response_parser.parse(response:, array_class:, object_class:)
+      @error_handler.handle(response:)
     end
   end
 

data/lib/mlb/conference.rb

@@ -0,0 +1,32 @@
+require "equalizer"
+require "shale"
+require_relative "league"
+require_relative "sport"
+
+module MLB
+  class Conference < Shale::Mapper
+    include Equalizer.new(:id)
+
+    attribute :id, Shale::Type::Integer
+    attribute :name, Shale::Type::String
+    attribute :link, Shale::Type::String
+    attribute :abbreviation, Shale::Type::String
+    attribute :has_wildcard, Shale::Type::Boolean
+    attribute :league, League
+    attribute :sport, Sport
+    attribute :name_short, Shale::Type::String
+
+    alias_method :wildcard?, :has_wildcard
+
+    json do
+      map "id", to: :id
+      map "name", to: :name
+      map "link", to: :link
+      map "abbreviation", to: :abbreviation
+      map "hasWildcard", to: :has_wildcard
+      map "league", to: :league
+      map "sport", to: :sport
+      map "nameShort", to: :name_short
+    end
+  end
+end

data/lib/mlb/conferences.rb

@@ -0,0 +1,25 @@
+require "shale"
+require "uri"
+require_relative "conference"
+
+module MLB
+  class Conferences < Shale::Mapper
+    attribute :copyright, Shale::Type::String
+    attribute :conferences, Conference, collection: true
+
+    def self.all
+      response = CLIENT.get("conferences")
+      conferences = from_json(response)
+      conferences.conferences
+    end
+
+    def self.find(conference)
+      id = conference.respond_to?(:id) ? conference.id : conference
+      params = {conferenceId: id}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("conferences?#{query_string}")
+      conferences = from_json(response)
+      conferences.conferences.first
+    end
+  end
+end

data/lib/mlb/connection.rb

@@ -8,7 +8,7 @@ module MLB
   class Connection
     extend Forwardable
 
-    DEFAULT_HOST = "lookup-service-prod.mlb.com".freeze
+    DEFAULT_HOST = "statsapi.mlb.com".freeze
     DEFAULT_PORT = 443
     DEFAULT_OPEN_TIMEOUT = 60 # seconds
     DEFAULT_READ_TIMEOUT = 60 # seconds

data/lib/mlb/division.rb

@@ -0,0 +1,44 @@
+require "equalizer"
+require "shale"
+require_relative "league"
+require_relative "sport"
+
+module MLB
+  class Division < Shale::Mapper
+    include Comparable
+    include Equalizer.new(:id)
+
+    attribute :id, Shale::Type::Integer
+    attribute :name, Shale::Type::String
+    attribute :season, Shale::Type::String
+    attribute :name_short, Shale::Type::String
+    attribute :link, Shale::Type::String
+    attribute :abbreviation, Shale::Type::String
+    attribute :league, League
+    attribute :sport, Sport
+    attribute :has_wildcard, Shale::Type::Boolean
+    attribute :sort_order, Shale::Type::Integer
+    attribute :active, Shale::Type::Boolean
+
+    alias_method :active?, :active
+    alias_method :wildcard?, :has_wildcard
+
+    json do
+      map "id", to: :id
+      map "name", to: :name
+      map "season", to: :season
+      map "nameShort", to: :name_short
+      map "link", to: :link
+      map "abbreviation", to: :abbreviation
+      map "league", to: :league
+      map "sport", to: :sport
+      map "hasWildcard", to: :has_wildcard
+      map "sortOrder", to: :sort_order
+      map "active", to: :active
+    end
+
+    def <=>(other)
+      sort_order <=> other.sort_order
+    end
+  end
+end

data/lib/mlb/divisions.rb

@@ -0,0 +1,30 @@
+require "shale"
+require "uri"
+require_relative "sport"
+require_relative "division"
+
+module MLB
+  class Divisions < Shale::Mapper
+    attribute :copyright, Shale::Type::String
+    attribute :divisions, Division, collection: true
+
+    def self.all(sport: Sport.new(id: 1))
+      sport_id = sport.respond_to?(:id) ? sport.id : sport
+      params = {sportId: sport_id}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("divisions?#{query_string}")
+      divisions = from_json(response)
+      divisions.divisions.sort!
+    end
+
+    def self.find(division, sport: Sport.new(id: 1))
+      id = division.respond_to?(:id) ? division.id : division
+      sport_id = sport.respond_to?(:id) ? sport.id : sport
+      params = {sportId: sport_id}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("divisions/#{id}?#{query_string}")
+      divisions = from_json(response)
+      divisions.divisions.sort!.first
+    end
+  end
+end

data/lib/mlb/{response_parser.rb → error_handler.rb}

@@ -1,4 +1,3 @@
-require "json"
 require "net/http"
 require_relative "errors/bad_gateway"
 require_relative "errors/bad_request"
@@ -17,7 +16,7 @@ require_relative "errors/unauthorized"
 require_relative "errors/unprocessable_entity"
 
 module MLB
-  class ResponseParser
+  class ErrorHandler
     ERROR_MAP = {
       400 => BadRequest,
       401 => Unauthorized,
@@ -34,14 +33,11 @@ module MLB
       503 => ServiceUnavailable,
       504 => GatewayTimeout
     }.freeze
-    JSON_CONTENT_TYPE_REGEXP = %r{application/json}
 
-    def parse(response:, array_class: nil, object_class: nil)
+    def handle(response:)
       raise error(response) unless response.is_a?(Net::HTTPSuccess)
 
-      return unless json?(response)
-
-      JSON.parse(response.body, array_class:, object_class:, symbolize_names: true)
+      response.body
     end
 
     private
@@ -53,9 +49,5 @@ module MLB
     def error_class(response)
       ERROR_MAP[Integer(response.code)] || HTTPError
     end
-
-    def json?(response)
-      JSON_CONTENT_TYPE_REGEXP.match?(response["content-type"])
-    end
   end
 end

data/lib/mlb/handedness.rb

@@ -0,0 +1,16 @@
+require "equalizer"
+require "shale"
+
+module MLB
+  class Handedness < Shale::Mapper
+    include Equalizer.new(:code)
+
+    attribute :code, Shale::Type::String
+    attribute :description, Shale::Type::String
+
+    json do
+      map "code", to: :code
+      map "description", to: :description
+    end
+  end
+end

data/lib/mlb/league.rb

@@ -0,0 +1,68 @@
+require "equalizer"
+require "shale"
+require_relative "season_date_info"
+require_relative "sport"
+
+module MLB
+  class League < Shale::Mapper
+    include Comparable
+    include Equalizer.new(:id)
+
+    attribute :id, Shale::Type::Integer
+    attribute :name, Shale::Type::String
+    attribute :link, Shale::Type::String
+    attribute :abbreviation, Shale::Type::String
+    attribute :name_short, Shale::Type::String
+    attribute :season_state, Shale::Type::String
+    attribute :has_wild_card, Shale::Type::Boolean
+    attribute :has_split_season, Shale::Type::Boolean
+    attribute :num_games, Shale::Type::Integer
+    attribute :has_playoff_points, Shale::Type::Boolean
+    attribute :num_teams, Shale::Type::Integer
+    attribute :num_wildcard_teams, Shale::Type::Integer
+    attribute :season_date_info, SeasonDateInfo
+    attribute :season, Shale::Type::Integer
+    attribute :org_code, Shale::Type::String
+    attribute :conferences_in_use, Shale::Type::Boolean
+    attribute :divisions_in_use, Shale::Type::Boolean
+    attribute :sport, Sport
+    attribute :sort_order, Shale::Type::Integer
+    attribute :active, Shale::Type::Boolean
+
+    alias_method :active?, :active
+    alias_method :wild_card?, :has_wild_card
+    alias_method :has_wildcard, :has_wild_card
+    alias_method :wildcard?, :has_wild_card
+    alias_method :split_season?, :has_split_season
+    alias_method :playoff_points?, :has_playoff_points
+    alias_method :conferences?, :conferences_in_use
+    alias_method :divisions?, :divisions_in_use
+
+    json do
+      map "id", to: :id
+      map "name", to: :name
+      map "link", to: :link
+      map "abbreviation", to: :abbreviation
+      map "nameShort", to: :name_short
+      map "seasonState", to: :season_state
+      map "hasWildCard", to: :has_wild_card
+      map "hasSplitSeason", to: :has_split_season
+      map "numGames", to: :num_games
+      map "hasPlayoffPoints", to: :has_playoff_points
+      map "numTeams", to: :num_teams
+      map "numWildcardTeams", to: :num_wildcard_teams
+      map "seasonDateInfo", to: :season_date_info
+      map "season", to: :season
+      map "orgCode", to: :org_code
+      map "conferencesInUse", to: :conferences_in_use
+      map "divisionsInUse", to: :divisions_in_use
+      map "sport", to: :sport
+      map "sortOrder", to: :sort_order
+      map "active", to: :active
+    end
+
+    def <=>(other)
+      sort_order <=> other.sort_order
+    end
+  end
+end

data/lib/mlb/leagues.rb

@@ -0,0 +1,30 @@
+require "shale"
+require "uri"
+require_relative "sport"
+require_relative "league"
+
+module MLB
+  class Leagues < Shale::Mapper
+    attribute :copyright, Shale::Type::String
+    attribute :leagues, League, collection: true
+
+    def self.all(sport: Sport.new(id: 1))
+      sport_id = sport.respond_to?(:id) ? sport.id : sport
+      params = {sportId: sport_id}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("leagues?#{query_string}")
+      leagues = from_json(response)
+      leagues.leagues.sort!
+    end
+
+    def self.find(league, sport: Sport.new(id: 1))
+      id = league.respond_to?(:id) ? league.id : league
+      sport_id = sport.respond_to?(:id) ? sport.id : sport
+      params = {sportId: sport_id}
+      query_string = URI.encode_www_form(params)
+      response = CLIENT.get("leagues/#{id}?#{query_string}")
+      leagues = from_json(response)
+      leagues.leagues.sort!.first
+    end
+  end
+end