familia 1.2.3 → 2.0.0.pre.pre

data/try/{29_redis_horreum_initialization_try.rb → horreum/initialization_try.rb}

@@ -1,10 +1,12 @@
-require_relative '../lib/familia'
-require_relative './test_helpers'
+# try/horreum/initialization_try.rb
+
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
 
 Familia.debug = false
 
 ## Existing positional argument initialization still works
-@customer1 = Customer.new 'tryouts-29@test.com', '', '', '', '', 'John Doe'
+@customer1 = Customer.new 'tryouts-29@test.com', '', '', '', 'John Doe'
 [@customer1.custid, @customer1.name]
 #=> ["tryouts-29@test.com", "John Doe"]
 
@@ -38,8 +40,8 @@ Familia.debug = false
 [@customer6.custid, @customer6.name, @customer6.email]
 #=> ["save-test@test.com", "Save Test", "save@example.com"]
 
-## Keyword initialization sets key field correctly
-@customer6.key
+## Keyword initialization sets identifier field correctly
+@customer6.identifier
 #=> "save-test@test.com"
 
 ## Mixed valid and nil values in keyword args (nil values stay nil)
@@ -52,7 +54,7 @@ Familia.debug = false
 #=> "Jane Smith"
 
 ## to_a works correctly with keyword-initialized objects
-@customer2.to_a[5]  # name field should be at index 5
+@customer2.to_a[4]  # name field should be the fifth field defined in the class
 #=> "Jane Smith"
 
 ## Session has limited fields (only sessid defined)
@@ -76,7 +78,7 @@ Familia.debug = false
 #=> ["api.example.com", "domain-test@test.com"]
 
 ## CustomDomain still works with positional args
-@domain2 = CustomDomain.new('web.example.com', 'positional@test.com')
+@domain2 = CustomDomain.new('', 'web.example.com', 'positional@test.com')
 [@domain2.display_domain, @domain2.custid]
 #=> ["web.example.com", "positional@test.com"]
 

data/try/horreum/relations_try.rb

@@ -0,0 +1,146 @@
+# try/horreum/relations_try.rb
+# Test Horreum Database type relations functionality
+
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
+
+Familia.debug = false
+
+class RelationsTestUser < Familia::Horreum
+  prefix 'relationstestuser'
+  identifier_field :userid
+  field :userid
+  field :name
+  list :sessions
+  set :tags
+  zset :scores
+  hashkey :preferences
+end
+
+class RelationsTestProduct < Familia::Horreum
+  prefix 'relationstestproduct'
+  identifier_field :productid
+  field :productid
+  field :title
+  list :reviews
+  set :categories
+  zset :ratings
+  hashkey :metadata
+  counter :views
+end
+
+@test_user = RelationsTestUser.new
+@test_user.userid = "user123"
+@test_user.name = "Test User"
+
+@test_product = RelationsTestProduct.new
+@test_product.productid = "prod456"
+@test_product.title = "Test Product"
+
+## Class knows about Database type relationships
+RelationsTestUser.has_relations?
+#=> true
+
+## Class can list Database type definitions
+related_fields = RelationsTestUser.related_fields
+related_fields.keys.sort
+#=> [:preferences, :scores, :sessions, :tags]
+
+## Database type definitions are accessible
+sessions_def = RelationsTestUser.related_fields[:sessions]
+sessions_def.nil?
+#=> false
+
+## Can access different Database type instances
+sessions = @test_user.sessions
+tags = @test_user.tags
+scores = @test_user.scores
+prefs = @test_user.preferences
+[sessions.class.name, tags.class.name, scores.class.name, prefs.class.name]
+#=> ["Familia::List", "Familia::Set", "Familia::SortedSet", "Familia::HashKey"]
+
+## Database types use correct dbkeys
+@test_user.sessions.dbkey
+#=> "relationstestuser:user123:sessions"
+
+## Database types use correct dbkeys
+@test_user.tags.dbkey
+#=> "relationstestuser:user123:tags"
+
+## Can work with List Database type
+@test_user.sessions.clear
+@test_user.sessions.push("session1", "session2")
+@test_user.sessions.size
+#=> 2
+
+## Can work with Set Database type
+@test_user.tags.clear
+@test_user.tags.add("ruby", "valkey", "web")
+@test_user.tags.size
+#=> 3
+
+## Can work with SortedSet Database type
+@test_user.scores.clear
+@test_user.scores.add(100, "level1")
+@test_user.scores.add(200, "level2")
+@test_user.scores.size
+#=> 2
+
+## Can work with HashKey Database type
+@test_user.preferences.clear
+@test_user.preferences.put("theme", "dark")
+@test_user.preferences.put("lang", "en")
+@test_user.preferences.size
+#=> 2
+
+## Clearing a counter returns false when not set yet
+@test_product.views.clear
+@test_product.views.clear
+#=> false
+
+## Clearing a counter returns true when it is set
+@test_product.views.increment
+@test_product.views.clear
+#=> true
+
+## Counter Database type works
+@test_product.views.increment
+@test_product.views.incrementby(5)
+@test_product.views.value
+#=> "6"
+
+## Database types maintain parent reference
+@test_user.sessions.parent == @test_user
+#=> true
+
+## Database types know their field name
+@test_user.tags.keystring
+#=> :tags
+
+## Can check if Database types exist
+@test_user.scores.add(50, "test")
+before_exists = @test_user.scores.exists?
+@test_user.scores.clear
+after_exists = @test_user.scores.exists?
+[before_exists, after_exists]
+#=> [true, false]
+
+## Can destroy individual Database types
+@test_user.preferences.put("temp", "value")
+@test_user.preferences.clear
+@test_user.preferences.exists?
+#=> false
+
+## Parent object destruction does not clean up relations
+@test_user.sessions.add("cleanup_test")
+@test_user.destroy!
+@test_user.sessions.exists?
+#=> true
+
+## If the parent instance is still in memory, can use it
+## to access and clear the child field.
+@test_user.sessions.clear
+#=> true
+
+
+@test_product.destroy!

data/try/{28_redis_horreum_serialization_try.rb → horreum/serialization_try.rb}

@@ -1,5 +1,7 @@
-require_relative '../lib/familia'
-require_relative './test_helpers'
+# try/horreum/serialization_try.rb
+
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
 
 Familia.debug = false
 
@@ -19,16 +21,16 @@ Familia.debug = false
 @customer.to_h[:name]
 #=> "John Doe"
 
-## to_h includes the key field (using symbol keys)
-@customer.to_h[:key]
+## to_h includes the custid field (using symbol keys)
+@customer.to_h[:custid]
 #=> "tryouts-28@onetimesecret.com"
 
 ## to_a returns field array in definition order
 @customer.to_a.class
 #=> Array
 
-## to_a includes values in field order (name should be at index 5)
-@customer.to_a[5]
+## to_a includes values in field order (name should be at index 4)
+@customer.to_a[4]
 #=> "John Doe"
 
 ## batch_update can update multiple fields atomically, to_h
@@ -68,7 +70,7 @@ Familia.debug = false
 [@customer.name, @customer.email]
 #=> ["Memory Only", "memory@test.com"]
 
-## apply_fields doesn't persist to Redis (2 of 2)
+## apply_fields doesn't persist to Database (2 of 2)
 @customer.refresh!
 [@customer.name, @customer.email]
 #=> ["Bob Jones", "jane@example.com"]
@@ -103,8 +105,8 @@ Familia.debug = false
 
 ## transaction method works with block
 result = @customer.transaction do |conn|
-  conn.hset @customer.rediskey, 'temp_field', 'temp_value'
-  conn.hset @customer.rediskey, 'another_field', 'another_value'
+  conn.hset @customer.dbkey, 'temp_field', 'temp_value'
+  conn.hset @customer.dbkey, 'another_field', 'another_value'
 end
 result.size
 #=> 2
@@ -119,11 +121,11 @@ result = @customer.batch_update()
 result.successful?
 #=> true
 
-## destroy! removes object from Redis (1 of 2)
+## destroy! removes object from Database (1 of 2)
 @customer.destroy!
 #=> true
 
-## After destroy!, Redis key no longer exists (2 of 2)
+## After destroy!, dbkey no longer exists (2 of 2)
 @customer.exists?
 #=> false
 

data/try/horreum/settings_try.rb

@@ -0,0 +1,43 @@
+require_relative '../helpers/test_helpers'
+
+# Test Horreum settings
+group "Horreum Settings"
+
+setup do
+  @user_class = Class.new(Familia::Horreum) do
+    identifier :email
+    field :name
+  end
+end
+
+try "database selection inheritance" do
+  @user_class.db 5
+  user = @user_class.new(email: "test@example.com")
+
+  user.db == 5
+end
+
+try "custom serialization methods" do
+  @user_class.dump_method :to_json
+  @user_class.load_method :from_json
+  user = @user_class.new(email: "test@example.com")
+
+  user.dump_method == :to_json &&
+    user.load_method == :from_json
+end
+
+try "redisdetails comprehensive state inspection" do
+  user = @user_class.new(email: "test@example.com", name: "Test")
+  details = user.redisdetails
+
+  details.is_a?(Hash) &&
+    details.key?(:key) &&
+    details.key?(:db)
+end
+
+try "redisuri generation with suffix" do
+  user = @user_class.new(email: "test@example.com")
+  uri = user.redisuri("suffix")
+
+  uri.include?("suffix")
+end

data/try/integration/cross_component_try.rb

@@ -0,0 +1,46 @@
+require_relative '../helpers/test_helpers'
+
+# Test cross-component integration scenarios
+group "Cross-Component Integration"
+
+setup do
+  @user_class = Class.new(Familia::Horreum) do
+    identifier :email
+    field :name
+    feature :expiration
+    feature :safe_dump
+    ttl 3600
+  end
+end
+
+try "Horreum with multiple features integration" do
+  user = @user_class.new(email: "test@example.com", name: "Integration Test")
+  user.save
+
+  # Test expiration feature
+  user.expire(1800)
+  ttl_works = user.realttl > 0
+
+  # Test safe_dump feature
+  safe_data = user.safe_dump
+  safe_dump_works = safe_data.is_a?(Hash)
+
+  ttl_works && safe_dump_works
+ensure
+  user&.delete!
+end
+
+try "RedisType relations with Horreum expiration" do
+  user = @user_class.new(email: "test@example.com")
+  user.save
+  user.expire(1800)
+
+  # Create related RedisType
+  tags = user.set(:tags)
+  tags << "ruby" << "redis"
+
+  # Expiration should cascade
+  tags.exists? && user.exists?
+ensure
+  user&.delete!
+end

data/try/{41_customer_safedump_try.rb → models/customer_safe_dump_try.rb}

@@ -1,14 +1,15 @@
+# try/models/customer_safedump_try.rb
 
-require_relative '../lib/familia'
-require_relative './test_helpers'
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
 
 # Setup
 @now = Time.now.to_i
 @customer = Customer.new
-@customer.custid = "test@example.com"
-@customer.email = "test@example.com"
+@customer.custid = "test+customer_safedump@example.com"
+@customer.email = "test+customer_safedump@example.com"
 @customer.role = "user"
-@customer.key = "abc123"
+# No longer need to set key field - identifier computed from custid
 @customer.planid = "basic"
 @customer.created = @now
 @customer.updated = @now
@@ -23,7 +24,7 @@ require_relative './test_helpers'
 
 ## Safe dump includes correct custid
 @safe_dump[:custid]
-#=> "test@example.com"
+#=> "test+customer_safedump@example.com"
 
 ## Safe dump includes correct role
 @safe_dump[:role]
@@ -45,7 +46,7 @@ require_relative './test_helpers'
 @customer.secrets_created.increment
 @safe_dump = @customer.safe_dump
 @safe_dump[:secrets_created]
-#=> "2"
+#=> "1"
 
 ## Safe dump includes correct active status when verified and not reset requested
 @safe_dump[:active]
@@ -84,3 +85,4 @@ require_relative './test_helpers'
 
 # Teardown
 @customer.destroy!
+@customer.secrets_created.clear

data/try/{40_customer_try.rb → models/customer_try.rb}

@@ -1,6 +1,9 @@
+# try/models/customer_try.rb
+
 # Customer Tryouts
-require_relative '../lib/familia'
-require_relative './test_helpers'
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
+
 
 # Setup
 @now = Time.now.to_f
@@ -8,7 +11,7 @@ require_relative './test_helpers'
 @customer.custid = "test@example.com"
 @customer.email = "test@example.com"
 @customer.role = "user"
-@customer.key = "abc123"
+# No longer need to set key field - identifier computed from custid
 @customer.planid = "basic"
 @customer.created = Time.now.to_i
 @customer.updated = Time.now.to_i
@@ -99,24 +102,24 @@ exists = Customer.exists?("test@example.com")
 @customer.destroy!
 #=> false
 
-## Customer.db returns the correct database number
-Customer.db
+## Customer.logical_database returns the correct database number
+Customer.logical_database
 #=> 15
 
-## Customer.db returns the correct database number
-@customer.db
+## Customer.logical_database returns the correct database number
+@customer.logical_database
 #=> 15
 
-## @customer.redis.connection returns the correct redis URI
-@customer.redis.connection
+## @customer.dbclient.connection returns the correct database URI
+@customer.dbclient.connection
 #=> {:host=>"127.0.0.1", :port=>6379, :db=>15, :id=>"redis://127.0.0.1:6379/15", :location=>"127.0.0.1:6379"}
 
-## @customer.redis.uri returns the correct redis URI
-@customer.secrets_created.db
+## @customer.dbclient.uri returns the correct database URI
+@customer.secrets_created.logical_database
 #=> nil
 
-## @customer.redis.uri returns the correct redis URI
-@customer.secrets_created.redis.connection
+## @customer.dbclient.uri returns the correct database URI
+@customer.secrets_created.dbclient.connection
 #=> {:host=>"127.0.0.1", :port=>6379, :db=>15, :id=>"redis://127.0.0.1:6379/15", :location=>"127.0.0.1:6379"}
 
 ## Customer.url is nil by default
@@ -124,14 +127,14 @@ Customer.uri
 #=> nil
 
 ## Customer.destroy! makes only one call to Redis
-RedisCommandCounter.count_commands { @customer.destroy! }
+DatabaseCommandCounter.count_commands { @customer.destroy! }
 #=> 1
 
-## Customer.db returns the correct database number
-Customer.instances.db
+## Customer.logical_database returns the correct database number
+Customer.instances.logical_database
 #=> nil
 
-## Customer.db returns the correct database number
+## Customer.logical_database returns the correct database number
 Customer.instances.uri.to_s
 #=> 'redis://127.0.0.1/15/'
 

data/try/models/datatype_base_try.rb

@@ -0,0 +1,101 @@
+# try/datatypes/datatype_base_try.rb
+
+# Test DataType base functionality
+
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
+
+Familia.debug = false
+
+@sample_obj = Customer.new(custid: 'customer123', email: 'test@example.com')
+
+## Customer has defined Database types
+Customer.related_fields.keys.include?(:timeline)
+#=> true
+
+## Customer has defined Database types
+Customer.related_fields.keys.include?(:stripe_customer)
+#=> true
+
+## Can access Database type instances
+@sample_obj.timeline
+#=:> Familia::SortedSet
+
+## Database types have dbkey method
+@sample_obj.timeline.dbkey
+#=> "customer:customer123:timeline"
+
+## Database types are frozen after creation
+@sample_obj.timeline.frozen?
+#=> true
+
+## Can access hashkey Database type
+@sample_obj ||= Customer.new(custid: 'customer123', email: 'test@example.com')
+stripe_customer = @sample_obj.stripe_customer
+stripe_customer.class.name
+#=> "Familia::HashKey"
+
+## DataType instances know their owner
+@sample_obj.timeline.parent == @sample_obj
+#=> true
+
+## DataType instances know their field name
+@sample_obj.timeline.keystring
+#=> :timeline
+
+## DataType has opts hash
+@sample_obj.timeline.opts.class
+#=> Hash
+
+## DataType responds to Familia's modified Database commands
+@sample_obj.timeline
+#=/=> _.respond_to?(:zadd)
+#==> _.respond_to?(:add)
+#==> _.respond_to?(:clear)
+#==> _.respond_to?(:exists?)
+#=/=> _.respond_to?(:destroy!)
+
+
+## Can check if DataType exists in Redis
+timeline = @sample_obj.timeline
+exists_before = timeline.exists?
+[exists_before.class, [true, false].include?(exists_before)]
+#=> [FalseClass, true]
+
+## DataType has size/length methods
+@sample_obj.timeline.respond_to?(:size)
+#=> true
+
+## DataType size returns integer
+timeline = @sample_obj.timeline
+timeline.size
+#=:> Integer
+
+## Different Database types have type-specific methods
+stripe_customer = @sample_obj.stripe_customer
+stripe_customer
+#=/=> _.respond_to?(:hset)
+#==> _.respond_to?(:put)
+#==> _.respond_to?(:store)
+#==> _.respond_to?(:[]=)
+
+## Can get DataType default expiration
+timeline = @sample_obj.timeline
+default_expiration = timeline.default_expiration
+[default_expiration.class, default_expiration >= -1]
+#=> [Integer, true]
+
+## DataType has logical_database method
+timeline = @sample_obj.timeline
+db = timeline.logical_database
+db
+#=:> NilClass
+
+## DataType has uri method
+timeline = @sample_obj.timeline
+uri = timeline.uri
+uri.class.name
+#=> "URI::Redis"
+
+# Cleanup
+@sample_obj.destroy!

