fixture_kit 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e0215c05b7885a41bf05f4ecd197b5df0d2bec66a8994b9ffe3c5310523d7c2
-  data.tar.gz: 41f8326c8e2b24094d977127da376efcec101471d61a3da009cbb61a8683cce8
+  metadata.gz: 311fd09f37153fae9d8a09e3e41357c38f18e1e343794a758ae943dfdca3c40a
+  data.tar.gz: ee4257fc3c840f809a25204f300c766f872688c5c7417dc22155f001ba424882
 SHA512:
-  metadata.gz: 5315136c139de91a4d6a7bf325fdd9710a0583928b1f0dccdee0d8584afc9be050083ee174a0ddc3d538650d8509e4fd764731c4e547d5f9dacc2651690a454a
-  data.tar.gz: f7212cae51606a7e9ef8c80f7c27d9a95e6091b02f0873d2786241780bbd2a961d0f94a1e8cb0bc42cdd188276fc56526b2f1cba1136edeba66384824e255ab4
+  metadata.gz: bd8c58de66c08eeceab67e4f0b83a8a95d25291401272e96b51725db2b7a9f2b2592c24f1d6f6cb7b4f6b4716fa93fc768c4fc81afcf1974b9339e14b1b61fa9
+  data.tar.gz: 8d335927771e40d35142a69ee9bf911fcfb6c660af6cde28269a16643e86a468c017cf2f54e362f09d90a78bfeffe6320071d0230f6240969fc495de0e91c8f2

data/README.md

@@ -104,7 +104,7 @@ RSpec.describe Book do
 end
 ```
 
-`fixture` returns a `FixtureSet` and exposes records as methods (for example, `fixture.owner`).
+`fixture` returns a `Repository` and exposes records as methods (for example, `fixture.owner`).
 
 ### 3. Configure RSpec
 

data/lib/fixture_kit/{fixture_cache.rb → cache.rb}

@@ -6,7 +6,7 @@ require "active_support/core_ext/array/wrap"
 require "active_support/inflector"
 
 module FixtureKit
-  class FixtureCache
+  class Cache
     # In-memory cache to avoid re-reading/parsing JSON for every test
     @memory_cache = {}
 
@@ -15,7 +15,7 @@ module FixtureKit
 
       def clear_memory_cache(fixture_name = nil)
         if fixture_name
-          @memory_cache.delete(fixture_name.to_s)
+          @memory_cache.delete(fixture_name)
         else
           @memory_cache.clear
         end
@@ -34,18 +34,18 @@ module FixtureKit
         end
       end
 
-      # Pre-generate caches for all fixtures.
+      # Generate caches for all fixtures.
       # Each fixture is generated in a transaction that rolls back, so no data persists.
-      def pregenerate_all
-        fixture_path = FixtureKit.configuration.fixture_path
+      def generate_all
+        Registry.load_definitions
+        Registry.fixtures.each { |fixture| generate(fixture.name) }
+      end
 
-        # First, load all fixture files to register them
-        FixtureRegistry.load_definitions(fixture_path)
+      def generate(fixture_name)
+        clear(fixture_name)
 
-        # Then iterate over the registry and generate caches
-        FixtureRegistry.all_names.each do |name|
-          runner = FixtureRunner.new(name)
-          runner.generate_cache_only
+        FixtureKit.configuration.generator.run do
+          Runner.run(fixture_name, force: true)
         end
       end
     end
@@ -53,7 +53,7 @@ module FixtureKit
     attr_reader :records, :exposed
 
     def initialize(fixture_name)
-      @fixture_name = fixture_name.to_s
+      @fixture_name = fixture_name
       @records = {}
       @exposed = {}
     end
@@ -107,15 +107,15 @@ module FixtureKit
       File.write(cache_file_path, JSON.pretty_generate(data))
     end
 
-    # Query exposed records from the database and return a FixtureSet
-    def build_fixture_set
+    # Query exposed records from the database and return a Repository.
+    def build_repository
       exposed_records = @exposed.each_with_object({}) do |(name, value), hash|
         was_array = value.is_a?(Array)
         records = Array.wrap(value).map { |record_info| find_exposed_record(record_info.fetch("model"), record_info.fetch("id"), name) }
         hash[name.to_sym] = was_array ? records : records.first
       end
 
-      FixtureSet.new(exposed_records)
+      Repository.new(exposed_records)
     end
 
     private

data/lib/fixture_kit/{fixture_context.rb → definition_context.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module FixtureKit
-  class FixtureContext
+  class DefinitionContext
     attr_reader :exposed
 
     def initialize

data/lib/fixture_kit/fixture.rb

@@ -5,12 +5,12 @@ module FixtureKit
     attr_reader :name, :block
 
     def initialize(name, &block)
-      @name = name.to_sym
+      @name = name
       @block = block
     end
 
     def execute
-      context = FixtureContext.new
+      context = DefinitionContext.new
       context.instance_eval(&block) if block
       context.exposed
     end

data/lib/fixture_kit/registry.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module FixtureKit
+  module Registry
+    class << self
+      def fetch(name)
+        fixture = find(name)
+        return fixture if fixture
+
+        file_path = fixture_file_path(name)
+        unless File.file?(file_path)
+          raise FixtureKit::FixtureDefinitionNotFound,
+            "Could not find fixture definition file for '#{name}' at '#{file_path}'"
+        end
+
+        load file_path
+        find(name)
+      end
+
+      def find(name)
+        registry[name]
+      end
+
+      def fixtures
+        registry.values
+      end
+
+      def register(fixture)
+        registry[fixture.name] = fixture
+      end
+
+      # Load all fixture definition files.
+      # Uses `load` instead of `require` to ensure fixtures are registered
+      # even if the files were previously required (e.g., after a reset).
+      def load_definitions
+        fixture_path = FixtureKit.configuration.fixture_path
+        Dir.glob(File.join(fixture_path, "**/*.rb")).each do |file|
+          load file
+        end
+      end
+
+      def reset
+        @registry = nil
+      end
+
+      private
+
+      def fixture_file_path(name)
+        fixture_path = FixtureKit.configuration.fixture_path
+        File.expand_path(File.join(fixture_path, "#{name}.rb"))
+      end
+
+      def registry
+        @registry ||= {}
+      end
+    end
+  end
+end

data/lib/fixture_kit/{fixture_set.rb → repository.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module FixtureKit
-  class FixtureSet
+  class Repository
     def initialize(exposed_records)
       @records = exposed_records
       @records.each_value { |value| value.freeze if value.is_a?(Array) }

data/lib/fixture_kit/rspec/declaration.rb

@@ -6,11 +6,11 @@ module FixtureKit
       attr_reader :name
 
       def initialize(name)
-        @name = name.to_s
+        @name = name
       end
 
       def fixture_set
-        FixtureKit::FixtureRegistry.load_fixture(name)
+        FixtureKit::Runner.run(name)
       end
     end
   end

data/lib/fixture_kit/rspec.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 require "fixture_kit"
-require_relative "rspec/declaration"
-require_relative "rspec/generator"
 
 module FixtureKit
   module RSpec
+    autoload :Declaration, File.expand_path("rspec/declaration", __dir__)
+    autoload :Generator, File.expand_path("rspec/generator", __dir__)
+
     DECLARATION_METADATA_KEY = :fixture_kit_declaration
     PRESERVE_CACHE_ENV_KEY = "FIXTURE_KIT_PRESERVE_CACHE"
 
@@ -31,45 +32,57 @@ module FixtureKit
       #     end
       #   end
       def fixture(name)
-        metadata[FixtureKit::RSpec::DECLARATION_METADATA_KEY] = FixtureKit::RSpec::Declaration.new(name)
+        metadata[DECLARATION_METADATA_KEY] = Declaration.new(name)
       end
     end
 
     # Instance methods (included via config.include)
     module InstanceMethods
-      # Returns the FixtureSet for the current example's fixture.
+      # Returns the Repository for the current example's fixture.
       # Access exposed records as methods: fixture.alice, fixture.posts
       def fixture
         @_fixture_kit_fixture_set || raise("No fixture declared for this example group. Use `fixture \"name\"` in your describe/context block.")
       end
     end
-  end
-end
 
-# Install the RSpec generator by default for this entrypoint.
-FixtureKit.configuration.generator = FixtureKit::RSpec::Generator
+    def self.configure!(config)
+      FixtureKit.configuration.generator = Generator
+      config.extend ClassMethods
+      config.include InstanceMethods
 
-# Configure RSpec integration
-RSpec.configure do |config|
-  config.extend FixtureKit::RSpec::ClassMethods
-  config.include FixtureKit::RSpec::InstanceMethods
+      # Load declared fixtures at the beginning of each example.
+      # Runs inside transactional fixtures and before user-defined before hooks.
+      config.prepend_before(:example, DECLARATION_METADATA_KEY) do |example|
+        declaration = example.metadata[DECLARATION_METADATA_KEY]
+        @_fixture_kit_fixture_set = declaration.fixture_set
+      end
 
