familia 2.0.0.pre15 → 2.0.0.pre17

data/try/refinements/dear_json_array_methods_try.rb

@@ -0,0 +1,53 @@
+# try/refinements/dear_json_array_methods_try.rb
+
+require_relative '../helpers/test_helpers'
+
+class TestArrayWithDearJson < Array
+  include Familia::Refinements::DearJsonArrayMethods
+end
+
+class TestObjectWithAsJson
+  def initialize(name)
+    @name = name
+  end
+
+  def as_json(options = nil)
+    { name: @name, type: 'test_object' }
+  end
+end
+
+## Can create an array with DearJson methods
+test_array = TestArrayWithDearJson.new
+test_array << 'value'
+test_array.respond_to?(:to_json)
+#=> true
+
+## to_json converts array to JSON string using JsonSerializer
+test_array = TestArrayWithDearJson.new
+test_array << 'simple'
+test_array << 42
+json_result = test_array.to_json
+json_result
+#=:> String
+
+## to_json handles objects with as_json methods
+test_array = TestArrayWithDearJson.new
+test_obj = TestObjectWithAsJson.new('test')
+test_array << test_obj
+test_array << 'simple'
+json_result = test_array.to_json
+#=~> /test_object/
+
+## as_json returns the array itself
+test_array = TestArrayWithDearJson.new
+test_array << 'value'
+result = test_array.as_json
+result == test_array
+#=> true
+
+## as_json accepts options parameter
+test_array = TestArrayWithDearJson.new
+test_array << 'value'
+result = test_array.as_json(some_option: true)
+result == test_array
+#=> true

data/try/refinements/dear_json_hash_methods_try.rb

@@ -0,0 +1,54 @@
+# try/refinements/dear_json_hash_methods_try.rb
+
+require_relative '../helpers/test_helpers'
+
+class TestHashWithDearJson < Hash
+  include Familia::Refinements::DearJsonHashMethods
+end
+
+class TestObjectWithAsJson
+  def initialize(name)
+    @name = name
+  end
+
+  def as_json(options = nil)
+    { name: @name, type: 'test_object' }
+  end
+end
+
+## Can create a hash with DearJson methods
+test_hash = TestHashWithDearJson.new
+test_hash[:key] = 'value'
+test_hash.respond_to?(:to_json)
+#=> true
+
+## to_json converts hash to JSON string using JsonSerializer
+test_hash = TestHashWithDearJson.new
+test_hash[:simple] = 'value'
+test_hash[:number] = 42
+json_result = test_hash.to_json
+json_result
+#=:> String
+
+## to_json handles objects with as_json methods
+test_hash = TestHashWithDearJson.new
+test_obj = TestObjectWithAsJson.new('test')
+test_hash[:object] = test_obj
+test_hash[:simple] = 'value'
+json_result = test_hash.to_json
+json_result
+#=~> /test_object/
+
+## as_json returns the hash itself
+test_hash = TestHashWithDearJson.new
+test_hash[:key] = 'value'
+result = test_hash.as_json
+result == test_hash
+#=> true
+
+## as_json accepts options parameter
+test_hash = TestHashWithDearJson.new
+test_hash[:key] = 'value'
+result = test_hash.as_json(some_option: true)
+result == test_hash
+#=> true

data/try/refinements/logger_trace_methods_try.rb

@@ -0,0 +1,44 @@
+# try/refinements/logger_trace_methods_try.rb
+
+require_relative '../helpers/test_helpers'
+require 'logger'
+require 'stringio'
+
+class TestLoggerWithTrace < Logger
+  include Familia::Refinements::LoggerTraceMethods
+end
+
+## Can create a logger with trace methods
+output = StringIO.new
+logger = TestLoggerWithTrace.new(output)
+logger.respond_to?(:trace)
+#=> true
+
+## trace method logs with TRACE level
+output = StringIO.new
+logger = TestLoggerWithTrace.new(output)
+logger.trace('Test message')
+output.string
+#=~> /Test message/
+
+## trace method sets and clears severity letter
+output = StringIO.new
+logger = TestLoggerWithTrace.new(output)
+logger.trace('Test message')
+Fiber[:severity_letter]
+#=> nil
+
+## trace method accepts progname parameter
+output = StringIO.new
+logger = TestLoggerWithTrace.new(output)
+logger.trace('MyApp') { 'Test message' }
+output.string
+#=~> /MyApp/
+#=~> /Test message/
+
+## trace method accepts block for message
+output = StringIO.new
+logger = TestLoggerWithTrace.new(output)
+logger.trace { 'Block message' }
+output.string
+#=~> /Block message/

