familia 2.0.0.pre18 → 2.0.0.pre21

data/try/performance/transaction_safety_benchmark_try.rb

@@ -0,0 +1,238 @@
+# try/performance/transaction_safety_benchmark_try.rb
+#
+# frozen_string_literal: true
+
+# Transaction Safety Performance Benchmarks
+#
+# Measures the performance impact of transaction safety mechanisms
+# and compares different transaction patterns for overhead analysis.
+#
+
+require_relative '../support/helpers/test_helpers'
+require 'benchmark'
+
+# Benchmark test model
+class ::BenchmarkCustomer < Familia::Horreum
+  identifier_field :customer_id
+  field :customer_id
+  field :login_count
+  field :status
+  field :balance
+
+  list :orders
+  set :tags
+end
+
+# Helper for generating test data
+def benchmark_id(prefix = 'bench')
+  "#{prefix}_#{Time.now.to_i}_#{rand(100000)}"
+end
+
+# Setup test customers
+@customers = 100.times.map do |i|
+  customer = BenchmarkCustomer.new(
+    customer_id: benchmark_id("customer_#{i}"),
+    login_count: 0,
+    status: 'active',
+    balance: 1000
+  )
+  customer.save
+  customer
+end
+
+## Simple transaction performance baseline
+@start_time = Time.now
+@customers.first(10).each do |customer|
+  customer.transaction do
+    customer.hset(:login_count, '1')
+    customer.hset(:status, 'updated')
+  end
+end
+@simple_duration = ((Time.now - @start_time) * 1000).round(2)
+@simple_duration < 100  # Should complete in under 100ms
+#=> true
+
+## Nested transaction performance (reentrant)
+@start_time = Time.now
+@customers[10, 10].each do |customer|
+  customer.transaction do
+    customer.hset(:login_count, '1')
+
+    # Nested transaction (reentrant)
+    customer.transaction do
+      customer.hset(:status, 'nested_updated')
+      customer.orders.push('nested_order')
+    end
+
+    customer.hset(:balance, '950')
+  end
+end
+@nested_duration = ((Time.now - @start_time) * 1000).round(2)
+@nested_duration < 150  # Should have minimal overhead
+#=> true
+
+## Nested vs simple transaction overhead ratio
+@overhead_ratio = @nested_duration / @simple_duration
+@overhead_ratio < 2.0  # Nested should be less than 2x slower
+#=> true
+
+## Bulk operations in single transaction
+@start_time = Time.now
+BenchmarkCustomer.transaction do |conn|
+  @customers[20, 20].each do |customer|
+    conn.hset(customer.dbkey, 'bulk_status', 'processed')
+    conn.hset(customer.dbkey, 'bulk_timestamp', Time.now.to_i.to_s)
+  end
+end
+@bulk_duration = ((Time.now - @start_time) * 1000).round(2)
+@bulk_duration < 50  # Bulk should be faster per operation
+#=> true
+
+## Individual transactions vs bulk transaction efficiency
+@individual_start = Time.now
+@customers[40, 10].each do |customer|
+  customer.transaction do
+    customer.hset(:individual_status, 'processed')
+  end
+end
+@individual_duration = ((Time.now - @individual_start) * 1000).round(2)
+
+@bulk_per_op = @bulk_duration / 20
+@individual_per_op = @individual_duration / 10
+@efficiency_ratio = @individual_per_op / @bulk_per_op
+@efficiency_ratio > 1.5  # Individual should be slower per operation
+#=> true
+
+## Connection reuse verification in nested transactions
+@connection_ids = []
+@customers[50, 1].each do |customer|
+  customer.transaction do |outer_conn|
+    @connection_ids << outer_conn.object_id
+
+    customer.transaction do |inner_conn|
+      @connection_ids << inner_conn.object_id
+      customer.hset(:conn_test, 'value')
+    end
+  end
+end
+
+# Both connection IDs should be the same (reentrant)
+@connection_ids.uniq.size == 1 && @connection_ids.size == 2
+#=> true
+
+## Memory usage with deep nesting
+@deep_nesting_start = Time.now
+@test_customer = @customers[60]
+
+@result = @test_customer.transaction do
+  @test_customer.hset(:level_1, 'value')
+
+  @test_customer.transaction do
+    @test_customer.hset(:level_2, 'value')
+
+    @test_customer.transaction do
+      @test_customer.hset(:level_3, 'value')
+
+      @test_customer.transaction do
+        @test_customer.hset(:level_4, 'value')
+        @test_customer.orders.push('deep_order')
+      end
+    end
+  end
+end
+
+@deep_nesting_duration = ((Time.now - @deep_nesting_start) * 1000).round(2)
+@deep_nesting_duration < 50  # Even deep nesting should be fast
+#=> true
+
+## Error handling performance in transactions
+@error_handling_start = Time.now
+@error_count = 0
+
+10.times do |i|
+  customer = @customers[70 + i]
+  begin
+    customer.transaction do
+      customer.hset(:test_field, 'value')
+      raise 'simulated error' if i.even?
+      customer.hset(:success_field, 'success')
+    end
+  rescue => e
+    @error_count += 1
+  end
+end
+
+@error_handling_duration = ((Time.now - @error_handling_start) * 1000).round(2)
+@error_handling_duration < 100  # Error handling shouldn't be too slow
+#=> true
+
+## Correct number of errors caught
+@error_count == 5  # Should catch 5 errors (even indices)
+#=> true
+
+## Fiber-local storage performance impact
+@fiber_storage_start = Time.now
+
+10.times do |i|
+  customer = @customers[80 + i]
+  customer.transaction do
+    # Access fiber-local storage multiple times
+    current_txn = Fiber[:familia_transaction]
+    handler_class = Fiber[:familia_connection_handler_class]
+
+    customer.hset(:fiber_test, "#{current_txn.class.name}_#{i}")
+  end
+end
+
+@fiber_storage_duration = ((Time.now - @fiber_storage_start) * 1000).round(2)
+@fiber_storage_duration < 75  # Fiber access should be fast
+#=> true
+
+## Transaction vs pipeline performance comparison
+@transaction_start = Time.now
+@customers[90, 5].each do |customer|
+  customer.transaction do |conn|
+    conn.hset(customer.dbkey, 'txn_field1', 'value1')
+    conn.hset(customer.dbkey, 'txn_field2', 'value2')
+    conn.hset(customer.dbkey, 'txn_field3', 'value3')
+  end
+end
+@transaction_perf_duration = ((Time.now - @transaction_start) * 1000).round(2)
+
+@pipeline_start = Time.now
+@customers[95, 5].each do |customer|
+  customer.dbclient.pipelined do |pipe|
+    pipe.hset(customer.dbkey, 'pipe_field1', 'value1')
+    pipe.hset(customer.dbkey, 'pipe_field2', 'value2')
+    pipe.hset(customer.dbkey, 'pipe_field3', 'value3')
+  end
+end
+@pipeline_perf_duration = ((Time.now - @pipeline_start) * 1000).round(2)
+
+# Pipeline should be faster or comparable
+@performance_difference = @transaction_perf_duration / @pipeline_perf_duration
+@performance_difference < 3.0  # Transaction shouldn't be more than 3x slower
+#=> true
+
+## Benchmark summary shows acceptable performance
+@benchmark_summary = {
+  simple_transaction: @simple_duration,
+  nested_transaction: @nested_duration,
+  bulk_operations: @bulk_duration,
+  error_handling: @error_handling_duration,
+  fiber_storage: @fiber_storage_duration,
+  transaction_vs_pipeline: @performance_difference
+}
+
+# All operations should complete reasonably quickly
+@benchmark_summary.values.all? { |v| v < 200 }
+#=> true
+
+## Performance regression check - nested overhead
+@nested_overhead_percent = ((@nested_duration - @simple_duration) / @simple_duration * 100).round(1)
+@nested_overhead_percent < 100  # Less than 100% overhead (2x) - increased threshold for CI stability
+#=> true
+
+## Performance benchmark completed successfully
+true
+#=> true

