sleeper_ff 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2eabd815df1063832834aa7efcfa764631331510fab7a4efe816b6ee149171f
-  data.tar.gz: e420eb29b532a533e53e8dd38c0357e477d9465f5eda757e24be9991033960ce
+  metadata.gz: a97d8c902244a9e09489087d8b57dde3c801f8337de4a99dfa2f66d4ff434a1b
+  data.tar.gz: a3fab5a3020426f0f30481e869264aed57d3630a716c20f5836e5699eeed4fb9
 SHA512:
-  metadata.gz: 83b97c33a2122a7d668f8d8c95788f1b2ec80522617bdfb3895db0395c869c454c92e9846f3ddc1a9a7d94a412f71c967a67dbaf5f6f8b62d2e9cfe14c5330cd
-  data.tar.gz: 5b6d6c0071ddc254bddef7049802dbf19ff98f4362f103f782188a9f56c9ba3e257f00180b6865d662dd285e13f4204343642e7ef31ab6ed81aecac4e876d804
+  metadata.gz: faa1c93017e5cc0d9eabe72b28521a165cb849f5bef1c05ac1eec77b1bb68ba20ebc222184ed8566e59f56b3b8c47cc7c84f0d622e98930dd092d36791b53bda
+  data.tar.gz: 0c702a452ce0673937c56eab5e42d040b905568f83728da8139ebab11a0424100ba43a512f0b226067bdc3c4a7f0b8709bd50318c6ee7c3e1ff04726976ffbea

data/README.md

@@ -79,6 +79,11 @@ rosters = client.league_rosters("league_id")
 
 # Get all users in a league
 users = client.league_users("league_id")
+
+# Get all drafts for a league
+drafts = client.league_drafts("league_id")
+# or via the league object
+drafts = league.drafts
 ```
 
 You can access various attributes on the returned objects:
@@ -97,11 +102,84 @@ roster.starters      # => ["player_id1", "player_id2", ...]
 roster.settings      # => { wins: 10, losses: 4, ... }
 ```
 
-More endpoints coming soon:
-- Players
-- Drafts
-- Matchups
-- Transactions
+### Drafts
+
+```ruby
+# Get all drafts for a user in a season
+drafts = client.user_drafts("user_id", 2023)
+
+# Get a specific draft
+draft = client.draft("draft_id")
+
+# Get all picks in a draft
+picks = client.draft_picks("draft_id")
+# or via the draft object
+picks = draft.picks
+
+# Get all traded picks in a draft
+traded_picks = client.draft_traded_picks("draft_id")
+# or via the draft object
+traded_picks = draft.traded_picks
+```
+
+You can access various attributes on draft objects:
+
+```ruby
+# Draft attributes
+draft.draft_id    # => "917001170459361281"
+draft.league_id   # => "917001170459361280"
+draft.type        # => "snake"
+draft.status      # => "complete"
+draft.season      # => "2023"
+draft.settings    # => { teams: 12, rounds: 15, ... }
+draft.draft_order # => { "user_id" => slot, ... }
+
+# Pick attributes
+pick.player_id    # => "4046"
+pick.picked_by    # => "user_id"
+pick.round        # => 1
+pick.pick_no      # => 1
+pick.metadata     # => { first_name: "Kareem", last_name: "Hunt", ... }
+
+# Traded pick attributes
+traded_pick.season            # => "2023"
+traded_pick.round             # => 3
+traded_pick.roster_id         # => 1
+traded_pick.previous_owner_id # => 3
+traded_pick.owner_id          # => 5
+```
+
+### Players
+
+```ruby
+# Fetch all NFL players (response is ~5MB, cache locally and call sparingly)
+players = client.players
+
+# Get trending players by add or drop activity
+trending = client.trending_players("add")
+trending = client.trending_players("drop")
+
+# Optional parameters
+trending = client.trending_players("add", lookback_hours: 48, limit: 10)
+```
+
+```ruby
+# Trending player attributes
+trending.first.player_id  # => "4046"
+trending.first.count      # => 1842
+```
+
+### Sport State
+
+```ruby
+# Get the current NFL season state
+state = client.nfl_state
+
+state.week          # => 1
+state.season        # => "2024"
+state.season_type   # => "regular"
+state.display_week  # => 1
+```
 
 ## Development
 