data/try/refinements/time_literals_numeric_methods_try.rb

@@ -0,0 +1,141 @@
+# try/refinements/time_literals_numeric_methods_try.rb
+
+require_relative '../helpers/test_helpers'
+
+class TestNumericWithTimeLiterals
+  include Familia::Refinements::TimeLiterals::NumericMethods
+
+  def initialize(value)
+    @value = value
+  end
+
+  def to_f
+    @value.to_f
+  end
+
+  def to_i
+    @value.to_i
+  end
+
+  def positive?
+    @value.positive?
+  end
+
+  def zero?
+    @value.zero?
+  end
+
+  def abs
+    @value.abs
+  end
+
+  def <(other)
+    @value < other
+  end
+
+  def >(other)
+    @value > other
+  end
+
+  def -(other)
+    @value - other
+  end
+
+  def +(other)
+    @value + other
+  end
+
+  def *(other)
+    @value * other
+  end
+
+  def /(other)
+    @value / other
+  end
+end
+
+## Can create numeric with time literal methods
+test_num = TestNumericWithTimeLiterals.new(5)
+test_num.respond_to?(:minutes)
+#=> true
+#=:> TrueClass
+
+## Basic time unit conversions work
+test_num = TestNumericWithTimeLiterals.new(5)
+test_num.minutes
+#=> 300.0
+#=:> Float
+
+## Minutes conversion
+test_num = TestNumericWithTimeLiterals.new(2)
+test_num.minutes
+#=> 120.0
+#=:> Float
+
+## Hours conversion
+test_num = TestNumericWithTimeLiterals.new(2)
+test_num.hours
+#=> 7200.0
+#=:> Float
+
+## Days conversion
+test_num = TestNumericWithTimeLiterals.new(1)
+test_num.days
+#=> 86400.0
+#=:> Float
+
+## Conversion from seconds to other units
+test_num = TestNumericWithTimeLiterals.new(3600)
+test_num.in_hours
+#=> 1.0
+#=:> Float
+
+## Conversion from seconds to days
+test_num = TestNumericWithTimeLiterals.new(86400)
+test_num.in_days
+#=> 1.0
+#=:> Float
+
+## to_ms conversion
+test_num = TestNumericWithTimeLiterals.new(5)
+test_num.to_ms
+#=> 5000.0
+#=:> Float
+
+## humanize for seconds
+test_num = TestNumericWithTimeLiterals.new(30)
+test_num.humanize
+#=> "30 seconds"
+#=:> String
+
+## humanize for minutes
+test_num = TestNumericWithTimeLiterals.new(120)
+test_num.humanize
+#=> "2 minutes"
+#=:> String
+
+## to_bytes conversion
+test_num = TestNumericWithTimeLiterals.new(1024)
+test_num.to_bytes
+#=> "1.00 KiB"
+#=:> String
+
+## age_in with days
+old_time = Familia.now.to_f - 86400
+test_num = TestNumericWithTimeLiterals.new(old_time)
+age = test_num.age_in(:days)
+age.round
+#=> 1
+#=:> Integer
+
+## older_than? check
+old_timestamp = TestNumericWithTimeLiterals.new(Familia.now.to_f - 7200) # 2 hours ago
+old_timestamp.older_than?(3600) # 1 hour
+#=> true
+#=:> TrueClass
+
+## within? check for recent timestamp
+recent_timestamp = TestNumericWithTimeLiterals.new(Familia.now.to_f - 30) # 30 seconds ago
+recent_timestamp.within?(60) # within 1 minute
+#=> true
+#=:> TrueClass

data/try/refinements/time_literals_string_methods_try.rb

@@ -0,0 +1,80 @@
+# try/refinements/time_literals_string_methods_try.rb
+
+require_relative '../helpers/test_helpers'
+
+class TestStringWithTimeLiterals < String
+  include Familia::Refinements::TimeLiterals::StringMethods
+end
+
+## Can create string with time literal methods
+test_str = TestStringWithTimeLiterals.new("5m")
+test_str.respond_to?(:in_seconds)
+#=> true
+#=:> TrueClass
+
+## Parse minutes to seconds
+test_str = TestStringWithTimeLiterals.new("5m")
+test_str.in_seconds
+#=> 300.0
+#=:> Float
+
+## Parse hours to seconds
+test_str = TestStringWithTimeLiterals.new("2h")
+test_str.in_seconds
+#=> 7200.0
+#=:> Float
+
+## Parse days to seconds
+test_str = TestStringWithTimeLiterals.new("1d")
+test_str.in_seconds
+#=> 86400.0
+#=:> Float
+
+## Parse decimal values
+test_str = TestStringWithTimeLiterals.new("2.5h")
+test_str.in_seconds
+#=> 9000.0
+#=:> Float
+
+## Parse years to seconds
+test_str = TestStringWithTimeLiterals.new("1y")
+result = test_str.in_seconds
+result > 31_000_000 && result < 32_000_000
+#=> true
+#=:> TrueClass
+
+## Parse microseconds
+test_str = TestStringWithTimeLiterals.new("500μs")
+test_str.in_seconds
+#=> 0.0005
+#=:> Float
+
+## Parse milliseconds
+test_str = TestStringWithTimeLiterals.new("500ms")
+test_str.in_seconds
+#=> 0.5
+#=:> Float
+
+## Parse weeks
+test_str = TestStringWithTimeLiterals.new("2w")
+test_str.in_seconds
+#=> 1209600.0
+#=:> Float
+
+## Default unit is seconds when no unit specified
+test_str = TestStringWithTimeLiterals.new("30")
+test_str.in_seconds
+#=> 30.0
+#=:> Float
+
+## Invalid format returns nil
+test_str = TestStringWithTimeLiterals.new("invalid")
+test_str.in_seconds
+#=> nil
+#=:> NilClass
+
+## Empty string returns nil
+test_str = TestStringWithTimeLiterals.new("")
+test_str.in_seconds
+#=> nil
+#=:> NilClass

data/try/valkey.conf

@@ -0,0 +1,26 @@
+# try/test-valkey.conf
+
+# Familia - Tryouts Valkey Config
+# 2025-10-01
+#
+# Usage:
+#
+#   $ valkey-server try/valkey.conf
+#
+
+dir ./data
+
+enable-debug-command yes
+
+#requirepass CHANGEME
+
+bind 127.0.0.1
+port 2525
+databases 10
+
+timeout 4
+daemonize no
+loglevel notice
+
+# Disable RDB persistence for tests DB
+save ""

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: familia
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre15
+  version: 2.0.0.pre17
 platform: ruby
 authors:
 - Delano Mandelbaum
@@ -137,11 +137,14 @@ files:
 - ".github/workflows/ci.yml"
 - ".github/workflows/claude-code-review.yml"
 - ".github/workflows/claude.yml"
+- ".github/workflows/code-quality.yml"
+- ".github/workflows/code-smells.yml"
 - ".github/workflows/docs.yml"
 - ".gitignore"
 - ".pre-commit-config.yaml"
+- ".reek.yml"
 - ".rubocop.yml"
-- ".rubocop_todo.yml"
+- ".talismanrc"
 - ".yardopts"
 - CHANGELOG.rst
 - CLAUDE.md
@@ -157,23 +160,23 @@ files:
 - docs/archive/FAMILIA_TECHNICAL.md
 - docs/archive/FAMILIA_UPDATE.md
 - docs/archive/README.md
-- docs/connection_pooling.md
+- docs/archive/api-reference.md
+- docs/conf.py
 - docs/guides/.gitignore
-- docs/guides/API-Reference.md
-- docs/guides/Connection-Pooling-Guide.md
-- docs/guides/Encrypted-Fields-Overview.md
-- docs/guides/Expiration-Feature-Guide.md
-- docs/guides/Feature-System-Autoloading.md
-- docs/guides/Feature-System-Guide.md
-- docs/guides/Features-System-Developer-Guide.md
-- docs/guides/Field-System-Guide.md
-- docs/guides/Home.md
-- docs/guides/Implementation-Guide.md
-- docs/guides/Quantization-Feature-Guide.md
-- docs/guides/Relationships-Guide.md
-- docs/guides/Security-Model.md
-- docs/guides/Transient-Fields-Guide.md
-- docs/guides/relationships-methods.md
+- docs/guides/core-field-system.md
+- docs/guides/feature-encrypted-fields.md
+- docs/guides/feature-expiration.md
+- docs/guides/feature-external-identifiers.md
+- docs/guides/feature-object-identifiers.md
+- docs/guides/feature-quantization.md
+- docs/guides/feature-relationships-methods.md
+- docs/guides/feature-relationships.md
+- docs/guides/feature-system-devs.md
+- docs/guides/feature-system.md
+- docs/guides/feature-transient-fields.md
+- docs/guides/implementation.md
+- docs/guides/index.md
+- docs/guides/security-model.md
 - docs/guides/time-utilities.md
 - docs/migrating/.gitignore
 - docs/migrating/v2.0.0-pre.md
@@ -185,26 +188,40 @@ files:
 - docs/migrating/v2.0.0-pre6.md
 - docs/migrating/v2.0.0-pre7.md
 - docs/overview.md
-- docs/reference/auditing_database_commands.rb
+- docs/reference/api-technical.md
 - examples/autoloader/mega_customer.rb
+- examples/autoloader/mega_customer/features/deprecated_fields.rb
 - examples/autoloader/mega_customer/safe_dump_fields.rb
-- examples/permissions.rb
+- examples/encrypted_fields.rb
+- examples/json_usage_patterns.rb
 - examples/relationships.rb
 - examples/safe_dump.rb
+- examples/single_connection_transaction_confusions.rb
 - familia.gemspec
 - lib/familia.rb
 - lib/familia/base.rb
 - lib/familia/connection.rb
+- lib/familia/connection/handlers.rb
+- lib/familia/connection/individual_command_proxy.rb
+- lib/familia/connection/middleware.rb
+- lib/familia/connection/operation_core.rb
+- lib/familia/connection/operations.rb
+- lib/familia/connection/pipeline_core.rb
+- lib/familia/connection/transaction_core.rb
 - lib/familia/data_type.rb
+- lib/familia/data_type/class_methods.rb
 - lib/familia/data_type/commands.rb
+- lib/familia/data_type/connection.rb
 - lib/familia/data_type/serialization.rb
+- lib/familia/data_type/settings.rb
 - lib/familia/data_type/types/counter.rb
 - lib/familia/data_type/types/hashkey.rb
-- lib/familia/data_type/types/list.rb
+- lib/familia/data_type/types/listkey.rb
 - lib/familia/data_type/types/lock.rb
 - lib/familia/data_type/types/sorted_set.rb
-- lib/familia/data_type/types/string.rb
+- lib/familia/data_type/types/stringkey.rb
 - lib/familia/data_type/types/unsorted_set.rb
+- lib/familia/distinguisher.rb
 - lib/familia/encryption.rb
 - lib/familia/encryption/encrypted_data.rb
 - lib/familia/encryption/manager.rb
@@ -226,14 +243,17 @@ files:
 - lib/familia/features/object_identifier.rb
 - lib/familia/features/quantization.rb
 - lib/familia/features/relationships.rb
-- lib/familia/features/relationships/cascading.rb
+- lib/familia/features/relationships/README.md
+- lib/familia/features/relationships/collection_operations.rb
 - lib/familia/features/relationships/indexing.rb
-- lib/familia/features/relationships/membership.rb
-- lib/familia/features/relationships/permission_management.rb
-- lib/familia/features/relationships/querying.rb
-- lib/familia/features/relationships/redis_operations.rb
+- lib/familia/features/relationships/indexing/multi_index_generators.rb
+- lib/familia/features/relationships/indexing/unique_index_generators.rb
+- lib/familia/features/relationships/indexing_relationship.rb
+- lib/familia/features/relationships/participation.rb
+- lib/familia/features/relationships/participation/participant_methods.rb
+- lib/familia/features/relationships/participation/target_methods.rb
+- lib/familia/features/relationships/participation_relationship.rb
 - lib/familia/features/relationships/score_encoding.rb
-- lib/familia/features/relationships/tracking.rb
 - lib/familia/features/safe_dump.rb
 - lib/familia/features/transient_fields.rb
 - lib/familia/features/transient_fields/redacted_string.rb
@@ -241,43 +261,52 @@ files:
 - lib/familia/features/transient_fields/transient_field_type.rb
 - lib/familia/field_type.rb
 - lib/familia/horreum.rb
-- lib/familia/horreum/core.rb
-- lib/familia/horreum/core/connection.rb
-- lib/familia/horreum/core/database_commands.rb
-- lib/familia/horreum/core/serialization.rb
-- lib/familia/horreum/core/utils.rb
-- lib/familia/horreum/shared/settings.rb
-- lib/familia/horreum/subclass/definition.rb
-- lib/familia/horreum/subclass/management.rb
-- lib/familia/horreum/subclass/related_fields_management.rb
+- lib/familia/horreum/connection.rb
+- lib/familia/horreum/database_commands.rb
+- lib/familia/horreum/definition.rb
+- lib/familia/horreum/management.rb
+- lib/familia/horreum/persistence.rb
+- lib/familia/horreum/related_fields.rb
+- lib/familia/horreum/serialization.rb
+- lib/familia/horreum/settings.rb
+- lib/familia/horreum/utils.rb
 - lib/familia/json_serializer.rb
 - lib/familia/logging.rb
-- lib/familia/multi_result.rb
 - lib/familia/refinements.rb
+- lib/familia/refinements/dear_json.rb
 - lib/familia/refinements/logger_trace.rb
-- lib/familia/refinements/snake_case.rb
+- lib/familia/refinements/stylize_words.rb
 - lib/familia/refinements/time_literals.rb
 - lib/familia/secure_identifier.rb
 - lib/familia/settings.rb
 - lib/familia/utils.rb
-- lib/familia/validation.rb
-- lib/familia/validation/command_recorder.rb
-- lib/familia/validation/expectations.rb
-- lib/familia/validation/validation_helpers.rb
-- lib/familia/validation/validator.rb
 - lib/familia/verifiable_identifier.rb
 - lib/familia/version.rb
 - lib/middleware/database_middleware.rb
+- lib/multi_result.rb
 - try/configuration/scenarios_try.rb
+- try/connection/fiber_context_preservation_try.rb
+- try/connection/handler_constraints_try.rb
+- try/connection/operation_mode_guards_try.rb
+- try/connection/pipeline_fallback_integration_try.rb
+- try/connection/responsibility_chain_tracking_try.rb
+- try/connection/transaction_fallback_integration_try.rb
+- try/connection/transaction_mode_permissive_try.rb
+- try/connection/transaction_mode_strict_try.rb
+- try/connection/transaction_mode_warn_try.rb
+- try/connection/transaction_modes_try.rb
 - try/core/autoloader_try.rb
 - try/core/base_enhancements_try.rb
 - try/core/connection_try.rb
+- try/core/conventional_inheritance_try.rb
 - try/core/create_method_try.rb
 - try/core/database_consistency_try.rb
 - try/core/errors_try.rb
 - try/core/extensions_try.rb
 - try/core/familia_extended_try.rb
+- try/core/familia_members_methods_try.rb
 - try/core/familia_try.rb