data/try/support/benchmarks/deserialization_benchmark.rb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
+# try/support/benchmarks/deserialization_benchmark.rb
+#
+# frozen_string_literal: true
 
 # Benchmark: Field deserialization strategies in find_by_dbkey
-#
 # Compares different approaches to deserializing Redis hash values
 # when loading Horreum objects from the database.
 #

data/try/support/benchmarks/deserialization_correctness_test.rb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
+# try/support/benchmarks/deserialization_correctness_test.rb
+#
+# frozen_string_literal: true
 
 # Correctness Test: Field deserialization strategies
-#
 # Verifies that different deserialization approaches produce identical
 # results for all field types (strings, numbers, JSON, nested structures).
 #

data/try/support/debugging/cache_behavior_tracer.rb

@@ -1,4 +1,8 @@
 #!/usr/bin/env ruby
+# try/support/debugging/cache_behavior_tracer.rb
+#
+# frozen_string_literal: true
+
 # Debug script to trace encryption cache behavior and key derivation
 
 require 'base64'

data/try/support/debugging/debug_aad_process.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_aad_process.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_concealed_internal.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_concealed_internal.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_concealed_reveal.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_concealed_reveal.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_context_aad.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_context_aad.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_context_simple.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_context_simple.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_cross_context.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_cross_context.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_database_load.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_database_load.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_encrypted_json_check.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_encrypted_json_check.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_encrypted_json_step_by_step.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_encrypted_json_step_by_step.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_exists_lifecycle.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_exists_lifecycle.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_field_decrypt.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_field_decrypt.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_fresh_cross_context.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_fresh_cross_context.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_load_path.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_load_path.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_method_definition.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_method_definition.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_method_resolution.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_method_resolution.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_minimal.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_minimal.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 require 'familia'

data/try/support/debugging/debug_provider.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_provider.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_secure_behavior.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_secure_behavior.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_string_class.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_string_class.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/debug_test.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_test.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment

data/try/support/debugging/debug_test_design.rb

@@ -1,4 +1,7 @@
 #!/usr/bin/env ruby
+# try/support/debugging/debug_test_design.rb
+#
+# frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'

data/try/support/debugging/encryption_method_tracer.rb

@@ -1,4 +1,8 @@
 #!/usr/bin/env ruby
+# try/support/debugging/encryption_method_tracer.rb
+#
+# frozen_string_literal: true
+
 # Debug script to trace encryption method calls and data flow
 
 require 'base64'

data/try/support/debugging/provider_diagnostics.rb

@@ -1,4 +1,8 @@
 #!/usr/bin/env ruby
+# try/support/debugging/provider_diagnostics.rb
+#
+# frozen_string_literal: true
+
 # Debug script for testing encryption providers and diagnosing issues
 
 require 'base64'

data/try/support/helpers/test_cleanup.rb

@@ -1,3 +1,7 @@
+# try/support/helpers/test_cleanup.rb
+#
+# frozen_string_literal: true
+
 # Test cleanup helper for managing anonymous classes and test isolation
 #
 # This module provides utilities to create and cleanup test classes that

data/try/support/helpers/test_helpers.rb

@@ -1,3 +1,7 @@
+# try/support/helpers/test_helpers.rb
+#
+# frozen_string_literal: true
+
 # try/helpers/test_helpers.rb
 
 # To enable tracing and debug mode, run with the env vars set.
@@ -10,6 +14,7 @@ require_relative '../../../lib/familia'
 
 Familia.enable_database_logging = true
 Familia.enable_database_counter = true
+DatabaseLogger.structured_logging = true
 Familia.uri = 'redis://127.0.0.1:2525'
 
 def generate_random_email

data/try/support/memory/memory_basic_test.rb

@@ -1,3 +1,7 @@
+# try/support/memory/memory_basic_test.rb
+#
+# frozen_string_literal: true
+
 # try/edge_cases/memory_try.rb
 
 require 'tempfile'

data/try/support/memory/memory_detailed_test.rb

@@ -1,3 +1,7 @@
+# try/support/memory/memory_detailed_test.rb
+#
+# frozen_string_literal: true
+
 # try/edge_cases/memory_detailed_test_try.rb
 
 require 'objspace'

data/try/support/memory/memory_search_for_string.rb

@@ -1,3 +1,7 @@
+# try/support/memory/memory_search_for_string.rb
+#
+# frozen_string_literal: true
+
 # try/edge_cases/search_memory_for_string_try.rb
 
 require 'objspace'

data/try/support/memory/test_actual_redactedstring_protection.rb

@@ -1,3 +1,7 @@
+# try/support/memory/test_actual_redactedstring_protection.rb
+#
+# frozen_string_literal: true
+
 # try/memory/test_actual_redactedstring_protection.rb
 
 require_relative '../helpers/test_helpers'

data/try/support/prototypes/atomic_saves_v1_context_proxy.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/atomic_saves_v1_context_proxy.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/atomic_saves_v1_target_proxy.rb
 
 # try -vf try/prototypes/atomic_saves_v1_target_proxy.rb

data/try/support/prototypes/atomic_saves_v2_connection_switching.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/atomic_saves_v2_connection_switching.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/atomic_saves_v2_connection_switching.rb
 
 # try -vf try/prototypes/atomic_saves_v2_connection_switching.rb

data/try/support/prototypes/atomic_saves_v3_connection_pool.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/atomic_saves_v3_connection_pool.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/atomic_saves_v3_connection_pool.rb
 
 # try -vf try/prototypes/atomic_saves_v3_connection_pool.rb

data/try/support/prototypes/atomic_saves_v4.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/atomic_saves_v4.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/atomic_saves_v4.rb
 
 class BankAccount < Familia::Horreum

data/try/support/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
 
 ##

data/try/support/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
+#
+# frozen_string_literal: true
+
 # try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
 
 ##

data/try/support/prototypes/pooling/configurable_stress_test.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/pooling/configurable_stress_test.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/configurable_stress_test.rb
 #
 # Configurable Stress Test - Systematic testing using StressTestConfig

data/try/support/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
 
 ##

data/try/support/prototypes/pooling/lib/connection_pool_metrics.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/pooling/lib/connection_pool_metrics.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/lib/connection_pool_metrics.rb
 #
 # Enhanced Metrics Collection and Reporting for Connection Pool Stress Tests

data/try/support/prototypes/pooling/lib/connection_pool_stress_test.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/pooling/lib/connection_pool_stress_test.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/lib/connection_pool_stress_test.rb
 #
 # Connection Pool Stress Test Framework

data/try/support/prototypes/pooling/lib/connection_pool_threading_models.rb

@@ -1,3 +1,7 @@
+# try/support/prototypes/pooling/lib/connection_pool_threading_models.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/lib/connection_pool_threading_models.rb
 #
 # Different Threading Models for Connection Pool Stress Testing

data/try/support/prototypes/pooling/lib/visualize_stress_results.rb

@@ -1,8 +1,10 @@
 #!/usr/bin/env ruby
-# try/prototypes/visualize_stress_results.rb
+# try/support/prototypes/pooling/lib/visualize_stress_results.rb
 #
+# frozen_string_literal: true
+
+# try/prototypes/visualize_stress_results.rb
 # Simple Visualization Tool for Connection Pool Stress Test Results
-#
 # This script reads CSV output from stress tests and generates:
 # - ASCII charts for terminal display
 # - Markdown-formatted reports