real_data_tests 0.3.18 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 753cb1dee0fe489a7d6d98b9149133c816330cc532acd853c597ea89a0ff0e91
-  data.tar.gz: 85563e1219d79d1ded8abc3bae060cb4703d751b77aa8d75ac9e035c352a29f4
+  metadata.gz: f21f225cf114a1a334e786333cb7a5dcb04a261636590c890b85d3443c9659d3
+  data.tar.gz: 024b43b99b9b6880730c1a02d799c83fcec5be3a949fd38c5c25a2bf2fdf7d71
 SHA512:
-  metadata.gz: 965fcf6c738a84e783273fa93b9068046f4e45e9b4a52182d7a00385cffb2be1595206af5d141799265e25f45fdd679573ce194a4f231d05bc2d1e76737cebf6
-  data.tar.gz: db13e4b4fccf2f2eb513ff9d67d2ade07a146a4c9b7925181a93ffb3730925e88fbba1eed65396a3872ebfff33d07c2bd7a492de1a26e921e08be117b4f17fb3
+  metadata.gz: eceeaed220dae3072480315cb9c2623540231f3c7aca876727681f6511112d95e7a4b0f894800c17db5f79b939410ebac8288adfd88911c1c446e52005e0a3e4
+  data.tar.gz: dd75263ec204aaef5d544ae7d257b0428f59273046158de7f31d0d54f053ae1065e7a6272ef6335ed5db5eaea217a204ca1d567bd1bded5d957d9e66dde84aba

data/CHANGELOG.md

@@ -1,9 +1,15 @@
+## [0.4.0] - 2026-04-06
+### Added
+- **Bypass Default Scope Support**:
+  - New `bypass_default_scope` configuration option for presets
+  - When enabled, unscopes `default_scope` from all defined models during record collection
+  - Ensures soft-deleted and other normally-hidden records are captured, preventing orphaned foreign key references in fixtures
+
 ## [0.3.18] - 2025-02-05
 ### Fixed
 - Fixed cross-model circular dependency handling in PgDumpGenerator
   - The `prevent_circular_dependency` method previously only worked for self-referential associations (e.g., `ServiceRate → ServiceRate`) due to a guard clause (`assoc.klass == model`) in `build_dependency_graph`
   - Removed the self-referential constraint so `prevent_circular_dependency` now correctly breaks cycles between different models (e.g., `Organization → User → Organization`)
-  - This bug was latent and became visible in Ruby 3.2.10 due to changes in hash/set iteration ordering that altered association traversal order
 
 ## [0.3.5 - 0.3.17] - 2025-01-14
 ### Fixed

data/README.md

@@ -329,6 +329,29 @@ RealDataTests.configure do |config|
 end
 ```
 
+### Bypassing Default Scopes
+
+Rails models sometimes define a `default_scope` that excludes certain records, such as soft-deleted ones:
+
+```ruby
+class VisitNote < ApplicationRecord
+  default_scope { where(deleted_at: nil) }
+end
+```
+
+By default, Real Data Tests respects these scopes, meaning soft-deleted records won't be included in your dumps. Since SQL fixtures should mirror what actually exists in the database, you can bypass default scopes to ensure all records are captured:
+
+```ruby
+RealDataTests.configure do |config|
+  config.preset :patient_data do |p|
+    p.bypass_default_scope
+
+    p.include_associations_for 'Patient', :visit_notes
+    p.include_associations_for 'VisitNote', :patient
+  end
+end
+```
+
 ### Best Practices for Association Control
 
 1. **Start with Global Rules**: Define global association rules that apply to most models
@@ -455,4 +478,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Real Data Tests project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/diasks2/real_data_tests/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Real Data Tests project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/diasks2/real_data_tests/blob/main/CODE_OF_CONDUCT.md).

data/lib/real_data_tests/configuration.rb

@@ -74,10 +74,19 @@ module RealDataTests
       @prevent_reciprocal_loading = {}
       @anonymization_rules = {}
       @prevented_reciprocals = Set.new
+      @bypass_default_scope = false
       @max_depth = 10
       @max_self_ref_depth = 2
     end
 
+    def bypass_default_scope(value = true)
+      @bypass_default_scope = value
+    end
+
+    def bypass_default_scope?
+      @bypass_default_scope
+    end
+
     def prevent_circular_dependency(klass, association_name)
       key = if klass.is_a?(String)
         "#{klass}:#{association_name}"

data/lib/real_data_tests/record_collector.rb

@@ -61,11 +61,11 @@ module RealDataTests
       record.class.reflect_on_all_associations(:belongs_to).each do |assoc|
         next unless assoc.polymorphic?
 
-        type = record.public_send("#{assoc.name}_type")
+        type = record.public_send(assoc.foreign_type)
         @collection_stats[record.class.name][:polymorphic_types][assoc.name.to_sym] ||= Set.new
 
         begin
-          associated_record = record.public_send(assoc.name)
+          associated_record = load_association(record, assoc)
           if associated_record
             puts "  Adding polymorphic type '#{type}' for #{assoc.name}"
             @collection_stats[record.class.name][:polymorphic_types][assoc.name.to_sym] << associated_record.class.name
@@ -215,9 +215,9 @@ module RealDataTests
     def fetch_related_records(record, association)
       case association.macro
       when :belongs_to, :has_one
-        Array(record.public_send(association.name)).compact
+        Array(load_association(record, association)).compact
       when :has_many, :has_and_belongs_to_many
-        relation = record.public_send(association.name)
+        relation = load_association(record, association)
 
         if limit = RealDataTests.configuration.current_preset.get_association_limit(record.class, association.name)
           puts "    Applying configured limit of #{limit} records for #{record.class.name}.#{association.name}"
@@ -230,6 +230,44 @@ module RealDataTests
       end
     end
 
+    def load_association(record, association)
+      if RealDataTests.configuration.current_preset.bypass_default_scope?
+        load_association_unscoped(record, association)
+      else
+        record.public_send(association.name)
+      end
+    end
+
+    def load_association_unscoped(record, association)
+      if association.polymorphic?
+        type_value = record.public_send(association.foreign_type)
+        id_value = record.public_send(association.foreign_key)
+        return nil if type_value.blank? || id_value.blank?
+        klass = type_value.constantize
+        klass.unscoped.find_by(klass.primary_key => id_value)
+      else
+        case association.macro
+        when :belongs_to, :has_one
+          # If the association was loaded at any point before the collector runs, reset it so that the
+          # default scopes are properly bypassed.
+          record.association(association.name).reset
+          without_default_scope(association) { record.public_send(association.name) }
+        when :has_many, :has_and_belongs_to_many
+          without_default_scope(association) { record.public_send(association.name).to_a }
+        end
+      end
+    end
+
+    def without_default_scope(association)
+      if association.through_reflection?
+        association.through_reflection.klass.unscoped do
+          association.klass.unscoped { yield }
+        end
+      else
+        association.klass.unscoped { yield }
+      end
+    end
+
     def print_collection_stats
       puts "\n=== Collection Statistics ==="
       @collection_stats.each do |model, stats|
@@ -254,4 +292,4 @@ module RealDataTests
       puts "==============================\n"
     end
   end
-end
+end

data/lib/real_data_tests/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RealDataTests
-  VERSION = "0.3.18"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: real_data_tests
 version: !ruby/object:Gem::Version
-  version: 0.3.18
+  version: 0.4.0
 platform: ruby
 authors:
 - Kevin Dias
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-05 00:00:00.000000000 Z
+date: 2026-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails