sleeper_ff 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2eabd815df1063832834aa7efcfa764631331510fab7a4efe816b6ee149171f
-  data.tar.gz: e420eb29b532a533e53e8dd38c0357e477d9465f5eda757e24be9991033960ce
+  metadata.gz: e7003f4a5b2c10ca28f61fb523031b6191985e36998dd644266c2599c696c983
+  data.tar.gz: 4de640ecc50838e96b08b48f76fd7cdd570314ca8fe585f37908d440a1175583
 SHA512:
-  metadata.gz: 83b97c33a2122a7d668f8d8c95788f1b2ec80522617bdfb3895db0395c869c454c92e9846f3ddc1a9a7d94a412f71c967a67dbaf5f6f8b62d2e9cfe14c5330cd
-  data.tar.gz: 5b6d6c0071ddc254bddef7049802dbf19ff98f4362f103f782188a9f56c9ba3e257f00180b6865d662dd285e13f4204343642e7ef31ab6ed81aecac4e876d804
+  metadata.gz: 70e4b1ec4e14b3d43bfe9cbdef93d1edc90a3c42e13b27d5911e5f4e905161c128afe35ab8d82ed4d0a63c566d5b1028f369813c69a0c443a42771bdabbd0660
+  data.tar.gz: 3fde189ef7e7e4cdc918a37db469182c40f3a90ff153eb128e9bd08eb48f914fc5c3a7d2f719318ec3546d5d95394555457d938d2117dd0b56e97559ce14bc0d

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,9 +102,74 @@ roster.starters      # => ["player_id1", "player_id2", ...]
 roster.settings      # => { wins: 10, losses: 4, ... }
 ```
 
+### 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
+```
+
 More endpoints coming soon:
-- Players
-- Drafts
 - Matchups
 - Transactions
 

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 

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.rb

@@ -4,12 +4,16 @@ 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"
 
 module SleeperFF
   class Client
     include SleeperFF::Configurable
     include SleeperFF::Client::Users
     include SleeperFF::Client::Leagues
+    include SleeperFF::Client::Drafts
+    include SleeperFF::Client::Players
 
     # Header keys that can be passed in options hash
     CONVENIENCE_HEADERS = Set.new([:accept, :content_type])

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/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.0"
 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.0
 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,21 @@ 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/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 +136,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: []