+- try/core/isolated_dbclient_try.rb
 - try/core/middleware_try.rb
 - try/core/persistence_operations_try.rb
 - try/core/pools_try.rb
@@ -293,9 +322,10 @@ files:
 - try/data_types/hash_try.rb
 - try/data_types/list_try.rb
 - try/data_types/lock_try.rb
-- try/data_types/set_try.rb
 - try/data_types/sorted_set_try.rb
+- try/data_types/sorted_set_zadd_options_try.rb
 - try/data_types/string_try.rb
+- try/data_types/unsortedset_try.rb
 - try/debugging/README.md
 - try/debugging/cache_behavior_tracer.rb
 - try/debugging/debug_aad_process.rb
@@ -357,11 +387,17 @@ files:
 - try/features/external_identifier/external_identifier_try.rb
 - try/features/feature_dependencies_try.rb
 - try/features/feature_improvements_try.rb
+- try/features/field_groups_try.rb
 - try/features/object_identifier/object_identifier_integration_try.rb
 - try/features/object_identifier/object_identifier_try.rb
 - try/features/quantization/quantization_try.rb
 - try/features/real_feature_integration_try.rb
-- try/features/relationships/categorical_permissions_try.rb
+- try/features/relationships/indexing_commands_verification_try.rb
+- try/features/relationships/indexing_try.rb
+- try/features/relationships/participation_commands_verification_spec.rb
+- try/features/relationships/participation_commands_verification_try.rb
+- try/features/relationships/participation_performance_improvements_try.rb
+- try/features/relationships/participation_reverse_index_try.rb
 - try/features/relationships/relationships_api_changes_try.rb
 - try/features/relationships/relationships_edge_cases_try.rb
 - try/features/relationships/relationships_performance_minimal_try.rb
@@ -369,9 +405,7 @@ files:
 - try/features/relationships/relationships_performance_try.rb
 - try/features/relationships/relationships_performance_working_try.rb
 - try/features/relationships/relationships_try.rb
-- try/features/safe_dump/module_based_extensions_try.rb
 - try/features/safe_dump/safe_dump_advanced_try.rb
-- try/features/safe_dump/safe_dump_autoloading_try.rb
 - try/features/safe_dump/safe_dump_try.rb
 - try/features/transient_fields/redacted_string_try.rb
 - try/features/transient_fields/refresh_reset_try.rb
@@ -379,10 +413,14 @@ files:
 - try/features/transient_fields/single_use_redacted_string_try.rb
 - try/features/transient_fields/transient_fields_core_try.rb
 - try/features/transient_fields/transient_fields_integration_try.rb
+- try/helpers/test_cleanup.rb
 - try/helpers/test_helpers.rb
+- try/horreum/auto_indexing_on_save_try.rb
 - try/horreum/base_try.rb
 - try/horreum/class_methods_try.rb
 - try/horreum/commands_try.rb
+- try/horreum/defensive_initialization_try.rb
+- try/horreum/destroy_related_fields_cleanup_try.rb
 - try/horreum/enhanced_conflict_handling_try.rb
 - try/horreum/field_categories_try.rb
 - try/horreum/field_definition_try.rb
@@ -417,10 +455,12 @@ files:
 - try/prototypes/pooling/lib/visualize_stress_results.rb
 - try/prototypes/pooling/pool_siege.rb
 - try/prototypes/pooling/run_stress_tests.rb
-- try/validation/atomic_operations_try.rb.disabled
-- try/validation/command_validation_try.rb.disabled
-- try/validation/performance_validation_try.rb.disabled
-- try/validation/real_world_scenarios_try.rb.disabled
+- try/refinements/dear_json_array_methods_try.rb
+- try/refinements/dear_json_hash_methods_try.rb
+- try/refinements/logger_trace_methods_try.rb
+- try/refinements/time_literals_numeric_methods_try.rb
+- try/refinements/time_literals_string_methods_try.rb
+- try/valkey.conf
 homepage: https://github.com/delano/familia
 licenses:
 - MIT