-  # Load declared fixtures at the beginning of each example.
-  # Runs inside transactional fixtures and before user-defined before hooks.
-  config.prepend_before(:example, FixtureKit::RSpec::DECLARATION_METADATA_KEY) do |example|
-    declaration = example.metadata[FixtureKit::RSpec::DECLARATION_METADATA_KEY]
-    @_fixture_kit_fixture_set = declaration.fixture_set
-  end
+      # Setup caches at suite start only when at least one fixture-backed
+      # example exists in the loaded suite.
+      config.when_first_matching_example_defined(DECLARATION_METADATA_KEY) do
+        config.before(:suite) do
+          if FixtureKit.configuration.autogenerate
+            preserve_cache = ENV[PRESERVE_CACHE_ENV_KEY].to_s.match?(/\A(1|true|yes)\z/i)
+            Cache.clear unless preserve_cache
+          else
+            fixture_names_for_loaded_examples.each do |fixture_name|
+              Cache.generate(fixture_name)
+            end
+          end
+        end
+      end
+    end
 
-  # Setup caches at suite start based on autogenerate setting
-  # - autogenerate=true: Clear all caches (unless FIXTURE_KIT_PRESERVE_CACHE is set)
-  # - autogenerate=false: Pre-generate all caches so tests don't fail
-  config.before(:suite) do
-    if FixtureKit.configuration.autogenerate
-      preserve_cache = ENV[FixtureKit::RSpec::PRESERVE_CACHE_ENV_KEY].to_s.match?(/\A(1|true|yes)\z/i)
-      FixtureKit::FixtureCache.clear unless preserve_cache
-    else
-      FixtureKit::FixtureCache.pregenerate_all
+    def self.fixture_names_for_loaded_examples
+      ::RSpec.world.filtered_examples.each_value.with_object(Set.new) do |examples, names|
+        examples.each do |example|
+          declaration = example.metadata[DECLARATION_METADATA_KEY]
+          names << declaration.name if declaration
+        end
+      end.to_a
     end
   end
 end
+
+# Configure RSpec integration
+FixtureKit::RSpec.configure!(RSpec.configuration)

data/lib/fixture_kit/{fixture_runner.rb → runner.rb}

@@ -3,14 +3,20 @@
 require "active_support/inflector"
 
 module FixtureKit
-  class FixtureRunner
+  class Runner
+    def self.run(fixture_name, force: false)
+      new(fixture_name).run(force: force)
+    end
+
     def initialize(fixture_name)
-      @fixture_name = fixture_name.to_sym
-      @cache = FixtureCache.new(@fixture_name)
+      @fixture_name = fixture_name
+      @cache = Cache.new(@fixture_name)
     end
 
-    def run
-      if @cache.exists?
+    def run(force: false)
+      if force
+        execute_and_cache
+      elsif @cache.exists?
         execute_from_cache
       elsif FixtureKit.configuration.autogenerate
         execute_and_cache
@@ -26,27 +32,10 @@ module FixtureKit
       end
     end
 
-    # Generate cache only (used for pregeneration in before(:suite))
-    # Wraps execution in the configured generator lifecycle.
-    # The default generator uses ActiveRecord::TestFixtures transactions.
-    # Entry points (like `fixture_kit/rspec`) can install richer generators.
-    # Always regenerates the cache, even if one exists
-    def generate_cache_only
-      # Clear any existing cache for this fixture
-      FixtureCache.clear(@fixture_name.to_s)
-
-      FixtureKit.configuration.generator.run do
-        execute_and_cache
-      end
-
-      true
-    end
-
     private
 
     def execute_and_cache
-      fixture = FixtureRegistry.find(@fixture_name)
-      raise ArgumentError, "Fixture '#{@fixture_name}' not found" unless fixture
+      fixture = Registry.fetch(@fixture_name)
 
       # Start capturing SQL
       capture = SqlCapture.new
@@ -64,8 +53,8 @@ module FixtureKit
         exposed_mapping: build_exposed_mapping(exposed)
       )
 
-      # Return FixtureSet from the exposed records
-      FixtureSet.new(exposed)
+      # Return Repository from the exposed records
+      Repository.new(exposed)
     end
 
     def execute_from_cache
@@ -80,8 +69,8 @@ module FixtureKit
         connection.execute(sql)
       end
 
-      # Query exposed records and build FixtureSet
-      @cache.build_fixture_set
+      # Query exposed records and build Repository.
+      @cache.build_repository
     end
 
     def build_exposed_mapping(exposed)

data/lib/fixture_kit/singleton.rb

@@ -22,14 +22,14 @@ module FixtureKit
       name = relative_path.to_s.sub(/\.rb$/, "")
 
       fixture = Fixture.new(name, &block)
-      FixtureRegistry.register(fixture)
+      Registry.register(fixture)
       fixture
     end
 
     def reset
       @configuration = nil
