philiprehberger-interval 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2614076496fada8f6202df687ec993c5438e3a47945824e05e6bb4d00cc1c046
-  data.tar.gz: 2557c885218f82fe7de28ea6e91e660b9b901ab2995ca8d68e3a1ef9cf9b2d21
+  metadata.gz: ecb8d7c68d3603d44c8df9a87a224c52300377809ad98ab1d19fe1a89ec13449
+  data.tar.gz: 75b3438103596f8a4de7f358a9f1cc25cd39fe5e80a47dfb6f25d38852e26964
 SHA512:
-  metadata.gz: ed05a860c2d28ce9cfdf00787585e117c41ee03bd1a4f917f4c06d4c461313a7fcdfe0fa7ce9f6073804c4c67c1169e84a7988a2070d8f54f42a725a0caef36b
-  data.tar.gz: 8451b55300a3d8d489cc895792256f4e7a1077d9be2a0df25aee1e7f9ef42d9defa2de2fe7eabe3b3d3c58c6c959037f65f89a06eaa8e96d61025ff91a09e285
+  metadata.gz: 78198caa2a0cf621b3545997e8fdfb58ad7424d7304e7d4367873dd69eaa02db2c91f1ed5a95cd365074be886063fb91941dea72180b2ce4e099c6e1982fddcf
+  data.tar.gz: 2dbb700fce8cd9cf5d973ab0baabece8e8b94e8d79f71939a805418f7fdfdbf626ca183ae9ab0fc18c2c036f21a2c0de9ddd28d90e1978da02139ac8eb3d1178

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-15
+
+### Added
+- `Range#overlap_ratio(other)` — fraction of self covered by another interval (Float in 0.0–1.0)
+
 ## [0.3.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -36,6 +36,7 @@ a.overlaps?(b)     # => true
 a.intersect(b)     # => [3, 5]
 a.union(b)         # => [1, 8]
 a.include?(4)      # => true
+a.overlap_ratio(b) # => 0.5
 ```
 
 ### Interval Types
@@ -113,6 +114,7 @@ shift.include?(Time.new(2026, 1, 1, 12))  # => true
 | `#contains?(other)` | Check if interval fully contains another |
 | `#adjacent?(other)` | Check if intervals are touching but not overlapping |
 | `#intersect(other)` | Return the overlap between two intervals |
+| `#overlap_ratio(other)` | Fraction of self covered by other (0.0–1.0) |
 | `#union(other)` | Return the combined interval |
 | `#subtract(other)` | Remove another interval, returning remaining parts |
 | `#size` | Length of the interval |

data/lib/philiprehberger/interval/range.rb

@@ -113,6 +113,23 @@ module Philiprehberger
         @finish - @start
       end
 
+      # Return the fraction of self that is covered by another interval.
+      #
+      # Returns a Float in 0.0..1.0. Returns 0.0 if disjoint, 1.0 if self is
+      # fully contained in other. If self has zero length (a point), returns
+      # 1.0 when the point is within other, else 0.0.
+      #
+      # @param other [Range] the other interval
+      # @return [Float] the fraction of self covered by other
+      def overlap_ratio(other)
+        return other.include?(@start) ? 1.0 : 0.0 if size.zero?
+
+        overlap = intersect(other)
+        return 0.0 if overlap.nil?
+
+        overlap.size.to_f / size
+      end
+
       # Check if a point is within the interval.
       #
       # @param point [Comparable] the point to check

data/lib/philiprehberger/interval/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Interval
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-interval
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger