philiprehberger-random_data 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6350aa4eda28ecdea9d193df38c56e81c86721fbd2b6942c5db449faf27d8edb
-  data.tar.gz: 2d5344a60caa5109834c6092ad48cf8b5b98b668fb0202c799a87b54675b946b
+  metadata.gz: 954c7c0c37c43b00fb90d5ccd7a75803c317f8fd717c6901c8f373702a40e77a
+  data.tar.gz: 2b6a0b2f9c86e9f085e8131a96c254298725090ac235439da4e8942c4add65ec
 SHA512:
-  metadata.gz: 16d362cc134a11ccf60a5c93ce97bb1b418d8c16174592b8b602053f5ac91d92a1e58f9070c190a4904f39d921b5df73eafa86e08f1a94b204dd9731e6bad029
-  data.tar.gz: 77700612c576d8c54f35915143eade1ac1f1dd5bde72463a13c8df90633888311ce71a88aefc1beedfe91fd5eca4f22fd987f02aff12adc72618049b16906211
+  metadata.gz: 0b3e1f4502aace66e2a8411424d4068bfbebbf5e10667cc3ea0ccdfe9fdc3a2973eec52890db52d244d9ab5028fefa0397436cc7aa9aee4d66a14517c0fa3ffc
+  data.tar.gz: 3396c724469a9060ca1e945aa9b6673e351b34b190d24a4b1d5c9a07d272f8101c2404eec64ce8632d846be1e45f0809be15f769ebb3976d4b949db159d9f04f

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-16
+
+### Added
+- `RandomData.weighted_pick(array, weights:)` — pick an element using cumulative-weight sampling proportional to the supplied non-negative numeric weights
+
 ## [0.2.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -63,6 +63,14 @@ Philiprehberger::RandomData.pick(colors)       # => "green"
 Philiprehberger::RandomData.sample(colors, 2)  # => ["blue", "red"]
 ```
 
+### Weighted Pick
+
+```ruby
+tiers = %w[bronze silver gold]
+Philiprehberger::RandomData.weighted_pick(tiers, weights: [70, 25, 5])
+# => "bronze" most of the time, "gold" rarely
+```
+
 ### Network
 
 ```ruby
@@ -107,6 +115,7 @@ Philiprehberger::RandomData.timestamp  # => 2025-08-14 03:22:11 +0000
 | `RandomData.hex(length)` | Random hex string |
 | `RandomData.pick(array)` | Random element from array |
 | `RandomData.sample(array, n)` | Random n elements from array |
+| `RandomData.weighted_pick(array, weights:)` | Random element chosen proportionally to matching weights |
 | `RandomData.ipv4` | Random IPv4 address |
 | `RandomData.address` | Random address hash with street, city, state, zip |
 | `RandomData.company` | Random company name |

data/lib/philiprehberger/random_data/data.rb

@@ -55,5 +55,34 @@ module Philiprehberger
     URL_SCHEMES = %w[https http].freeze
 
     URL_TLDS = %w[com org net io dev app co].freeze
+
+    # Pick a random element from +array+ using the matching probability +weights+.
+    #
+    # Each index in +array+ has a corresponding non-negative numeric weight in +weights+.
+    # The element is selected via cumulative-weight sampling, where elements with higher
+    # weights are proportionally more likely to be returned.
+    #
+    # @param array [Array] source array
+    # @param weights [Array<Numeric>] non-negative weights, one per element
+    # @return [Object] one element from +array+ chosen proportionally to its weight
+    # @raise [ArgumentError] if +array+ and +weights+ differ in length,
+    #   if any weight is negative, or if every weight is zero
+    def self.weighted_pick(array, weights:)
+      raise ArgumentError, 'array and weights must be the same length' if array.length != weights.length
+      raise ArgumentError, 'weights must all be numeric' unless weights.all?(Numeric)
+      raise ArgumentError, 'weights must all be non-negative' if weights.any?(&:negative?)
+
+      total = weights.sum
+      raise ArgumentError, 'weights must not all be zero' if total.zero?
+
+      threshold = rand * total
+      cumulative = 0.0
+      array.each_with_index do |element, index|
+        cumulative += weights[index]
+        return element if threshold < cumulative
+      end
+
+      array.last
+    end
   end
 end

data/lib/philiprehberger/random_data/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module RandomData
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-random_data
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: Generate random test data including names, emails, phone numbers, UUIDs,
   sentences, paragraphs, dates, numbers, and more. Includes 50 first names, 50 last