lazy_init 0.1.1 → 0.2.0

data/benchmarks/benchmark_performance.rb

@@ -1,68 +1,5 @@
 require 'benchmark'
-require 'lazy_init'
-
-
-# LazyInit vs Manual Performance Benchmark
-# Testing with realistic production-like expensive operations:
-
-# --- Configuration Parsing ---
-# Description: JSON/YAML parsing with complex nested structures
-
-# Warming up (performing actual expensive computation)...
-# Initial computation time:
-#   Manual: 14.25ms
-#   LazyInit: 13.28ms
-#   Difference: -0.96ms
-
-# Benchmarking cached access (100,000 iterations):
-#                  user     system      total        real
-# Manual       0.012272   0.000034   0.012306 (  0.012490)
-# LazyInit     0.041375   0.000231   0.041606 (  0.041994)
-
-# ============================================================
-
-# --- Cryptographic Operations ---
-# Description: Secure token generation with multiple hash rounds
-
-# Warming up (performing actual expensive computation)...
-# Initial computation time:
-#   Manual: 4.65ms
-#   LazyInit: 2.37ms
-#   Difference: -2.28ms
-
-# Benchmarking cached access (100,000 iterations):
-#                  user     system      total        real
-# Manual       0.012351   0.000057   0.012408 (  0.012445)
-# LazyInit     0.042226   0.000220   0.042446 (  0.042752)
-
-# ============================================================
-
-# --- Data Processing ---
-# Description: ETL-style data aggregation and grouping
-
-# Warming up (performing actual expensive computation)...
-# Initial computation time:
-#   Manual: 2.61ms
-#   LazyInit: 2.84ms
-#   Difference: 0.22ms
-
-# Benchmarking cached access (100,000 iterations):
-#                  user     system      total        real
-# Manual       0.012233   0.000048   0.012281 (  0.012375)
-# LazyInit     0.044622   0.000262   0.044884 (  0.045389)
-
-# ============================================================
-
-# Thread Safety Test
-# Testing concurrent access to verify no race conditions...
-# Computing in thread: 60
-# Thread safety results:
-#   Unique object IDs: 1 (should be 1)
-#   All threads got same object: ✅ PASS
-#   Total threads: 10
-# Test Environment: Ruby 3.0.2, x86_64
-# Platform: x86_64-darwin19
-#✅ Thread safety confirmed: All threads received the same computed object
+require_relative '../lib/lazy_init.rb'
 
 module ExpensiveOperations
   def parse_configuration
@@ -244,7 +181,7 @@ puts "Test Environment: Ruby #{RUBY_VERSION}, #{RbConfig::CONFIG['target_cpu']}"
 puts "Platform: #{RUBY_PLATFORM}"
 
 if results.uniq.size == 1
-  puts "\n✅ Thread safety confirmed: All threads received the same computed object"
+  puts "\n Thread safety confirmed: All threads received the same computed object"
 else
-  puts "\n❌ Thread safety failed: Race condition detected!"
+  puts "\n Thread safety failed: Race condition detected!"
 end

data/benchmarks/benchmark_threads.rb

@@ -114,60 +114,60 @@ module ProductionOperations
       host: 'prod-db.company.com',
       port: 5432,
       pool_size: 20,
-      connections: Array.new(20) { |i| "conn_#{i}_#{rand(10000)}" }
+      connections: Array.new(20) { |i| "conn_#{i}_#{rand(10_000)}" }
     }
   end
-  
+
   def create_connection_pool
     puts "Creating connection pool in thread: #{Thread.current.object_id}"
     sleep(0.2)
-    pool_id = rand(100000)
+    pool_id = rand(100_000)
     {
       id: pool_id,
       connections: Array.new(50) { |i| "active_conn_#{pool_id}_#{i}" },
       created_at: Time.now
     }
   end
-  
+
   def fetch_user_permissions
     puts "Fetching permissions in thread: #{Thread.current.object_id}"
     sleep(0.15)
     permissions = {}
-    (1..1000).each { |i| permissions["user_#{i}"] = ["read", "write", "admin"].sample }
+    (1..1000).each { |i| permissions["user_#{i}"] = %w[read write admin].sample }
     permissions
   end
-  
+
   def initialize_api_client
-    puts "Initializing API client in thread: #{Thread.current.object_id}"  
+    puts "Initializing API client in thread: #{Thread.current.object_id}"
     sleep(0.08)
     {
-      client_id: "api_#{rand(50000)}",
-      token: "bearer_#{rand(1000000)}",
+      client_id: "api_#{rand(50_000)}",
+      token: "bearer_#{rand(1_000_000)}",
       endpoints: %w[users orders payments analytics],
       initialized_at: Time.now
     }
   end
 end
 
-puts " ===  THREAD SAFETY TESTS ==="
+puts ' ===  THREAD SAFETY TESTS ==='
 puts "Testing LazyInit in production-like concurrent scenarios\n\n"
 
-puts " TEST 1: Traffic Spike Simulation"
-puts "Simulating 200 simultaneous user requests hitting cached resources"
-puts "-" * 60
+puts ' TEST 1: Traffic Spike Simulation'
+puts 'Simulating 200 simultaneous user requests hitting cached resources'
+puts '-' * 60
 
 class TrafficSpikeService
   extend LazyInit
   include ProductionOperations
-  
+
   lazy_attr_reader :db_config do
     load_database_config
   end
-  
+
   lazy_attr_reader :connection_pool do
-    create_connection_pool  
+    create_connection_pool
   end
-  
+
   lazy_attr_reader :user_permissions do
     fetch_user_permissions
   end
@@ -177,26 +177,24 @@ spike_service = TrafficSpikeService.new
 spike_results = []
 spike_errors = []
 
-puts "Starting traffic spike test..."
+puts 'Starting traffic spike test...'
 start_time = Time.now
 
 spike_threads = 200.times.map do |i|
   Thread.new do
-    begin
-      config = spike_service.db_config
-      pool = spike_service.connection_pool  
-      permissions = spike_service.user_permissions
-      
-      spike_results << {
-        thread: i,
-        config_id: config.object_id,
-        pool_id: pool.object_id,
-        permissions_id: permissions.object_id,
-        timestamp: Time.now
-      }
-    rescue => e
-      spike_errors << { thread: i, error: e.message }
-    end
+    config = spike_service.db_config
+    pool = spike_service.connection_pool
+    permissions = spike_service.user_permissions
+
+    spike_results << {
+      thread: i,
+      config_id: config.object_id,
+      pool_id: pool.object_id,
+      permissions_id: permissions.object_id,
+      timestamp: Time.now
+    }
+  rescue StandardError => e
+    spike_errors << { thread: i, error: e.message }
   end
 end
 
@@ -210,7 +208,7 @@ puts "  Successful requests: #{spike_results.size}"
 puts "  Errors: #{spike_errors.size}"
 
 config_ids = spike_results.map { |r| r[:config_id] }.uniq
-pool_ids = spike_results.map { |r| r[:pool_id] }.uniq  
+pool_ids = spike_results.map { |r| r[:pool_id] }.uniq
 permission_ids = spike_results.map { |r| r[:permissions_id] }.uniq
 
 puts "\n Race Condition Analysis:"
@@ -221,20 +219,20 @@ puts "  Permissions - Unique objects: #{permission_ids.size} (should be 1)"
 spike_passed = config_ids.size == 1 && pool_ids.size == 1 && permission_ids.size == 1
 puts "  Result: #{spike_passed ? '✅ PASS' : '❌ FAIL'} - No race conditions detected"
 
-puts "\n" + "="*60 + "\n"
+puts "\n" + '=' * 60 + "\n"
 
-puts "TEST 2: Sustained Load Simulation"  
-puts "Simulating background workers with sustained concurrent access"
-puts "-" * 60
+puts 'TEST 2: Sustained Load Simulation'
+puts 'Simulating background workers with sustained concurrent access'
+puts '-' * 60
 
 class WorkerService
   extend LazyInit
   include ProductionOperations
-  
+
   lazy_attr_reader :api_client do
     initialize_api_client
   end
-  
+
   lazy_attr_reader :shared_cache do
     fetch_user_permissions
   end
@@ -244,29 +242,27 @@ worker_service = WorkerService.new
 worker_results = []
 worker_errors = []
 
-puts "Starting sustained load test (30 workers x 50 operations each)..."
+puts 'Starting sustained load test (30 workers x 50 operations each)...'
 
 worker_threads = 30.times.map do |worker_id|
   Thread.new do
     thread_results = []
     50.times do |operation|
-      begin
-        api = worker_service.api_client
-        cache = worker_service.shared_cache
-        
-        thread_results << {
-          worker: worker_id,
-          operation: operation,
-          api_id: api.object_id,
-          cache_id: cache.object_id
-        }
-        
-        sleep(0.001) if operation % 10 == 0
-      rescue => e
-        worker_errors << { worker: worker_id, operation: operation, error: e.message }
-      end
+      api = worker_service.api_client
+      cache = worker_service.shared_cache
+
+      thread_results << {
+        worker: worker_id,
+        operation: operation,
+        api_id: api.object_id,
+        cache_id: cache.object_id
+      }
+
+      sleep(0.001) if operation % 10 == 0
+    rescue StandardError => e
+      worker_errors << { worker: worker_id, operation: operation, error: e.message }
     end
-    
+
     worker_results.concat(thread_results)
   end
 end
@@ -291,32 +287,32 @@ puts "  Shared Cache - Unique objects: #{cache_ids.size} (should be 1)"
 worker_passed = api_ids.size == 1 && cache_ids.size == 1
 puts "  Result: #{worker_passed ? '✅ PASS' : '❌ FAIL'} - Consistency maintained"
 
-puts "\n" + "="*60 + "\n"
+puts "\n" + '=' * 60 + "\n"
 
-puts " TEST 3: Dependency Chain Stress Test"
-puts "Testing complex dependency resolution under concurrent pressure"
-puts "-" * 60
+puts ' TEST 3: Dependency Chain Stress Test'
+puts 'Testing complex dependency resolution under concurrent pressure'
+puts '-' * 60
 
 class DependencyChainService
   extend LazyInit
   include ProductionOperations
-  
+
   lazy_attr_reader :base_config do
     puts "Computing base_config in thread: #{Thread.current.object_id}"
     load_database_config
   end
-  
+
   lazy_attr_reader :connection_manager, depends_on: [:base_config] do
     puts "Computing connection_manager in thread: #{Thread.current.object_id}"
     create_connection_pool
   end
-  
+
   lazy_attr_reader :auth_service, depends_on: [:base_config] do
     puts "Computing auth_service in thread: #{Thread.current.object_id}"
     fetch_user_permissions
   end
-  
-  lazy_attr_reader :api_gateway, depends_on: [:connection_manager, :auth_service] do
+
+  lazy_attr_reader :api_gateway, depends_on: %i[connection_manager auth_service] do
     puts "Computing api_gateway in thread: #{Thread.current.object_id}"
     initialize_api_client
   end
@@ -325,12 +321,12 @@ end
 dependency_service = DependencyChainService.new
 dependency_results = []
 
-puts "Starting dependency chain test (100 concurrent accesses to complex dependency)..."
+puts 'Starting dependency chain test (100 concurrent accesses to complex dependency)...'
 
 dependency_threads = 100.times.map do |i|
   Thread.new do
     gateway = dependency_service.api_gateway
