enumerable-stats 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0131e566d1175fe367fb75c840914ae752eea76a1a194a8d35a02d24591d6ad
-  data.tar.gz: bb99194f3965132256bb9cdabed80bf58c5da172f7cd10e4f56277c0417fe7d0
+  metadata.gz: e012306442bdf4598aeff1c134063a3a0c98e6765a949c492626ba7acdf90c1d
+  data.tar.gz: dc2565331c7aa7f07ab55c7b876d78e8c9759f7a0e083d9a39f82c2deb1c5458
 SHA512:
-  metadata.gz: 022f98715f44e7788749adb509bbef27bf759d2d09c7d946ebbdf21e34ea6e8a7225e011be6ad39e3260cec3f7daad17c61ecefbd9a197457b0e75d9bd10889c
-  data.tar.gz: d1e0a0052b175fe9fc4175961d0b52248c8cc78c39258048fa7846d9e67c8bd2ff6fe6da365b41284b9b9e2d48c8a9c1fcc165d621a25d9227df88716849ae34
+  metadata.gz: 1ef3e67bbf9977081003fb009b08afe891b0177a26d58fa5cd206f216890c1ec3c8b4904e92f2731bc3a6ce134848813033d555c7baa16c8fdde87637913f894
+  data.tar.gz: 4aa56d0cba5bd41c2b2e91224814801f8c97429a9cf2516d1acae865c0a2a6b7b786e5eeaba4c81e4777a7b0735b8008fdaf263e9fb26d7c0165fce70f7a24ff

data/lib/enumerable_stats/enumerable_ext.rb

@@ -147,16 +147,6 @@ module EnumerableStats
       t_stat > critical_value
     end
 
-    # Alias for greater_than?
-    def >(other, alpha: 0.05)
-      greater_than?(other, alpha: alpha)
-    end
-
-    # Alias for less_than?
-    def <(other, alpha: 0.05)
-      less_than?(other, alpha: alpha)
-    end
-
     # Tests if this collection's mean is significantly less than another collection's mean
     # using a one-tailed Student's t-test. Returns true if the test indicates statistical
     # significance at the specified alpha level.
@@ -177,6 +167,58 @@ module EnumerableStats
       t_stat < -critical_value
     end
 
+    # Operator alias for greater_than? - tests if this collection's mean is significantly greater
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly greater
+    # @example
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline > optimized  # => true (baseline is significantly greater)
+    def >(other, alpha: 0.05)
+      greater_than?(other, alpha: alpha)
+    end
+
+    # Operator alias for less_than? - tests if this collection's mean is significantly less
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly less
+    # @example
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized < baseline  # => true (optimized is significantly less)
+    def <(other, alpha: 0.05)
+      less_than?(other, alpha: alpha)
+    end
+
+    # Tests if this collection's mean is significantly different from another collection's mean
+    # using a two-tailed Student's t-test. Returns 1 if the test indicates statistical
+    # significance at the specified alpha level, -1 if the test indicates statistical
+    # significance at the specified alpha level, and 0 if the test indicates no statistical
+    # significance at the specified alpha level.
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] Significance level (default: 0.05 for 95% confidence)
+    # @return [Integer] 1 if this collection's mean is significantly greater, -1 if this collection's mean is
+    #                   significantly less, 0 if this collection's mean is not significantly different
+    # @example
+    #   control = [10, 12, 11, 13, 12]     # mean ≈ 11.6
+    #   treatment = [15, 17, 16, 18, 14]   # mean = 16.0
+    #   control <=> treatment              # => 1 (control is significantly different from treatment)
+    #   treatment <=> control              # => -1 (treatment is significantly different from control)
+    #   control <=> control                # => 0 (control is not significantly different from itself)
+    def <=>(other, alpha: 0.05)
+      if greater_than?(other, alpha: alpha)
+        1
+      elsif less_than?(other, alpha: alpha)
+        -1
+      else
+        0
+      end
+    end
+
     # Calculates the arithmetic mean (average) of the collection
     #
     # @return [Float] The arithmetic mean of all numeric values

data/lib/enumerable_stats/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enumerable-stats
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Jon Daniel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-03 00:00:00.000000000 Z
+date: 2025-08-04 00:00:00.000000000 Z
 dependencies: []
 description: |
   A Ruby gem that extends all Enumerable objects (Arrays, Ranges, Sets, etc.) with essential statistical methods.
@@ -22,6 +22,7 @@ extra_rdoc_files: []
 files:
 - lib/enumerable-stats.rb
 - lib/enumerable_stats/enumerable_ext.rb
+- lib/enumerable_stats/version.rb
 homepage: https://github.com/binarycleric/enumerable-stats
 licenses:
 - MIT