philiprehberger-random_data 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66b3892c4c67cf116d9f415c2f15f9351e9fc9ecc907fcd052d93db04c2da69c
-  data.tar.gz: 25f7bd4d5907d4350dc5d9381781b6c47f694e4df593c48ef80347147fd97ad8
+  metadata.gz: 50f3c7612e67e7214cf57ff2af61567a21efad6111cad8d097801e13fa49b46d
+  data.tar.gz: 718650040993a0556ce4185768c577fcd74aa221dfcf46e222c9ed8108798347
 SHA512:
-  metadata.gz: 4ea172d1596e1f5c28aa06cef63822fec2202f4a176c526f4f132a5aedd13bbb0db6bda54740ef11fbfbbafb6242e7b2693cc22f89e1a547fb09cf3fa241ccd7
-  data.tar.gz: 127842bc07223d27f397348d79ebec2dda96e32a588b13119748070bb89054b9719714e6744c33a3b0e57df82eda1eca154c7ebc116474a628e397e3da611367
+  metadata.gz: db0d5224d4442603652a0ad80bbba172ccc9045d1916a2745d798e1ed24456e36726cd8b1060b864d3afa29bb40d01240ec5281160e5ab466e73f7ed903283c9
+  data.tar.gz: e2cf5bc488ef1d5297778d0821a3c755db65924bbacd06a39bb6b62f28a13deb867c10647a120d3973e77df0d05a3360a292612e744f801572f6b1fdd2dbcde9

data/CHANGELOG.md

@@ -7,6 +7,12 @@ 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

data/README.md

@@ -103,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 |
@@ -131,6 +158,8 @@ Philiprehberger::RandomData.timestamp  # => 2025-08-14 03:22:11 +0000
 | `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.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/random_data.rb

@@ -223,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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-24 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