-    
+
     dependency_results << {
       thread: i,
       gateway_id: gateway.object_id,
@@ -356,16 +352,16 @@ puts "  Unique gateway objects: #{gateway_ids.size} (should be 1)"
 dependency_passed = gateway_ids.size == 1
 puts "  Result: #{dependency_passed ? '✅ PASS' : '❌ FAIL'} - Dependency resolution works correctly"
 
-puts "\n" + "="*60 + "\n"
+puts "\n" + '=' * 60 + "\n"
 
-puts "TEST 4: Reset and Recovery Under Load"
-puts "Testing reset operations during concurrent access (production maintenance scenario)"
-puts "-" * 60
+puts 'TEST 4: Reset and Recovery Under Load'
+puts 'Testing reset operations during concurrent access (production maintenance scenario)'
+puts '-' * 60
 
 class ResetTestService
   extend LazyInit
   include ProductionOperations
-  
+
   lazy_attr_reader :service_config do
     load_database_config
   end
@@ -375,19 +371,17 @@ reset_service = ResetTestService.new
 reset_results = []
 reset_stats = { resets: 0, access_attempts: 0, successes: 0 }
 
-puts "Starting reset test (readers + periodic resets)..."
+puts 'Starting reset test (readers + periodic resets)...'
 
 reader_threads = 20.times.map do |i|
   Thread.new do
     50.times do |attempt|
-      begin
-        reset_stats[:access_attempts] += 1
-        config = reset_service.service_config
-        reset_results << { thread: i, attempt: attempt, config_id: config.object_id }
-        reset_stats[:successes] += 1
-        sleep(0.01)
-      rescue => e
-      end
+      reset_stats[:access_attempts] += 1
+      config = reset_service.service_config
+      reset_results << { thread: i, attempt: attempt, config_id: config.object_id }
+      reset_stats[:successes] += 1
+      sleep(0.01)
+    rescue StandardError => e
     end
   end
 end
@@ -415,19 +409,19 @@ puts "  Unique config objects: #{unique_configs.size} (should be > 1 due to rese
 reset_passed = unique_configs.size > 1 && reset_stats[:successes] > 0
 puts "  Result: #{reset_passed ? '✅ PASS' : '❌ FAIL'} - Reset and recovery works correctly"
 
-puts "\n" + "="*60 + "\n"
+puts "\n" + '=' * 60 + "\n"
 
 all_tests_passed = spike_passed && worker_passed && dependency_passed && reset_passed
 
-puts " === FINAL THREAD SAFETY SUMMARY ==="
+puts ' === FINAL THREAD SAFETY SUMMARY ==='
 puts "Test Environment: Ruby #{RUBY_VERSION}, #{RbConfig::CONFIG['target_cpu']}"
 puts "Platform: #{RUBY_PLATFORM}"
-puts ""
-puts "Results:"
+puts ''
+puts 'Results:'
 puts "  ✅ Traffic Spike (200 concurrent): #{spike_passed ? 'PASS' : 'FAIL'}"
-puts "  ✅ Sustained Load (1500 operations): #{worker_passed ? 'PASS' : 'FAIL'}"  
+puts "  ✅ Sustained Load (1500 operations): #{worker_passed ? 'PASS' : 'FAIL'}"
 puts "  ✅ Dependency Chain (100 concurrent): #{dependency_passed ? 'PASS' : 'FAIL'}"
 puts "  ✅ Reset Recovery (periodic resets): #{reset_passed ? 'PASS' : 'FAIL'}"
-puts ""
+puts ''
 puts "Overall Result: #{all_tests_passed ? '✅ ALL TESTS PASSED' : '❌ SOME TESTS FAILED'}"
-puts ""
+puts ''

data/lazy_init.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
   spec.metadata['source_code_uri'] = 'https://github.com/N3BCKN/lazy_init'
   spec.metadata['changelog_uri'] = 'https://github.com/N3BCKN/lazy_init/blob/main/CHANGELOG.md'
   spec.metadata['bug_tracker_uri'] = 'https://github.com/N3BCKN/lazy_init/issues'
-  spec.metadata['documentation_uri'] = 'https://rubydoc.info/gems/lazy_init'
+  spec.metadata['documentation_uri'] = "https://rubydoc.info/gems/lazy_init/#{LazyInit::VERSION}"
 
   # Specify which files should be added to the gem when it is released.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
@@ -30,11 +30,11 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.required_ruby_version = '>= 2.6'
-  
+
   # Development dependencies
-  spec.add_development_dependency 'rspec', '~> 3.12'
   spec.add_development_dependency 'benchmark-ips', '~> 2.10'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.12'
   spec.add_development_dependency 'rubocop', '~> 1.50.2'
   spec.add_development_dependency 'yard', '~> 0.9'
-  spec.add_development_dependency 'rake', '~> 13.0'
-end
+end