truedl 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: adb89d73bbf1d5bcf9b06aa01c55fbc751c2de80e3f6a766870476b48f522330
+  data.tar.gz: eab42b1989540e3c60df1e47015dc0014b72711c98568f37e2d43f85e5779250
+SHA512:
+  metadata.gz: 20afbbb1ad91eae384da119f8e315b38dad67f0614e3aa6e6a0ebd40300972640dc627d08e39b13bd49fb3dcc82037aa8a25cb3e043ece237f320b81fae2a00b
+  data.tar.gz: 841f58f4e5a75a0522f9f862af41f71305f73d709c3e2fe28f249f713129d215f30727801984bfce89175a00003c2bb78d13c3540df01eb518c3b2aa61670991

data/README.md

@@ -0,0 +1,15 @@
+# Truedl
+
+Ruby implementation of [the TrueDL formula](https://pecheny.me/blog/truedl/).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/razumau/truedl. 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/[USERNAME]/truedl/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 Truedl project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/truedl/blob/master/CODE_OF_CONDUCT.md).

data/lib/true_dl.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "truedl/version"
+
+module TrueDL
+  ##
+  # Formula for TrueDL is described in this post: https://pecheny.me/blog/truedl/
+  #
+  # @param [Integer, Float] place
+  # @return [Float, nil]
+  def self.coefficient_for_place(place)
+    case place
+    when 1..10 then 1.61
+    when 11..25 then 1.52
+    when 26..50 then 1.43
+    when 51..100 then 1.32
+    when 101..250 then 1.16
+    when 251..500 then 1.0
+    when 501..1000 then 0.81
+    when 1001..2000 then 0.6
+    when 2001..3000 then 0.43
+    when 3001..5000 then 0.31
+    end
+  end
+
+  # @param [Integer] team_points
+  # @param [Integer, Float] team_ranking
+  # @param [Integer] number_of_questions
+  # @return [Float]
+  def self.truedl_for_team(team_points:, team_ranking:, number_of_questions:)
+    return if team_points.nil?
+    return if number_of_questions.nil? || number_of_questions < 1
+    return if team_ranking.nil? || team_ranking > 5000 || team_ranking < 1
+
+    (1 - [team_points / coefficient_for_place(team_ranking), number_of_questions].min / number_of_questions) * 10
+  end
+
+  # Calculates TrueDL for a tournament: an average of all non-nil team TrueDLs.
+  # Might be nil for tournaments where all teams are ranked below top 5000.
+  #
+  # @param [Array] teams: list of hashes with `points` and `ranking`, e.g., `{ points: 28, ranking: 22 }`
+  # @param [Integer] number_of_questions
+  # @return [Float, nil]
+  def self.true_dl_for_tournament(teams:, number_of_questions:)
+    dls = teams.map do |team|
+      truedl_for_team(team_points: team[:points], team_ranking: team[:ranking], number_of_questions:)
+    end.compact
+
+    return if dls.empty?
+
+    dls.sum / dls.size
+  end
+end

data/lib/truedl/version.rb

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

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: truedl
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jury Razumau
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-09-30 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+- mail@razumau.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/true_dl.rb
+- lib/truedl/version.rb
+homepage: https://github.com/razumau/truedl
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/razumau/truedl
+  source_code_uri: https://github.com/razumau/truedl
+  changelog_uri: https://github.com/razumau/truedl/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.18
+signing_key:
+specification_version: 4
+summary: Ruby implementation of TrueDL.
+test_files: []