data/lib/sleeper_ff/client/drafts.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "sleeper_ff/draft"
+
+module SleeperFF
+  class Client
+    module Drafts
+      # Get all drafts for a user in a season
+      #
+      # @param user_id [String] User ID
+      # @param season [Integer] NFL season year (e.g., 2023)
+      # @return [Array<SleeperFF::Draft>] Array of draft objects
+      def user_drafts(user_id, season)
+        data = get "user/#{user_id}/drafts/nfl/#{season}"
+        return [] if data.nil?
+
+        data.map { |d| SleeperFF::Draft.new(d, self) }
+      end
+
+      # Get a specific draft
+      #
+      # @param draft_id [String] Draft ID
+      # @return [SleeperFF::Draft] Draft object
+      def draft(draft_id)
+        data = get "draft/#{draft_id}"
+        return nil if data.nil?
+
+        SleeperFF::Draft.new(data, self)
+      end
+
+      # Get all picks in a draft
+      #
+      # @param draft_id [String] Draft ID
+      # @return [Array<Sawyer::Resource>] Array of pick objects
+      def draft_picks(draft_id)
+        get "draft/#{draft_id}/picks"
+      end
+
+      # Get all traded picks in a draft
+      #
+      # @param draft_id [String] Draft ID
+      # @return [Array<Sawyer::Resource>] Array of traded pick objects
+      def draft_traded_picks(draft_id)
+        get "draft/#{draft_id}/traded_picks"
+      end
+    end
+  end
+end

data/lib/sleeper_ff/client/leagues.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "sleeper_ff/league"
+require "sleeper_ff/draft"
+
 module SleeperFF
   class Client
     module Leagues
@@ -15,9 +18,12 @@ module SleeperFF
       # Get a specific league
       #
       # @param league_id [String] League ID
-      # @return [Sawyer::Resource] League information
+      # @return [SleeperFF::League] League object
       def league(league_id)
-        get "league/#{league_id}"
+        data = get "league/#{league_id}"
+        return nil if data.nil?
+
+        SleeperFF::League.new(data, self)
       end
 
       # Get all rosters in a league
@@ -35,6 +41,59 @@ module SleeperFF
       def league_users(league_id)
         get "league/#{league_id}/users"
       end
+
+      # Get transactions for a specific round (week) in a league
+      #
+      # @param league_id [String] League ID
+      # @param round [Integer] Week/round number
+      # @return [Array<Sawyer::Resource>] Array of transaction objects
+      def league_transactions(league_id, round)
+        get "league/#{league_id}/transactions/#{round}"
+      end
+
+      # Get all traded picks in a league
+      #
+      # @param league_id [String] League ID
+      # @return [Array<Sawyer::Resource>] Array of traded pick objects
+      def league_traded_picks(league_id)
+        get "league/#{league_id}/traded_picks"
+      end
+
+      # Get the winners playoff bracket for a league
+      #
+      # @param league_id [String] League ID
+      # @return [Array<Sawyer::Resource>] Array of bracket matchup objects
+      def league_winners_bracket(league_id)
+        get "league/#{league_id}/winners_bracket"
+      end
+
+      # Get the losers playoff bracket for a league
+      #
+      # @param league_id [String] League ID
+      # @return [Array<Sawyer::Resource>] Array of bracket matchup objects
+      def league_losers_bracket(league_id)
+        get "league/#{league_id}/losers_bracket"
+      end
+
+      # Get matchups for a specific week in a league
+      #
+      # @param league_id [String] League ID
+      # @param week [Integer] Week number
+      # @return [Array<Sawyer::Resource>] Array of matchup objects
+      def league_matchups(league_id, week)
+        get "league/#{league_id}/matchups/#{week}"
+      end
+
+      # Get all drafts for a league
+      #
+      # @param league_id [String] League ID
+      # @return [Array<SleeperFF::Draft>] Array of draft objects
+      def league_drafts(league_id)
+        data = get "league/#{league_id}/drafts"
+        return [] if data.nil?
+
+        data.map { |d| SleeperFF::Draft.new(d, self) }
+      end
     end
   end
-end 
+end

data/lib/sleeper_ff/client/players.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module SleeperFF
+  class Client
+    module Players
+      # Get all NFL players
+      #
+      # @return [Hash] Hash of player information keyed by player ID
+      def players
+        get "players/nfl"
+      end
+
+      # Get trending NFL players by add or drop activity
+      #
+      # @param type [String] "add" or "drop"
+      # @param lookback_hours [Integer] Hours to look back (default 24)
+      # @param limit [Integer] Number of results to return (default 25)
+      # @return [Array<Sawyer::Resource>] Array of trending player objects
+      def trending_players(type, lookback_hours: 24, limit: 25)
+        get "players/nfl/trending/#{type}", query: {lookback_hours: lookback_hours, limit: limit}
+      end
+    end
+  end
+end

data/lib/sleeper_ff/client/sport.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SleeperFF
+  class Client
+    module Sport
+      # Get the current state of an NFL season
+      #
+      # @return [Sawyer::Resource] Current NFL state including week, season, and season type
+      def nfl_state
+        get "state/nfl"
+      end
+    end
+  end
+end

data/lib/sleeper_ff/client/users.rb

@@ -12,4 +12,4 @@ module SleeperFF
       end
     end
   end
-end 
+end

data/lib/sleeper_ff/client.rb

@@ -4,12 +4,18 @@ require "sawyer"
 require "sleeper_ff/configurable"
 require "sleeper_ff/client/users"
 require "sleeper_ff/client/leagues"
