y_fantasy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4fa3a23dc0749a4169ee95d862127a9f88d85651439121a5cd694a541d7ec2e6
+  data.tar.gz: b7a3fc4a5c320c29eefbbbedbfdd55983dc2c737eb75ab6c5120927b9c04f455
+SHA512:
+  metadata.gz: a8b0e3a377c985aa5c90caa3e543d6cff2628f31dfb53826a1e37c15a0a3727687ec2ecc25f739f3d0ba8450d238a468b6b16751c9c20e0cd72c6f11ab805a52
+  data.tar.gz: 57d2e8415bd4f77426f4841b8e7ed23eb1d3848163f90eba7f2a6c4acd3efdd6c4466d0ff9adca6d72745b20043e4d433c5b34b1a52aeea361e735886016825e

data/.pryrc

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+if defined?(PryByebug)
+  Pry.commands.alias_command "c", "continue"
+  Pry.commands.alias_command "s", "step"
+  Pry.commands.alias_command "n", "next"
+  Pry.commands.alias_command "f", "finish"
+end

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,20 @@
+require: standard
+
+inherit_gem:
+  standard: config/base.yml
+
+AllCops:
+  TargetRubyVersion: 3.1
+  Exclude:
+    - "scratch/**/*"
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes

data/.standard.yml

@@ -0,0 +1,2 @@
+ignore:
+  - "scratch/**/*"

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-07-11
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Contributor Covenant Code of Conduct
+
+Be kind.

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,220 @@
+PATH
+  remote: .
+  specs:
+    y_fantasy (0.1.0)
+      dry-configurable (~> 1.0)
+      dry-initializer (~> 3.0)
+      dry-transformer (~> 1.0)
+      dry-types (~> 1.0)
+      dry-validation (~> 1.0)
+      mechanize (~> 2.9)
+      ox (~> 2.14)
+      thor (~> 1.3)
+      zeitwerk (~> 2.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (7.1.5.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      mutex_m
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.2)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.5)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    concurrent-ruby (1.2.2)
+    connection_pool (2.5.0)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.5.0)
+    docile (1.4.1)
+    domain_name (0.6.20240107)
+    drb (2.2.1)
+    dry-configurable (1.1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-core (1.0.1)
+      concurrent-ruby (~> 1.0)
+      zeitwerk (~> 2.6)
+    dry-inflector (1.0.0)
+    dry-initializer (3.1.1)
+    dry-logic (1.5.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-schema (1.13.3)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 1.0, >= 1.0.1)
+      dry-core (~> 1.0, < 2)
+      dry-initializer (~> 3.0)
+      dry-logic (>= 1.4, < 2)
+      dry-types (>= 1.7, < 2)
+      zeitwerk (~> 2.6)
+    dry-transformer (1.0.1)
+      zeitwerk (~> 2.6)
+    dry-types (1.7.2)
+      bigdecimal (~> 3.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
+    dry-validation (1.10.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0, < 2)
+      dry-initializer (~> 3.0)
+      dry-schema (>= 1.12, < 2)
+      zeitwerk (~> 2.6)
+    factory_bot (6.5.0)
+      activesupport (>= 5.0.0)
+    hashdiff (1.1.0)
+    http-cookie (1.0.8)
+      domain_name (~> 0.5)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.9.1)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    logger (1.6.5)
+    mechanize (2.14.0)
+      addressable (~> 2.8)
+      base64
+      domain_name (~> 0.5, >= 0.5.20190701)
+      http-cookie (~> 1.0, >= 1.0.3)
+      mime-types (~> 3.3)
+      net-http-digest_auth (~> 1.4, >= 1.4.1)
+      net-http-persistent (>= 2.5.2, < 5.0.dev)
+      nkf
+      nokogiri (~> 1.11, >= 1.11.2)
+      rubyntlm (~> 0.6, >= 0.6.3)
+      webrick (~> 1.7)
+      webrobots (~> 0.1.2)
+    method_source (1.1.0)
+    mime-types (3.6.0)
+      logger
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2025.0107)
+    minitest (5.25.4)
+    mutex_m (0.3.0)
+    net-http-digest_auth (1.4.1)
+    net-http-persistent (4.0.5)
+      connection_pool (~> 2.2)
+    nkf (0.2.0)
+    nokogiri (1.18.2-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.2-x86_64-darwin)
+      racc (~> 1.4)
+    ox (2.14.20)
+      bigdecimal (>= 3.0)
+    parallel (1.26.3)
+    parser (3.3.7.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.10.1)
+      byebug (~> 11.0)
+      pry (>= 0.13, < 0.15)
+    public_suffix (6.0.1)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.1.0)
+    regexp_parser (2.10.0)
+    rexml (3.4.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    rubocop (1.70.0)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.36.2, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.37.0)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.23.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    rubyntlm (0.6.5)
+      base64
+    securerandom (0.4.1)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.1)
+    simplecov_json_formatter (0.1.4)
+    standard (1.44.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.70.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.6)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.6.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.23.0)
+    thor (1.3.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    webmock (3.19.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    webrick (1.9.1)
+    webrobots (0.1.2)
+    zeitwerk (2.6.12)
+
+PLATFORMS
+  arm64-darwin-21
+  arm64-darwin-23
+  x86_64-darwin-21
+
+DEPENDENCIES
+  bundler (~> 2.3)
+  factory_bot (~> 6.5)
+  pry-byebug (~> 3.10)
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  simplecov (~> 0.20)
+  standard (~> 1.10)
+  webmock (~> 3.0)
+  y_fantasy!
+
+BUNDLED WITH
+   2.3.7

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 eaylward8
+
+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,41 @@
+# YFantasy
+
+A Ruby wrapper for the Yahoo Fantasy Sports API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'y_fantasy'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install y_fantasy
+
+## Usage
+
+TBD
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` 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/eaylward8/y_fantasy. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/eaylward8/y_fantasy/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the YFantasy project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/eaylward8/y_fantasy/blob/master/CODE_OF_CONDUCT.md).

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/exe/y_fantasy

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+# Add lib directory to load path
+# lib_path = File.expand_path("../lib", __dir__)
+# $LOAD_PATH.unshift(lib_path) unless $LOAD_PATH.include?(lib_path)
+
+require "y_fantasy/cli"
+
+YFantasy::CLI.start

data/lib/y_fantasy/api/authentication.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+require "base64"
+require "net/http"
+require "uri"
+require "mechanize"
+require "timeout"
+
+module YFantasy
+  module Api
+    class Authentication
+      YAHOO_CLIENT_ID = YFantasy.config.yahoo_client_id
+      YAHOO_CLIENT_SECRET = YFantasy.config.yahoo_client_secret
+      YAHOO_USERNAME = YFantasy.config.yahoo_username
+      YAHOO_PASSWORD = YFantasy.config.yahoo_password
+
+      REQUEST_AUTH_URL = "https://api.login.yahoo.com/oauth2/request_auth?client_id=#{YAHOO_CLIENT_ID}&redirect_uri=oob&response_type=code"
+      GET_TOKEN_URL = "https://api.login.yahoo.com/oauth2/get_token"
+
+      MSG_SEPARATOR = "#" * 50
+
+      # NOTE: access token expires in 1 hour (3600 seconds)
+
+      class << self
+        # TODO: I don't think any of these readers are needed besides access_token. Maybe the error ones?
+        attr_reader :access_token, :expires_at, :refresh_token, :error_type, :error_desc
+
+        def authenticate
+          return true if access_token_valid?
+
+          if YFantasy.config.yahoo_refresh_token
+            @refresh_token = YFantasy.config.yahoo_refresh_token
+          end
+
+          refresh_token? ? authenticate_with_refresh_token : authenticate_with_code
+        end
+
+        def access_token_valid?
+          !!access_token && !!expires_at && Time.now.to_i < expires_at
+        end
+
+        private
+
+        def authenticate_with_refresh_token
+          puts "auth with refresh token"
+          response = post(GET_TOKEN_URL, post_data("refresh_token", refresh_token: refresh_token))
+          handle_response(response)
+        end
+
+        def authenticate_with_code
+          puts "auth with code"
+          code = YFantasy.config.automate_login ? get_auth_code_automated : get_auth_code_manual
+          response = post(GET_TOKEN_URL, post_data("authorization_code", code: code))
+          handle_response(response, print_tokens: !YFantasy.config.automate_login)
+        end
+
+        def handle_response(response, print_tokens: false)
+          body = JSON.parse(response.body)
+
+          case response
+          when Net::HTTPSuccess
+            display_token_message(body) if print_tokens # Display token data to user after manual login
+            set_token_data(body["access_token"], body["expires_in"], body["refresh_token"])
+            clear_error_data
+            true
+          when Net::HTTPClientError, Net::HTTPServerError
+            set_error_data(body["error"], body["error_description"])
+            false
+          end
+        end
+
+        def display_token_message(body)
+          puts "\nAccess token: #{body["access_token"]}"
+          puts "\nAccess token expires in: #{body["expires_in"]} seconds"
+          puts "\nRefresh token: #{body["refresh_token"]}"
+          puts "\nThe refresh token is long-lived and can be used to re-authenticate without the need for credentials."
+          puts "Store it as an ENV variable called YAHOO_REFRESH_TOKEN or save it to a database."
+          puts "Then, in your application, set YFantasy.config.yahoo_refresh_token = <your_refresh_token>"
+          puts "If the yahoo_refresh_token config is set, YFantasy will use it to obtain a new access token when needed."
+          puts "\nRead more about the Yahoo OAuth 2.0 Flow: https://developer.yahoo.com/oauth2/guide/flows_authcode/\n\n"
+          puts MSG_SEPARATOR
+          puts "#      YFantasy Manual Auth Code Flow - END      #"
+          puts MSG_SEPARATOR
+        end
+
+        def get_auth_code_manual
+          return if YFantasy.config.automate_login
+
+          puts MSG_SEPARATOR
+          puts "#     YFantasy Manual Auth Code Flow - START     #"
+          puts MSG_SEPARATOR
+          puts "\nGo to this URL and log into your Yahoo Account:"
+          puts REQUEST_AUTH_URL
+          puts "\nAfter logging in, copy and paste the code here:"
+          Timeout.timeout(YFantasy.config.manual_login_timeout_seconds) do
+            code = $stdin.gets.chomp
+            puts "\nReceived code: #{code}. Attempting to retrieve access token and refresh token...\n"
+            code
+          end
+        end
+
+        # :nocov:
+        def get_auth_code_automated
+          return if YFantasy.config.automate_login == false
+
+          # TODO: error handling
+          agent = Mechanize.new
+          login_page1 = agent.get(REQUEST_AUTH_URL)
+          username_form = login_page1.forms.first
+          # Enter username
+          username_form.username = YAHOO_USERNAME
+          # Click "Next" button
+          login_page2 = agent.submit(username_form, username_form.buttons.first)
+          pw_form = login_page2.forms.first
+          # Enter password
+          pw_form.password = YAHOO_PASSWORD
+          # Click "Verify password"
+          auth_code_page = agent.submit(pw_form, pw_form.button("verifyPassword"))
+          # Extract code
+          # TODO: sometimes below line fails w/ undefined method [] for nil, add a retry?
+          match = auth_code_page.uri.query.match(/code=(?<code>\w+)/)
+          return match[:code] if match
+
+          raise Error.new("Failed to extract auth code")
+        end
+        # :nocov:
+
+        def post(url, data)
+          Net::HTTP.post(URI(url), URI.encode_www_form(data), post_headers)
+        end
+
+        def post_headers
+          {
+            "Authorization" => "Basic #{basic_auth_token}",
+            "Content-Type" => "application/x-www-form-urlencoded"
+          }
+        end
+
+        def post_data(grant_type, refresh_token: nil, code: nil)
+          {
+            "grant_type" => grant_type,
+            "redirect_uri" => "oob",
+            "refresh_token" => refresh_token,
+            "code" => code
+          }
+        end
+
+        def basic_auth_token
+          @basic_auth_token ||= Base64.strict_encode64("#{YAHOO_CLIENT_ID}:#{YAHOO_CLIENT_SECRET}")
+        end
+
+        def set_token_data(access_token, expires_in, refresh_token)
+          @access_token = access_token
+          @expires_at = Time.now.to_i + expires_in.to_i
+          @refresh_token = refresh_token
+        end
+
+        def set_error_data(type, desc)
+          @error_type = type
+          @error_desc = desc
+        end
+
+        def clear_error_data
+          @error_type = nil
+          @error_desc = nil
+        end
+
+        def refresh_token?
+          @refresh_token && @refresh_token.length > 0
+        end
+      end
+
+      class Error < StandardError
+      end
+    end
+  end
+end

data/lib/y_fantasy/api/client.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+require "ox"
+
+module YFantasy
+  module Api
+    class Client
+      @@retry = true
+
+      def self.get(resource, keys: [], game_codes: [], subresources: [], **options)
+        new.get(resource, keys: keys, game_codes: game_codes, subresources: subresources, **options)
+      rescue Client::Error, Authentication::Error
+        if @@retry
+          @@retry = false
+          retry
+        end
+
+        raise
+      end
+
+      def initialize
+        authenticate
+      end
+
+      # NOTE: URL construction needs to be sophisticated enough to know when it should use "out" params vs
+      # nested subresources.
+      # E.g. /league/380.l.190823/teams/stats
+      # this is how you get 1 league with all teams, and all stats for each team
+      # teams is a subresource of league
+      # stats is a subresource of teams
+      #
+      #
+      # This fails because "stats" is not a subresource of league: /league/380.l.190823;out=teams/stats
+
+      def get(resource, keys: [], game_codes: [], subresources: [], **options)
+        refresh_access_token_if_needed
+
+        url = UrlBuilder.new(resource, keys: keys, game_codes: game_codes, subresources: subresources, **options).build
+
+        # puts "\n Client#get #{url} \n" # TODO: remove
+
+        response = Net::HTTP.get_response(URI(url), "Authorization" => "Bearer #{@access_token}")
+        body = response.body
+
+        case response
+        when Net::HTTPSuccess
+          Ox.load(body, mode: :hash_no_attrs).fetch(:fantasy_content)
+        when Net::HTTPClientError
+          error = Ox.load(body, mode: :hash_no_attrs)
+          error_msg = error.dig(:"yahoo:error", :"yahoo:description") || error.dig(:error, :description)
+          msg = "#{response.code}: #{error_msg}"
+          raise YFantasy::Api::Client::Error.new(msg)
+        else
+          raise YFantasy::Api::Client::Error.new("An unknown error occurred")
+        end
+      end
+
+      def authenticate
+        if YFantasy::Api::Authentication.authenticate
+          @access_token = YFantasy::Api::Authentication.access_token
+          @refresh_token = YFantasy::Api::Authentication.refresh_token
+        else
+          @error_type = YFantasy::Api::Authentication.error_type
+          @error_desc = YFantasy::Api::Authentication.error_desc
+        end
+      end
+
+      def refresh_access_token_if_needed
+        return if YFantasy::Api::Authentication.access_token_valid?
+
+        authenticate
+      end
+
+      class Error < StandardError
+        def initialize(msg = "")
+          super
+        end
+      end
+    end
+  end
+end