philiprehberger-random_data 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6350aa4eda28ecdea9d193df38c56e81c86721fbd2b6942c5db449faf27d8edb
-  data.tar.gz: 2d5344a60caa5109834c6092ad48cf8b5b98b668fb0202c799a87b54675b946b
+  metadata.gz: 66b3892c4c67cf116d9f415c2f15f9351e9fc9ecc907fcd052d93db04c2da69c
+  data.tar.gz: 25f7bd4d5907d4350dc5d9381781b6c47f694e4df593c48ef80347147fd97ad8
 SHA512:
-  metadata.gz: 16d362cc134a11ccf60a5c93ce97bb1b418d8c16174592b8b602053f5ac91d92a1e58f9070c190a4904f39d921b5df73eafa86e08f1a94b204dd9731e6bad029
-  data.tar.gz: 77700612c576d8c54f35915143eade1ac1f1dd5bde72463a13c8df90633888311ce71a88aefc1beedfe91fd5eca4f22fd987f02aff12adc72618049b16906211
+  metadata.gz: 4ea172d1596e1f5c28aa06cef63822fec2202f4a176c526f4f132a5aedd13bbb0db6bda54740ef11fbfbbafb6242e7b2693cc22f89e1a547fb09cf3fa241ccd7
+  data.tar.gz: 127842bc07223d27f397348d79ebec2dda96e32a588b13119748070bb89054b9719714e6744c33a3b0e57df82eda1eca154c7ebc116474a628e397e3da611367

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-24
+
+### Added
+- `RandomData.coordinates` — returns a `{ latitude:, longitude: }` hash with latitude in `-90.0..90.0` and longitude in `-180.0..180.0`
+
+## [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
@@ -70,6 +78,13 @@ Philiprehberger::RandomData.ipv4  # => "192.45.67.123"
 Philiprehberger::RandomData.url   # => "https://smith42.com"
 ```
 
+### Coordinates
+
+```ruby
+Philiprehberger::RandomData.coordinates
+# => { latitude: 42.7651, longitude: -87.3419 }
+```
+
 ### Address and Company
 
 ```ruby
@@ -107,7 +122,9 @@ 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.coordinates` | Random `{ latitude:, longitude: }` pair |
 | `RandomData.address` | Random address hash with street, city, state, zip |
 | `RandomData.company` | Random company name |
 | `RandomData.url` | Random URL |

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.4.0'
   end
 end

data/lib/philiprehberger/random_data.rb

@@ -151,6 +151,18 @@ module Philiprehberger
       Array.new(4) { rand(1..254) }.join('.')
     end
 
+    # Generate a random geographic coordinate pair.
+    #
+    # Latitude is drawn uniformly from `-90.0..90.0` and longitude from
+    # `-180.0..180.0`. The distribution is not area-weighted — it samples
+    # the latitude axis uniformly, not over a sphere — which is usually
+    # what test fixtures want.
+    #
+    # @return [Hash{Symbol => Float}] `{ latitude:, longitude: }`
+    def self.coordinates
+      { latitude: float(-90.0..90.0), longitude: float(-180.0..180.0) }
+    end
+
     # Generate a random address
     #
     # @return [Hash] address with street, city, state, zip

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-random_data
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-24 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