synthra 0.1.0

data/tech_example/07_rspec_integration.rb

@@ -0,0 +1,359 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ============================================================================
+# FakeDataDSL - RSpec Integration Examples
+# ============================================================================
+# This file demonstrates patterns for using FakeDataDSL with RSpec.
+# Note: This file shows patterns, not actual runnable tests.
+# ============================================================================
+
+puts "=" * 70
+puts "FakeDataDSL RSpec Integration Patterns"
+puts "=" * 70
+puts
+
+# ============================================================================
+# Pattern 1: Basic Test Fixture
+# ============================================================================
+puts "PATTERN 1: Basic Test Fixture"
+puts "-" * 40
+
+puts <<~RUBY
+  # spec/support/fake_data.rb
+  require 'fake_data_dsl'
+  
+  module FakeData
+    def self.registry
+      @registry ||= begin
+        reg = FakeDataDSL::Registry.new
+        reg.load_dir('spec/schemas/')
+        reg
+      end
+    end
+    
+    def self.user(**overrides)
+      registry.schema('User').generate.merge(overrides.transform_keys(&:to_s))
+    end
+    
+    def self.order(**overrides)
+      registry.schema('Order').generate.merge(overrides.transform_keys(&:to_s))
+    end
+  end
+  
+  # In your spec
+  RSpec.describe User do
+    let(:user_data) { FakeData.user }
+    let(:admin_data) { FakeData.user(role: 'admin') }
+    
+    it "creates a valid user" do
+      user = User.new(user_data)
+      expect(user).to be_valid
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 2: Shared Contexts
+# ============================================================================
+puts "PATTERN 2: Shared Contexts"
+puts "-" * 40
+
+puts <<~RUBY
+  # spec/support/shared_contexts/fake_data_context.rb
+  RSpec.shared_context 'with fake data' do
+    let(:registry) do
+      FakeDataDSL::Registry.new.tap do |r|
+        r.load_dir('spec/schemas/')
+      end
+    end
+    
+    let(:user_schema) { registry.schema('User') }
+    let(:order_schema) { registry.schema('Order') }
+    
+    def fake_user(seed: nil, mode: :random, **overrides)
+      data = user_schema.generate(seed: seed, mode: mode)
+      data.merge(overrides.transform_keys(&:to_s))
+    end
+    
+    def fake_users(count, seed: nil, mode: :random)
+      user_schema.generate_many(count, seed: seed, mode: mode)
+    end
+  end
+  
+  # Usage
+  RSpec.describe UsersController do
+    include_context 'with fake data'
+    
+    let(:user) { User.create!(fake_user) }
+    
+    describe "GET #show" do
+      it "returns the user" do
+        get :show, params: { id: user.id }
+        expect(response).to be_successful
+      end
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 3: Deterministic Tests
+# ============================================================================
+puts "PATTERN 3: Deterministic Tests"
+puts "-" * 40
+
+puts <<~RUBY
+  RSpec.describe "Deterministic data generation" do
+    # Use fixed seeds for reproducible tests
+    let(:seed) { 12345 }
+    let(:schema) { FakeDataDSL.load('spec/schemas/user.dsl') }
+    
+    it "generates consistent data with same seed" do
+      user1 = schema.generate(seed: seed)
+      user2 = schema.generate(seed: seed)
+      
+      expect(user1).to eq(user2)
+    end
+    
+    it "generates expected values" do
+      user = schema.generate(seed: 42)
+      
+      # With seed 42, we always get these exact values
+      expect(user['name']).to eq('Expected Name')
+      expect(user['email']).to eq('expected.email@example.com')
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 4: Testing Validation
+# ============================================================================
+puts "PATTERN 4: Testing Validation with Modes"
+puts "-" * 40
+
+puts <<~RUBY
+  RSpec.describe User do
+    let(:schema) { FakeDataDSL.load('spec/schemas/user.dsl') }
+    
+    context "with valid data" do
+      let(:data) { schema.generate(mode: :random) }
+      
+      it "is valid" do
+        expect(User.new(data)).to be_valid
+      end
+    end
+    
+    context "with edge case data" do
+      let(:data) { schema.generate(mode: :edge) }
+      
+      it "handles edge cases gracefully" do
+        user = User.new(data)
+        # May or may not be valid, but shouldn't crash
+        expect { user.validate! }.not_to raise_error(StandardError)
+      end
+    end
+    
+    context "with invalid data" do
+      let(:data) { schema.generate(mode: :invalid) }
+      
+      it "is invalid" do
+        expect(User.new(data)).not_to be_valid
+      end
+    end
+    
+    context "with mixed data" do
+      it "handles variety of inputs" do
+        10.times do
+          data = schema.generate(mode: :mixed)
+          user = User.new(data)
+          expect { user.valid? }.not_to raise_error
+        end
+      end
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 5: Testing API Responses
+# ============================================================================
+puts "PATTERN 5: Testing API Responses"
+puts "-" * 40
+
+puts <<~RUBY
+  # spec/schemas/api_response.dsl
+  # APIResponse:
+  #   @latency 50..200ms
+  #   @failure 5%
+  #   
+  #   success: boolean(true:95%)
+  #   data: User
+  #   meta: ResponseMeta
+  
+  RSpec.describe "API Client" do
+    let(:schema) { FakeDataDSL.load('spec/schemas/api_response.dsl') }
+    
+    it "handles successful responses" do
+      response = schema.generate(mode: :random)
+      
+      if response['success']
+        expect(response['data']).to be_present
+      end
+    end
+    
+    it "handles failures gracefully" do
+      # Force failure mode
+      expect {
+        # Mock to always trigger failure
+        schema.generate # with @failure 100% in test schema
+      }.to raise_error(FakeDataDSL::Errors::SimulatedFailure)
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 6: Property-Based Testing
+# ============================================================================
+puts "PATTERN 6: Property-Based Testing Style"
+puts "-" * 40
+
+puts <<~RUBY
+  RSpec.describe "Property-based testing" do
+    let(:schema) { FakeDataDSL.load('spec/schemas/user.dsl') }
+    
+    it "email always contains @" do
+      100.times do
+        user = schema.generate(mode: :random)
+        expect(user['email']).to include('@')
+      end
+    end
+    
+    it "age is always within range" do
+      100.times do
+        user = schema.generate(mode: :random)
+        expect(user['age']).to be_between(18, 100)
+      end
+    end
+    
+    it "handles any generated data" do
+      [:random, :edge, :invalid, :mixed].each do |mode|
+        10.times do
+          data = schema.generate(mode: mode)
+          
+          # Your code should handle any input without crashing
+          expect { process_user(data) }.not_to raise_error
+        end
+      end
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 7: FactoryBot Replacement
+# ============================================================================
+puts "PATTERN 7: FactoryBot-Style Helpers"
+puts "-" * 40
+
+puts <<~RUBY
+  # spec/support/factories.rb
+  module Factories
+    extend self
+    
+    def registry
+      @registry ||= FakeDataDSL::Registry.new.tap do |r|
+        r.load_dir('spec/schemas/')
+      end
+    end
+    
+    # Build (doesn't save)
+    def build(schema_name, **overrides)
+      data = registry.schema(schema_name.to_s.camelize).generate
+      data.merge(overrides.transform_keys(&:to_s))
+    end
+    
+    # Create (saves to DB)
+    def create(schema_name, **overrides)
+      data = build(schema_name, **overrides)
+      model_class = schema_name.to_s.camelize.constantize
+      model_class.create!(data)
+    end
+    
+    # Build list
+    def build_list(schema_name, count, **overrides)
+      count.times.map { build(schema_name, **overrides) }
+    end
+    
+    # Create list
+    def create_list(schema_name, count, **overrides)
+      count.times.map { create(schema_name, **overrides) }
+    end
+  end
+  
+  # Usage
+  RSpec.configure do |config|
+    config.include Factories
+  end
+  
+  RSpec.describe Order do
+    let(:user) { create(:user) }
+    let(:order) { create(:order, user_id: user.id) }
+    
+    it "belongs to user" do
+      expect(order.user).to eq(user)
+    end
+  end
+RUBY
+puts
+
+# ============================================================================
+# Pattern 8: Request Spec Helpers
+# ============================================================================
+puts "PATTERN 8: Request Spec Helpers"
+puts "-" * 40
+
+puts <<~RUBY
+  # spec/support/request_helpers.rb
+  module RequestHelpers
+    def fake_json_body(schema_name, **overrides)
+      schema = FakeDataDSL.load("spec/schemas/\#{schema_name}.dsl")
+      data = schema.generate.merge(overrides.transform_keys(&:to_s))
+      data.to_json
+    end
+    
+    def post_fake_data(path, schema_name, **overrides)
+      post path,
+           params: fake_json_body(schema_name, **overrides),
+           headers: { 'Content-Type' => 'application/json' }
+    end
+  end
+  
+  RSpec.configure do |config|
+    config.include RequestHelpers, type: :request
+  end
+  
+  # Usage
+  RSpec.describe "Users API", type: :request do
+    describe "POST /users" do
+      it "creates a user" do
+        post_fake_data('/api/users', :user)
+        expect(response).to have_http_status(:created)
+      end
+      
+      it "creates an admin" do
+        post_fake_data('/api/users', :user, role: 'admin')
+        expect(json_response['role']).to eq('admin')
+      end
+    end
+  end
+RUBY
+puts
+
+puts "=" * 70
+puts "RSpec integration patterns demonstrated!"
+puts "=" * 70
+