synthra 0.1.0

data/tech_example/01_basic_usage.rb

@@ -0,0 +1,238 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ============================================================================
+# FakeDataDSL - Basic Usage Examples
+# ============================================================================
+# This file demonstrates the fundamental usage patterns of FakeDataDSL.
+# Run with: cd fake_data_dsl && ruby tech_example/01_basic_usage.rb
+# ============================================================================
+
+# Load the local gem
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'fake_data_dsl'
+require 'json'
+
+puts "=" * 70
+puts "FakeDataDSL Basic Usage Examples"
+puts "=" * 70
+puts
+
+# ============================================================================
+# Example 1: Inline Schema Definition
+# ============================================================================
+puts "1. INLINE SCHEMA DEFINITION"
+puts "-" * 40
+
+schema = FakeDataDSL.parse(<<~DSL)
+  User:
+    id: uuid
+    name: name
+    email: email
+    age: number(18..65)
+    active: boolean
+DSL
+
+user = schema.generate
+puts "Generated User:"
+puts JSON.pretty_generate(user)
+puts
+
+# ============================================================================
+# Example 2: Generate Multiple Records
+# ============================================================================
+puts "2. GENERATE MULTIPLE RECORDS"
+puts "-" * 40
+
+users = schema.generate_many(5)
+puts "Generated #{users.length} users:"
+users.each_with_index do |u, i|
+  puts "  #{i + 1}. #{u['name']} (#{u['email']})"
+end
+puts
+
+# ============================================================================
+# Example 3: Deterministic Generation with Seeds
+# ============================================================================
+puts "3. DETERMINISTIC GENERATION (Seeds)"
+puts "-" * 40
+
+# Same seed produces same output
+user1 = schema.generate(seed: 12345)
+user2 = schema.generate(seed: 12345)
+
+puts "Seed 12345 - First generation:"
+puts "  Name: #{user1['name']}, Age: #{user1['age']}"
+puts "Seed 12345 - Second generation:"
+puts "  Name: #{user2['name']}, Age: #{user2['age']}"
+puts "Are they identical? #{user1 == user2}"
+puts
+
+# ============================================================================
+# Example 4: Different Generation Modes
+# ============================================================================
+puts "4. GENERATION MODES"
+puts "-" * 40
+
+# Random mode (default) - typical values
+random_user = schema.generate(mode: :random)
+puts "Random mode:  age=#{random_user['age']}, active=#{random_user['active']}"
+
+# Edge mode - boundary values
+edge_user = schema.generate(mode: :edge)
+puts "Edge mode:    age=#{edge_user['age']}, active=#{edge_user['active']}"
+
+# Invalid mode - invalid data for testing
+invalid_user = schema.generate(mode: :invalid)
+puts "Invalid mode: age=#{invalid_user['age'].inspect}, active=#{invalid_user['active'].inspect}"
+puts
+
+# ============================================================================
+# Example 5: JSON Output
+# ============================================================================
+puts "5. JSON OUTPUT"
+puts "-" * 40
+
+# Compact JSON
+compact = schema.generate_json
+puts "Compact JSON (truncated):"
+puts "  #{compact[0..80]}..."
+
+# Pretty JSON
+pretty = schema.generate_json(pretty: true)
+puts "Pretty JSON:"
+puts pretty.lines.map { |l| "  #{l}" }.join
+puts
+
+# ============================================================================
+# Example 6: Complex Schema with Multiple Types
+# ============================================================================
+puts "6. COMPLEX SCHEMA"
+puts "-" * 40
+
+complex_schema = FakeDataDSL.parse(<<~DSL)
+  Product:
+    id: uuid
+    name: text(10..50)
+    description: text(50..200)
+    price: number(9.99..999.99)
+    currency: currency
+    category: enum(electronics, clothing, home, sports)
+    in_stock: boolean(true:80%)
+    rating: number(1.0..5.0)
+    created_at: past_date(1y)
+DSL
+
+product = complex_schema.generate
+puts "Generated Product:"
+puts JSON.pretty_generate(product)
+puts
+
+# ============================================================================
+# Example 7: Schema with Optional and Nullable Fields
+# ============================================================================
+puts "7. OPTIONAL AND NULLABLE FIELDS"
+puts "-" * 40
+
+profile_schema = FakeDataDSL.parse(<<~DSL)
+  Profile:
+    user_id: uuid
+    display_name: name
+    bio?: text(50..200)
+    website?: url
+    phone: phone?
+DSL
+
+# Generate several to show optionality
+puts "Generated 5 profiles (showing optional fields):"
+5.times do |i|
+  profile = profile_schema.generate
+  puts "  #{i + 1}. bio: #{profile.key?('bio') ? 'present' : 'absent'}, " \
+       "website: #{profile.key?('website') ? 'present' : 'absent'}, " \
+       "phone: #{profile['phone'].nil? ? 'null' : 'present'}"
+end
+puts
+
+# ============================================================================
+# Example 8: Nested Schemas
+# ============================================================================
+puts "8. NESTED SCHEMAS"
+puts "-" * 40
+
+nested_schema = FakeDataDSL.parse(<<~DSL)
+  Order:
+    id: uuid
+    customer_name: name
+    total: number(10..500)
+    status: enum(pending, shipped, delivered)
+
+  Address:
+    street: text(10..50)
+    city: name
+    country: country_code
+    postal_code: postal_code
+DSL
+
+order = nested_schema.generate
+puts "Generated Order:"
+puts JSON.pretty_generate(order)
+puts
+
+# ============================================================================
+# Example 9: Enum with Weighted Probabilities
+# ============================================================================
+puts "9. WEIGHTED ENUMS"
+puts "-" * 40
+
+weighted_schema = FakeDataDSL.parse(<<~DSL)
+  Subscription:
+    id: uuid
+    plan: enum(free:70%, basic:20%, premium:8%, enterprise:2%)
+    status: enum(active:90%, cancelled:5%, suspended:5%)
+DSL
+
+# Generate many to see distribution
+plan_counts = Hash.new(0)
+status_counts = Hash.new(0)
+
+1000.times do
+  sub = weighted_schema.generate
+  plan_counts[sub['plan']] += 1
+  status_counts[sub['status']] += 1
+end
+
+puts "Plan distribution (1000 samples):"
+plan_counts.sort_by { |_, v| -v }.each do |plan, count|
+  puts "  #{plan}: #{count} (#{(count / 10.0).round(1)}%)"
+end
+
+puts "Status distribution (1000 samples):"
+status_counts.sort_by { |_, v| -v }.each do |status, count|
+  puts "  #{status}: #{count} (#{(count / 10.0).round(1)}%)"
+end
+puts
+
+# ============================================================================
+# Example 10: Date and Time Types
+# ============================================================================
+puts "10. DATE AND TIME TYPES"
+puts "-" * 40
+
+time_schema = FakeDataDSL.parse(<<~DSL)
+  Event:
+    id: uuid
+    name: text(10..30)
+    scheduled_at: timestamp
+    created_at: past_date(1y)
+    reminder_at: future_date(30d)
+DSL
+
+event = time_schema.generate
+puts "Generated Event:"
+puts JSON.pretty_generate(event)
+puts
+
+puts "=" * 70
+puts "Examples completed successfully!"
+puts "=" * 70
+