-      FixtureRegistry.reset
-      FixtureCache.clear_memory_cache
+      Registry.reset
+      Cache.clear_memory_cache
     end
   end
 end

data/lib/fixture_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FixtureKit
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/fixture_kit.rb

@@ -6,18 +6,19 @@ module FixtureKit
   class DuplicateNameError < Error; end
   class CacheMissingError < Error; end
   class PregenerationError < Error; end
+  class FixtureDefinitionNotFound < Error; end
   class ExposedRecordNotFound < Error; end
 
   autoload :VERSION,         File.expand_path("fixture_kit/version", __dir__)
   autoload :Configuration,   File.expand_path("fixture_kit/configuration", __dir__)
   autoload :Singleton,       File.expand_path("fixture_kit/singleton", __dir__)
   autoload :Fixture,         File.expand_path("fixture_kit/fixture", __dir__)
-  autoload :FixtureContext,  File.expand_path("fixture_kit/fixture_context", __dir__)
-  autoload :FixtureRegistry, File.expand_path("fixture_kit/fixture_registry", __dir__)
-  autoload :FixtureSet,      File.expand_path("fixture_kit/fixture_set", __dir__)
+  autoload :DefinitionContext, File.expand_path("fixture_kit/definition_context", __dir__)
+  autoload :Registry,        File.expand_path("fixture_kit/registry", __dir__)
+  autoload :Repository,      File.expand_path("fixture_kit/repository", __dir__)
   autoload :SqlCapture,      File.expand_path("fixture_kit/sql_capture", __dir__)
-  autoload :FixtureCache,    File.expand_path("fixture_kit/fixture_cache", __dir__)
-  autoload :FixtureRunner,   File.expand_path("fixture_kit/fixture_runner", __dir__)
+  autoload :Cache,           File.expand_path("fixture_kit/cache", __dir__)
+  autoload :Runner,          File.expand_path("fixture_kit/runner", __dir__)
   autoload :Generator,       File.expand_path("fixture_kit/generator", __dir__)
   autoload :TestCase,        File.expand_path("fixture_kit/test_case", __dir__)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixture_kit
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Ngan Pham
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-20 00:00:00.000000000 Z
+date: 2026-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -134,17 +134,17 @@ files:
 - LICENSE
 - README.md
 - lib/fixture_kit.rb
+- lib/fixture_kit/cache.rb
 - lib/fixture_kit/configuration.rb
+- lib/fixture_kit/definition_context.rb
 - lib/fixture_kit/fixture.rb
-- lib/fixture_kit/fixture_cache.rb
-- lib/fixture_kit/fixture_context.rb
-- lib/fixture_kit/fixture_registry.rb
-- lib/fixture_kit/fixture_runner.rb
-- lib/fixture_kit/fixture_set.rb
 - lib/fixture_kit/generator.rb
+- lib/fixture_kit/registry.rb
+- lib/fixture_kit/repository.rb
 - lib/fixture_kit/rspec.rb
 - lib/fixture_kit/rspec/declaration.rb
 - lib/fixture_kit/rspec/generator.rb
+- lib/fixture_kit/runner.rb
 - lib/fixture_kit/singleton.rb
 - lib/fixture_kit/sql_capture.rb
 - lib/fixture_kit/test_case.rb

data/lib/fixture_kit/fixture_registry.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module FixtureKit
-  module FixtureRegistry
-    class << self
-      def register(fixture)
-        fixtures[fixture.name.to_s] = fixture
-      end
-
-      def find(name)
-        fixtures[name.to_s]
-      end
-
-      def all_names
-        fixtures.keys
-      end
-
-      # Load all fixture definition files from the given path.
-      # Uses `load` instead of `require` to ensure fixtures are registered
-      # even if the files were previously required (e.g., after a reset).
-      def load_definitions(fixture_path)
-        Dir.glob(File.join(fixture_path, "**/*.rb")).each do |file|
-          load file
-        end
-      end
-
-      def reset
-        @fixtures = nil
-      end
-
-      # Load a fixture's records into the database and return a FixtureSet.
-      # Uses cached INSERT statements if available, otherwise executes fixture and caches.
-      def load_fixture(name)
-        name = name.to_s
-
-        # Load the file on-demand if fixture not yet registered
-        unless find(name)
-          fixture_path = FixtureKit.configuration.fixture_path
-          file_path = File.expand_path(File.join(fixture_path, "#{name}.rb"))
-          load file_path
-        end
-
-        runner = FixtureRunner.new(name)
-        runner.run
-      end
-
-      private
-
-      def fixtures
-        @fixtures ||= {}
-      end
-    end
-  end
-end