philiprehberger-random_data 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 954c7c0c37c43b00fb90d5ccd7a75803c317f8fd717c6901c8f373702a40e77a
-  data.tar.gz: 2b6a0b2f9c86e9f085e8131a96c254298725090ac235439da4e8942c4add65ec
+  metadata.gz: 50f3c7612e67e7214cf57ff2af61567a21efad6111cad8d097801e13fa49b46d
+  data.tar.gz: 718650040993a0556ce4185768c577fcd74aa221dfcf46e222c9ed8108798347
 SHA512:
-  metadata.gz: 0b3e1f4502aace66e2a8411424d4068bfbebbf5e10667cc3ea0ccdfe9fdc3a2973eec52890db52d244d9ab5028fefa0397436cc7aa9aee4d66a14517c0fa3ffc
-  data.tar.gz: 3396c724469a9060ca1e945aa9b6673e351b34b190d24a4b1d5c9a07d272f8101c2404eec64ce8632d846be1e45f0809be15f769ebb3976d4b949db159d9f04f
+  metadata.gz: db0d5224d4442603652a0ad80bbba172ccc9045d1916a2745d798e1ed24456e36726cd8b1060b864d3afa29bb40d01240ec5281160e5ab466e73f7ed903283c9
+  data.tar.gz: e2cf5bc488ef1d5297778d0821a3c755db65924bbacd06a39bb6b62f28a13deb867c10647a120d3973e77df0d05a3360a292612e744f801572f6b1fdd2dbcde9

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-27
+
+### Added
+- `RandomData.array(of:, size:, **opts)` — generate `size` items by repeatedly calling the named generator; forwards keyword options on every call. Raises `Error` for unknown generator names or negative size.
+- `RandomData.seed!(value)` — seeds Ruby's PRNG for deterministic output across subsequent generators (useful for reproducible test runs and golden-file fixtures). `uuid` and `hex` use `SecureRandom` and are not affected.
+
+## [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

data/README.md

@@ -78,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
@@ -96,6 +103,33 @@ Philiprehberger::RandomData.password(length: 8, symbols: false)  # => "kQ7mR2nP"
 Philiprehberger::RandomData.timestamp  # => 2025-08-14 03:22:11 +0000
 ```
 
+### Bulk Generation
+
+`array` calls a generator `size` times and forwards options on every call.
+
+```ruby
+Philiprehberger::RandomData.array(of: :email, size: 3)
+# => ["alice.smith@example.com", "bob_jones@test.com", "carol.lee@demo.com"]
+
+Philiprehberger::RandomData.array(of: :integer, size: 5, range: 1..10)
+# => [3, 8, 1, 6, 9]
+
+Philiprehberger::RandomData.array(of: :address, size: 2)
+# => [{ street: ..., city: ..., state: ..., zip: ... }, ...]
+```
+
+### Deterministic Output
+
+Seed Ruby's PRNG so subsequent calls produce a deterministic sequence. Useful
+for reproducible test runs and golden-file fixtures. `uuid` and `hex` use
+`SecureRandom` and are not affected.
+
+```ruby
+Philiprehberger::RandomData.seed!(42)
+Philiprehberger::RandomData.integer(1..100)  # => deterministic value
+Philiprehberger::RandomData.integer(1..100)  # => deterministic next value
+```
+
 ## API
 
 | Method | Description |
@@ -117,12 +151,15 @@ Philiprehberger::RandomData.timestamp  # => 2025-08-14 03:22:11 +0000
 | `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 |
 | `RandomData.color` | Random hex color string |
 | `RandomData.password(length:, symbols:)` | Random password |
 | `RandomData.timestamp(range)` | Random Time object |
+| `RandomData.array(of:, size:, **opts)` | Generate `size` items by repeatedly calling the named generator; forwards `opts` |
+| `RandomData.seed!(value)` | Seed Ruby's PRNG so subsequent generators are deterministic; returns the previous seed |
 
 ## Development
 

data/lib/philiprehberger/random_data/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module RandomData
-    VERSION = '0.3.0'
+    VERSION = '0.5.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
@@ -211,5 +223,40 @@ module Philiprehberger
         Time.now - rand(0..(365 * 24 * 60 * 60))
       end
     end
+
+    # Generate an array of `size` items by repeatedly calling the named generator.
+    # Extra options are forwarded to the generator on every call.
+    #
+    # @example
+    #   RandomData.array(of: :email, size: 3)
+    #   RandomData.array(of: :integer, size: 5, range: 1..10)
+    #
+    # @param of [Symbol] generator method name (must be a public method on this module other than `array`)
+    # @param size [Integer] number of items to generate (must be >= 0)
+    # @param opts [Hash] keyword arguments forwarded to the generator
+    # @return [Array] generated items
+    # @raise [Error] if `of` is not a known generator or `size` is negative
+    def self.array(of:, size:, **opts)
+      raise Error, 'size must be a non-negative Integer' unless size.is_a?(Integer) && size >= 0
+      raise Error, "unknown generator: #{of}" unless of != :array && respond_to?(of)
+
+      Array.new(size) do
+        opts.empty? ? public_send(of) : public_send(of, **opts)
+      end
+    end
+
+    # Seed Ruby's PRNG so subsequent generators produce a deterministic sequence.
+    # Useful for reproducible test runs and golden-file fixtures. Note that methods
+    # using `SecureRandom` (`uuid`, `hex`) are not affected — they read from the
+    # OS CSPRNG.
+    #
+    # @param value [Integer] seed value
+    # @return [Integer] the previous seed
+    # @raise [Error] if `value` is not an Integer
+    def self.seed!(value)
+      raise Error, 'seed must be an Integer' unless value.is_a?(Integer)
+
+      Kernel.srand(value)
+    end
   end
 end

metadata

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