philiprehberger-random_data 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a441239782445bb54655de85c9b1b25a999bd599db30de5d65f51fb10c4c86fc
+  data.tar.gz: 7f3433b2b1ceb2964fd61d955db4ff8033ac6600b21cdcca5c4cb90c5a35c640
+SHA512:
+  metadata.gz: 6aac8842fc9f6de9dd5112cd167099e1b6bac5ee2d183101ba0ca8cbde6501f251bfe22d734bb23edd66dab9e44a14bd9850b69293eb31257249fffb1338b26f
+  data.tar.gz: f8e442d3a4078607e5e9fe88be0c08c6b60ecf770c3302566977aad033970607d1531c98b9624aecacaaf43b308cd00bd01fc196c6470031710c3bf698d5a3c7

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this gem will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-22
+
+### Added
+- Initial release
+- Random name generation with 50 first names and 50 last names
+- Random email and phone number generation
+- UUID v4 generation
+- Lorem ipsum sentence and paragraph generation
+- Random integer, float, date, and boolean generation
+- Hex string generation
+- Array pick and sample methods
+- Random IPv4 address generation

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,103 @@
+# philiprehberger-random_data
+
+[![Tests](https://github.com/philiprehberger/rb-random-data/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-random-data/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/philiprehberger-random_data.svg)](https://rubygems.org/gems/philiprehberger-random_data)
+[![License](https://img.shields.io/github/license/philiprehberger/rb-random-data)](LICENSE)
+
+Lightweight random test data generator for names, emails, and common types. Includes 50 first names, 50 last names, and lorem ipsum words for realistic test fixtures.
+
+## Requirements
+
+- Ruby >= 3.1
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'philiprehberger-random_data'
+```
+
+Or install directly:
+
+```bash
+gem install philiprehberger-random_data
+```
+
+## Usage
+
+```ruby
+require 'philiprehberger/random_data'
+
+Philiprehberger::RandomData.name        # => "Jessica Martinez"
+Philiprehberger::RandomData.first_name  # => "Robert"
+Philiprehberger::RandomData.last_name   # => "Johnson"
+Philiprehberger::RandomData.email       # => "mary_smith@example.com"
+Philiprehberger::RandomData.phone       # => "(555) 123-4567"
+Philiprehberger::RandomData.uuid        # => "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+```
+
+### Text
+
+```ruby
+Philiprehberger::RandomData.sentence    # => "Lorem ipsum dolor sit amet."
+Philiprehberger::RandomData.paragraph   # => "Consectetur adipiscing elit..."
+Philiprehberger::RandomData.sentence(words: 5)  # => "Lorem ipsum dolor sit amet."
+```
+
+### Numbers and Dates
+
+```ruby
+Philiprehberger::RandomData.integer(1..100)  # => 42
+Philiprehberger::RandomData.float(0.0..1.0)  # => 0.7342
+Philiprehberger::RandomData.date             # => #<Date: 2026-01-15>
+Philiprehberger::RandomData.boolean          # => true
+Philiprehberger::RandomData.hex(8)           # => "a3f7b2c1"
+```
+
+### Collections
+
+```ruby
+colors = %w[red green blue yellow]
+Philiprehberger::RandomData.pick(colors)       # => "green"
+Philiprehberger::RandomData.sample(colors, 2)  # => ["blue", "red"]
+```
+
+### Network
+
+```ruby
+Philiprehberger::RandomData.ipv4  # => "192.45.67.123"
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `RandomData.name` | Random full name |
+| `RandomData.first_name` | Random first name |
+| `RandomData.last_name` | Random last name |
+| `RandomData.email` | Random email address |
+| `RandomData.phone` | Random phone number |
+| `RandomData.uuid` | Random UUID v4 |
+| `RandomData.sentence(words:)` | Random lorem ipsum sentence |
+| `RandomData.paragraph(sentences:)` | Random paragraph |
+| `RandomData.integer(range)` | Random integer in range |
+| `RandomData.float(range)` | Random float in range |
+| `RandomData.date(range)` | Random date in range |
+| `RandomData.boolean` | Random true or false |
+| `RandomData.hex(length)` | Random hex string |
+| `RandomData.pick(array)` | Random element from array |
+| `RandomData.sample(array, n)` | Random n elements from array |
+| `RandomData.ipv4` | Random IPv4 address |
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec      # Run tests
+bundle exec rubocop    # Check code style
+```
+
+## License
+
+MIT

data/lib/philiprehberger/random_data/data.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  module RandomData
+    FIRST_NAMES = %w[
+      James Mary Robert Patricia John Jennifer Michael Linda David Elizabeth
+      William Barbara Richard Susan Joseph Jessica Thomas Sarah Charles Karen
+      Christopher Lisa Daniel Nancy Matthew Betty Mark Sandra Donald Ashley
+      Steven Emily Paul Kimberly Andrew Donna Joshua Michelle Kenneth Dorothy
+      Kevin Carol Brian Amanda George Melissa Edward Deborah Ronald Stephanie
+    ].freeze
+
+    LAST_NAMES = %w[
+      Smith Johnson Williams Brown Jones Garcia Miller Davis Rodriguez Martinez
+      Hernandez Lopez Gonzalez Wilson Anderson Thomas Taylor Moore Jackson Martin
+      Lee Perez Thompson White Harris Sanchez Clark Ramirez Lewis Robinson Walker
+      Young Allen King Wright Scott Torres Nguyen Hill Flores Green Adams Nelson
+      Baker Hall Rivera Campbell Mitchell Carter Roberts Gomez Phillips Evans
+    ].freeze
+
+    LOREM_WORDS = %w[
+      lorem ipsum dolor sit amet consectetur adipiscing elit sed do eiusmod
+      tempor incididunt ut labore et dolore magna aliqua enim ad minim veniam
+      quis nostrud exercitation ullamco laboris nisi aliquip ex ea commodo
+      consequat duis aute irure in reprehenderit voluptate velit esse cillum
+      fugiat nulla pariatur excepteur sint occaecat cupidatat non proident sunt
+      culpa qui officia deserunt mollit anim id est
+    ].freeze
+
+    EMAIL_DOMAINS = %w[
+      example.com test.com mail.test sample.org demo.net
+    ].freeze
+
+    PHONE_FORMATS = [
+      '(###) ###-####',
+      '###-###-####',
+      '+1 ### ### ####'
+    ].freeze
+  end
+end

data/lib/philiprehberger/random_data/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Philiprehberger
+  module RandomData
+    VERSION = '0.1.0'
+  end
+end

data/lib/philiprehberger/random_data.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+require 'date'
+require_relative 'random_data/version'
+require_relative 'random_data/data'
+
+module Philiprehberger
+  module RandomData
+    class Error < StandardError; end
+
+    # Generate a random full name
+    #
+    # @return [String] first and last name
+    def self.name
+      "#{first_name} #{last_name}"
+    end
+
+    # Generate a random first name
+    #
+    # @return [String] first name
+    def self.first_name
+      FIRST_NAMES.sample
+    end
+
+    # Generate a random last name
+    #
+    # @return [String] last name
+    def self.last_name
+      LAST_NAMES.sample
+    end
+
+    # Generate a random email address
+    #
+    # @return [String] email address
+    def self.email
+      fn = first_name.downcase
+      ln = last_name.downcase
+      domain = EMAIL_DOMAINS.sample
+      separator = ['.', '_', ''].sample
+      "#{fn}#{separator}#{ln}@#{domain}"
+    end
+
+    # Generate a random phone number
+    #
+    # @return [String] formatted phone number
+    def self.phone
+      format = PHONE_FORMATS.sample
+      format.gsub('#') { rand(10).to_s }
+    end
+
+    # Generate a random UUID v4
+    #
+    # @return [String] UUID string
+    def self.uuid
+      SecureRandom.uuid
+    end
+
+    # Generate a random sentence
+    #
+    # @param words [Integer] number of words
+    # @return [String] sentence with capitalized first word and period
+    def self.sentence(words: rand(5..15))
+      selected = Array.new(words) { LOREM_WORDS.sample }
+      selected[0] = selected[0].capitalize
+      "#{selected.join(' ')}."
+    end
+
+    # Generate a random paragraph
+    #
+    # @param sentences [Integer] number of sentences
+    # @return [String] paragraph of sentences
+    def self.paragraph(sentences: rand(3..7))
+      Array.new(sentences) { sentence }.join(' ')
+    end
+
+    # Generate a random integer within a range
+    #
+    # @param range [Range] range of integers
+    # @return [Integer] random integer
+    def self.integer(range = 0..100)
+      rand(range)
+    end
+
+    # Generate a random float within a range
+    #
+    # @param range [Range] range of floats
+    # @return [Float] random float
+    def self.float(range = 0.0..1.0)
+      min = range.min.to_f
+      max = range.max.to_f
+      min + rand * (max - min)
+    end
+
+    # Generate a random date within a range
+    #
+    # @param range [Range<Date>] range of dates
+    # @return [Date] random date
+    def self.date(range = nil)
+      if range
+        start_date = range.min
+        end_date = range.max
+        days = (end_date - start_date).to_i
+        start_date + rand(0..days)
+      else
+        today = Date.today
+        today - rand(0..365)
+      end
+    end
+
+    # Generate a random boolean
+    #
+    # @return [Boolean] true or false
+    def self.boolean
+      [true, false].sample
+    end
+
+    # Generate a random hex string
+    #
+    # @param length [Integer] number of hex characters
+    # @return [String] hex string
+    def self.hex(length = 16)
+      SecureRandom.hex(length / 2 + 1)[0, length]
+    end
+
+    # Pick a random element from an array
+    #
+    # @param array [Array] source array
+    # @return [Object] random element
+    def self.pick(array)
+      raise Error, 'Array must not be empty' if array.nil? || array.empty?
+
+      array.sample
+    end
+
+    # Sample n random elements from an array
+    #
+    # @param array [Array] source array
+    # @param n [Integer] number of elements
+    # @return [Array] random elements
+    def self.sample(array, n)
+      raise Error, 'Array must not be empty' if array.nil? || array.empty?
+
+      array.sample(n)
+    end
+
+    # Generate a random IPv4 address
+    #
+    # @return [String] IPv4 address
+    def self.ipv4
+      Array.new(4) { rand(1..254) }.join('.')
+    end
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: philiprehberger-random_data
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- philiprehberger
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-22 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
+  names, and lorem ipsum words for realistic test fixtures.
+email:
+- philiprehberger@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/philiprehberger/random_data.rb
+- lib/philiprehberger/random_data/data.rb
+- lib/philiprehberger/random_data/version.rb
+homepage: https://github.com/philiprehberger/rb-random-data
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/philiprehberger/rb-random-data
+  source_code_uri: https://github.com/philiprehberger/rb-random-data
+  changelog_uri: https://github.com/philiprehberger/rb-random-data/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Lightweight random test data generator for names, emails, and common types
+test_files: []