data/tech_example/02_types_demo.rb

@@ -0,0 +1,336 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ============================================================================
+# FakeDataDSL - All Types Demonstration
+# ============================================================================
+# This file demonstrates all built-in types available in FakeDataDSL.
+# Run with: cd fake_data_dsl && ruby tech_example/02_types_demo.rb
+# ============================================================================
+
+# Load the local gem
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'fake_data_dsl'
+require 'json'
+
+puts "=" * 70
+puts "FakeDataDSL Types Demonstration"
+puts "=" * 70
+puts
+
+# ============================================================================
+# IDENTIFIER TYPES
+# ============================================================================
+puts "IDENTIFIER TYPES"
+puts "-" * 40
+
+id_schema = FakeDataDSL.parse(<<~DSL)
+  Identifiers:
+    uuid_v4: uuid
+    uuid_v7: uuid(version: 7)
+    ulid: ulid
+    sequence_id: id_sequence
+DSL
+
+puts "Generated Identifiers:"
+ids = id_schema.generate
+puts JSON.pretty_generate(ids)
+puts
+
+# ============================================================================
+# TEXT TYPES
+# ============================================================================
+puts "TEXT TYPES"
+puts "-" * 40
+
+text_schema = FakeDataDSL.parse(<<~DSL)
+  TextTypes:
+    text_default: text
+    text_range: text(10..50)
+    text_exact: text(20)
+    paragraph: paragraph
+    sentence: sentence
+    word: word
+    words_multiple: words
+DSL
+
+puts "Generated Text Types:"
+texts = text_schema.generate
+puts JSON.pretty_generate(texts)
+puts
+
+# ============================================================================
+# PERSONAL DATA TYPES
+# ============================================================================
+puts "PERSONAL DATA TYPES"
+puts "-" * 40
+
+personal_schema = FakeDataDSL.parse(<<~DSL)
+  PersonalData:
+    full_name: name
+    first_name: first_name
+    last_name: last_name
+    email: email
+    username: username
+    phone: phone
+    avatar: avatar
+DSL
+
+puts "Generated Personal Data:"
+personal = personal_schema.generate
+puts JSON.pretty_generate(personal)
+puts
+
+# ============================================================================
+# NUMBER TYPES
+# ============================================================================
+puts "NUMBER TYPES"
+puts "-" * 40
+
+number_schema = FakeDataDSL.parse(<<~DSL)
+  Numbers:
+    integer: number(0..100)
+    float: number(0.0..100.0)
+    price: number(9.99..999.99)
+    percentage: number(0..100)
+    latitude: latitude
+    longitude: longitude
+DSL
+
+puts "Generated Numbers:"
+numbers = number_schema.generate
+puts JSON.pretty_generate(numbers)
+puts
+
+# ============================================================================
+# BOOLEAN AND ENUM TYPES
+# ============================================================================
+puts "BOOLEAN AND ENUM TYPES"
+puts "-" * 40
+
+choice_schema = FakeDataDSL.parse(<<~DSL)
+  Choices:
+    is_active: boolean
+    is_verified: boolean(true:90%)
+    status: enum(active, inactive, pending)
+    role: enum(user:70%, admin:20%, superadmin:10%)
+    color: enum(red, green, blue, yellow, orange)
+DSL
+
+puts "Generated Choices:"
+choices = choice_schema.generate
+puts JSON.pretty_generate(choices)
+puts
+
+# ============================================================================
+# DATE AND TIME TYPES
+# ============================================================================
+puts "DATE AND TIME TYPES"
+puts "-" * 40
+
+datetime_schema = FakeDataDSL.parse(<<~DSL)
+  DateTimes:
+    date: date
+    past_date_1y: past_date(1y)
+    past_date_30d: past_date(30d)
+    future_date_6m: future_date(6m)
+    future_date_1y: future_date(1y)
+    timestamp: timestamp
+    now: now
+DSL
+
+puts "Generated Date/Times:"
+datetimes = datetime_schema.generate
+puts JSON.pretty_generate(datetimes)
+puts
+
+# ============================================================================
+# LOCATION TYPES
+# ============================================================================
+puts "LOCATION TYPES"
+puts "-" * 40
+
+location_schema = FakeDataDSL.parse(<<~DSL)
+  Locations:
+    address: address
+    city: city
+    country: country
+    country_code: country_code
+    postal_code: postal_code
+    state: state
+    street_address: street_address
+    time_zone: time_zone
+DSL
+
+puts "Generated Locations:"
+locations = location_schema.generate
+puts JSON.pretty_generate(locations)
+puts
+
+# ============================================================================
+# TECHNOLOGY TYPES
+# ============================================================================
+puts "TECHNOLOGY TYPES"
+puts "-" * 40
+
+tech_schema = FakeDataDSL.parse(<<~DSL)
+  Technology:
+    url: url
+    domain: domain
+    ip: ip
+    ipv6: ipv6
+    mac_address: mac_address
+    user_agent: user_agent
+DSL
+
+puts "Generated Technology Data:"
+tech = tech_schema.generate
+puts JSON.pretty_generate(tech)
+puts
+
+# ============================================================================
+# FINANCE TYPES
+# ============================================================================
+puts "FINANCE TYPES"
+puts "-" * 40
+
+finance_schema = FakeDataDSL.parse(<<~DSL)
+  Finance:
+    currency: currency
+    currency_code: currency_code
+    iban: iban
+    credit_card: credit_card
+    bank_name: bank_name
+DSL
+
+puts "Generated Finance Data:"
+finance = finance_schema.generate
+puts JSON.pretty_generate(finance)
+puts
+
+# ============================================================================
+# CRYPTO TYPES
+# ============================================================================
+puts "CRYPTO TYPES"
+puts "-" * 40
+
+crypto_schema = FakeDataDSL.parse(<<~DSL)
+  Crypto:
+    bitcoin_address: bitcoin_address
+    ethereum_address: ethereum_address
+    hash_md5: hash
+DSL
+
+puts "Generated Crypto Data:"
+crypto = crypto_schema.generate
+puts JSON.pretty_generate(crypto)
+puts
+
+# ============================================================================
+# CONTENT TYPES
+# ============================================================================
+puts "CONTENT TYPES"
+puts "-" * 40
+
+content_schema = FakeDataDSL.parse(<<~DSL)
+  Content:
+    title: title
+    company_name: company_name
+    job_title: job_title
+    buzzword: buzzword
+    color: color
+    color_hex: color_hex
+DSL
+
+puts "Generated Content:"
+content = content_schema.generate
+puts JSON.pretty_generate(content)
+puts
+
+# ============================================================================
+# HEALTH/MEDICAL TYPES
+# ============================================================================
+puts "HEALTH/MEDICAL TYPES"
+puts "-" * 40
+
+health_schema = FakeDataDSL.parse(<<~DSL)
+  Health:
+    blood_type: blood_type
+DSL
+
+puts "Generated Health Data:"
+health = health_schema.generate
+puts JSON.pretty_generate(health)
+puts
+
+# ============================================================================
+# TRAVEL TYPES
+# ============================================================================
+puts "TRAVEL TYPES"
+puts "-" * 40
+
+travel_schema = FakeDataDSL.parse(<<~DSL)
+  Travel:
+    airport_code: airport_code
+    airline: airline
+    flight_number: flight_number
+DSL
+
+puts "Generated Travel Data:"
+travel = travel_schema.generate
+puts JSON.pretty_generate(travel)
+puts
+
+# ============================================================================
+# COMPREHENSIVE TYPE SHOWCASE
+# ============================================================================
+puts "=" * 70
+puts "COMPREHENSIVE TYPE SHOWCASE"
+puts "=" * 70
+
+comprehensive_schema = FakeDataDSL.parse(<<~DSL)
+  CompleteUser:
+    # Identifiers
+    id: uuid(unique: true)
+    ulid: ulid
+    
+    # Personal
+    name: name
+    email: email
+    phone: phone
+    username: username
+    avatar: avatar
+    
+    # Profile
+    bio: text(50..200)
+    website: url
+    
+    # Location
+    country: country_code
+    city: city
+    postal_code: postal_code
+    
+    # Work
+    company: company_name
+    job_title: job_title
+    
+    # Account
+    status: enum(active:80%, inactive:15%, banned:5%)
+    role: enum(user:70%, admin:20%, superadmin:10%)
+    verified: boolean(true:60%)
+    
+    # Dates
+    created_at: past_date(2y)
+    updated_at: past_date(30d)
+    last_login: past_date(7d)
+DSL
+
+puts "Complete User Profile:"
+complete_user = comprehensive_schema.generate
+puts JSON.pretty_generate(complete_user)
+puts
+
+puts "=" * 70
+puts "Types demonstration completed!"
+puts "=" * 70
+