data/try/{30_familia_object_try.rb → models/familia_object_try.rb}

@@ -1,29 +1,31 @@
-require_relative '../lib/familia'
-require_relative './test_helpers'
+# try/models/familia_object_try.rb
+
+require_relative '../../lib/familia'
+require_relative '../helpers/test_helpers'
 
 Familia.debug = false
 
-@a = Bone.new 'atoken', 'akey'
+@a = Session.new 'atoken'
 
 ## Familia.prefix
-Bone.prefix
-#=> :bone
+Session.prefix
+#=> :session
 
 ## Familia#identifier
 @a.identifier
-#=> 'atoken:akey'
+#=> 'atoken'
 
 ## Familia.suffix
-Bone.suffix
+Session.suffix
 #=> :object
 
-## Familia#rediskey
-@a.rediskey
-#=> 'bone:atoken:akey:object'
+## Familia#dbkey
+@a.dbkey
+#=> 'session:atoken:object'
 
-## Familia#rediskey
-@a.rediskey
-#=> 'bone:atoken:akey:object'
+## Familia#dbkey
+@a.dbkey
+#=> 'session:atoken:object'
 
 ## Familia#save
 @cust = Customer.new :delano, "Delano Mandelbaum"
@@ -50,7 +52,7 @@ Customer.values.size
 #=> 0
 
 ## Familia#save with an object that expires
-obj = Session.new 'sessionid', :delano
+obj = Session.new 'sessionid'
 obj.save
 #=> true
 
@@ -58,8 +60,8 @@ obj.save
 Customer.customers.class
 #=> Familia::List
 
-## Familia class rediskey
-Customer.customers.rediskey
+## Familia class dbkey
+Customer.customers.dbkey
 #=> 'customer:customers'
 
 ## Familia.class_list

data/try/performance/benchmarks_try.rb

@@ -0,0 +1,55 @@
+require_relative '../helpers/test_helpers'
+require 'benchmark'
+
+# Performance benchmarks separate from stress tests
+group "Performance Benchmarks"
+
+setup do
+  @user_class = Class.new(Familia::Horreum) do
+    identifier :email
+    field :name
+    field :data
+  end
+end
+
+try "serialization performance comparison" do
+  large_data = { items: (1..1000).to_a, metadata: "x" * 1000 }
+
+  json_time = Benchmark.realtime do
+    100.times { JSON.dump(large_data) }
+  end
+
+  familia_time = Benchmark.realtime do
+    100.times { Familia.distinguisher(large_data) }
+  end
+
+  json_time > 0 && familia_time > 0
+end
+
+try "bulk operations vs individual saves" do
+  users = 100.times.map { |i|
+    @user_class.new(email: "user#{i}@example.com", name: "User #{i}")
+  }
+
+  individual_time = Benchmark.realtime do
+    users.each(&:save)
+  end
+
+  # Cleanup for next test
+  users.each(&:delete!)
+
+  individual_time > 0
+end
+
+try "Redis type access performance" do
+  user = @user_class.new(email: "perf@example.com")
+  user.save
+
+  access_time = Benchmark.realtime do
+    1000.times { user.set(:tags) }
+  end
+
+  access_time > 0
+ensure
+  user&.delete!
+end