+require "sleeper_ff/client/drafts"
+require "sleeper_ff/client/players"
+require "sleeper_ff/client/sport"
 
 module SleeperFF
   class Client
     include SleeperFF::Configurable
     include SleeperFF::Client::Users
     include SleeperFF::Client::Leagues
+    include SleeperFF::Client::Drafts
+    include SleeperFF::Client::Players
+    include SleeperFF::Client::Sport
 
     # Header keys that can be passed in options hash
     CONVENIENCE_HEADERS = Set.new([:accept, :content_type])
@@ -34,14 +40,14 @@ module SleeperFF
 
     def request(method, path, data, options = {})
       if data.is_a?(Hash)
-        options[:query]   = data.delete(:query) || {}
+        options[:query] = data.delete(:query) || {}
         options[:headers] = data.delete(:headers) || {}
-        if accept = data.delete(:accept)
+        if (accept = data.delete(:accept))
           options[:headers][:accept] = accept
         end
       end
 
-      @last_response = response = agent.call(method, URI::Parser.new.escape(path.to_s), data, options)
+      @last_response = response = agent.call(method, URI::DEFAULT_PARSER.escape(path.to_s), data, options)
       response.data
     end
 
@@ -52,4 +58,4 @@ module SleeperFF
       end
     end
   end
-end 
+end

data/lib/sleeper_ff/configurable.rb

@@ -27,4 +27,4 @@ module SleeperFF
       self
     end
   end
-end 
+end

data/lib/sleeper_ff/default.rb

@@ -2,9 +2,9 @@
 
 module SleeperFF
   module Default
-    API_ENDPOINT = "https://api.sleeper.app/v1".freeze
+    API_ENDPOINT = "https://api.sleeper.app/v1"
     USER_AGENT = "SleeperFF Ruby Gem #{SleeperFF::VERSION}".freeze
-    MEDIA_TYPE = "application/json".freeze
+    MEDIA_TYPE = "application/json"
 
     class << self
       def api_endpoint
@@ -20,4 +20,4 @@ module SleeperFF
       end
     end
   end
-end 
+end

data/lib/sleeper_ff/draft.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module SleeperFF
+  class Draft
+    def initialize(data, client)
+      @data = data
+      @client = client
+    end
+
+    def picks
+      @client.draft_picks(@data.draft_id)
+    end
+
+    def traded_picks
+      @client.draft_traded_picks(@data.draft_id)
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @data.respond_to?(method_name) || super
+    end
+
+    def method_missing(method_name, *args, &block)
+      if @data.respond_to?(method_name)
+        @data.send(method_name, *args, &block)
+      else
+        super
+      end
+    end
+  end
+end

data/lib/sleeper_ff/error.rb

@@ -27,4 +27,4 @@ module SleeperFF
 
   # Raised when Sleeper returns a 503 HTTP status code
   class ServiceUnavailable < Error; end
-end 
+end

data/lib/sleeper_ff/league.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module SleeperFF
+  class League
+    def initialize(data, client)
+      @data = data
+      @client = client
+    end
+
+    def transactions(round)
+      @client.league_transactions(@data.league_id, round)
+    end
+
+    def traded_picks
+      @client.league_traded_picks(@data.league_id)
+    end
+
+    def winners_bracket
+      @client.league_winners_bracket(@data.league_id)
+    end
+
+    def losers_bracket
+      @client.league_losers_bracket(@data.league_id)
+    end
+
+    def matchups(week)
+      @client.league_matchups(@data.league_id, week)
+    end
+
+    def drafts
+      @client.league_drafts(@data.league_id)
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @data.respond_to?(method_name) || super
+    end
+
+    def method_missing(method_name, *args, &block)
+      if @data.respond_to?(method_name)
+        @data.send(method_name, *args, &block)
+      else
+        super
+      end
+    end
+  end
+end

data/lib/sleeper_ff/version.rb

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

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sleeper_ff
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Josh Mejia
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-03 00:00:00.000000000 Z
+date: 2026-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -106,16 +107,22 @@ files:
 - bin/setup
 - lib/sleeper_ff.rb
 - lib/sleeper_ff/client.rb
+- lib/sleeper_ff/client/drafts.rb
 - lib/sleeper_ff/client/leagues.rb
+- lib/sleeper_ff/client/players.rb
+- lib/sleeper_ff/client/sport.rb
 - lib/sleeper_ff/client/users.rb
 - lib/sleeper_ff/configurable.rb
 - lib/sleeper_ff/default.rb
+- lib/sleeper_ff/draft.rb
 - lib/sleeper_ff/error.rb
+- lib/sleeper_ff/league.rb
 - lib/sleeper_ff/version.rb
 homepage: https://github.com/jmejia/sleeper_ff
 licenses:
 - MIT
 metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -130,7 +137,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: Ruby toolkit for the Sleeper Fantasy Football API
 test_files: []