fixture_kit 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2addefdcd1d783d80888f69edb6953f8d6432471864bd1dafa915705a67ce317
-  data.tar.gz: fded508a51904f238bb5befffd3e3f9132e91010cb3ba74cdf159e0e40cefc67
+  metadata.gz: 90cf1c283943f0ec2cf0c82b5f5b6b65de810a1e4e5ed8d15fd12c4b2ba64879
+  data.tar.gz: 2eb935b512b373c399220ed60a6250b3d32349aa9dc5e4c31801d3db45a94b94
 SHA512:
-  metadata.gz: 2f1b4dc03ceb9edf697972849a4da270a8d6760c1885ffd3ddd579b96fd7896c29d0989bf044deb824d95c5bce598fe3fd5a45753dad674696ad312674963dc9
-  data.tar.gz: 6d11e943aac3c481c047579c4537782a35003603690e46d8ea23a172e5dbf93a3ae736f38738611a519c6f73d6e3b38516e8172b4c2397345d2ae4e441ddd0cc
+  metadata.gz: 8a4f49bf2e6422be97e8a316acfd623c9e27c861bc63c29465dc6d8fb331ddbff85a84aeede77d654e4e544096061b62c8aa9daa3bfac23ec5ae7d6dfc8db957
+  data.tar.gz: a799c0b665d6396837fb82ee50d6e193e3adde8114f0edb63d3f3ed5540205b486587a5ff1065ea5811c2b61fa0ed9cb10f0c43fba18da9b15eb0a913b76f660

data/lib/fixture_kit/cache.rb

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
+require "digest"
+
 module FixtureKit
   class Cache
     ANONYMOUS_DIRECTORY = "_anonymous"
+    DIGEST_LENGTH = 12
 
     include ConfigurationHelper
 
@@ -22,7 +25,8 @@ module FixtureKit
         if raw_identifier.is_a?(String)
           raw_identifier
         else
-          File.join(ANONYMOUS_DIRECTORY, FixtureKit.runner.adapter.identifier_for(raw_identifier))
+          normalized_scope = FixtureKit.runner.adapter.identifier_for(raw_identifier)
+          File.join(ANONYMOUS_DIRECTORY, "#{normalized_scope}.#{definition_digest}")
         end
       end
     end
@@ -62,6 +66,26 @@ module FixtureKit
 
     private
 
+    # The scope name alone does not identify a declaration site. Test
+    # frameworks derive it from the group description, which is lossy -- RSpec
+    # strips every non-alphanumeric character, so `Foo::Bar` and `"Foo Bar"`
+    # both become `FooBar` -- and, worse, not even unique within a process:
+    # test runners that load specs in batches call RSpec::Core::World#reset
+    # between them, which drops the constants RSpec disambiguates against, so
+    # the first group of a given description in *every* batch takes the
+    # unsuffixed name. The cache directory is cleared once per process, so
+    # without the digest two spec files sharing a top-level description share
+    # this entry, and the second fixture to generate silently mounts the
+    # first's records.
+    #
+    # Joined to the scope with a dot rather than an underscore: scope names are
+    # snake_case, so an underscore leaves no boundary between the two, while a
+    # dot cannot appear in one -- RSpec strips non-alphanumerics from the group
+    # description before it is underscored.
+    def definition_digest
+      Digest::SHA256.hexdigest(fixture.definition.fingerprint)[0, DIGEST_LENGTH]
+    end
+
     def evaluate(coders, context, data = {}, &block)
       if coders.empty?
         fixture.definition.evaluate(context, parent: fixture.parent&.mount)

data/lib/fixture_kit/definition.rb

@@ -14,6 +14,17 @@ module FixtureKit
       @definition.source_location.first
     end
 
+    def location
+      file, line = @definition.source_location
+      "#{file}:#{line}"
+    end
+
+    # Two definitions sharing a fingerprint evaluate the same block against the
+    # same parent, so they are interchangeable and may share a cache entry.
+    def fingerprint
+      "#{location}:#{extends}"
+    end
+
     def evaluate(context, parent: nil)
       context.singleton_class.prepend(mixin(parent))
       context.instance_exec(&@definition)

data/lib/fixture_kit/fixture.rb

@@ -19,6 +19,8 @@ module FixtureKit
     end
 
     def generate(force: false)
+      FixtureKit.runner.registry.claim_cache_identifier(self)
+
       return if @cache.exists? && !force
 
       parent&.generate

data/lib/fixture_kit/registry.rb

@@ -8,6 +8,7 @@ module FixtureKit
       @declarations = {}
       @fixtures = {}
       @resolving = []
+      @cache_owners = {}
     end
 
     def add(name_or_definition, scope = nil)
@@ -34,6 +35,23 @@ module FixtureKit
       @fixtures.values
     end
 
+    # Fixtures sharing a cache identifier share a cache file: the second one to
+    # generate finds the file already written, skips generation, and mounts the
+    # other's records. That is only safe when both declarations are the same, so
+    # anything else has to fail here -- otherwise it surfaces as a confusing
+    # NoMethodError on Repository, or not at all when both expose the same names.
+    # Identifiers are derived from the declaration site, so this is a backstop
+    # against a digest collision or a regression in that derivation.
+    def claim_cache_identifier(fixture)
+      owner = (@cache_owners[fixture.cache.identifier] ||= fixture)
+      return if owner.equal?(fixture)
+      return if owner.definition.fingerprint == fixture.definition.fingerprint
+
+      raise FixtureKit::CacheIdentifierCollision,
+        "fixtures declared at #{owner.definition.location} and #{fixture.definition.location} " \
+        "both resolve to the cache identifier '#{fixture.cache.identifier}'"
+    end
+
     private
 
     def fetch_named_fixture(name)

data/lib/fixture_kit/version.rb

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

data/lib/fixture_kit.rb

@@ -6,6 +6,7 @@ module FixtureKit
   class InvalidFixtureDeclaration < Error; end
   class MultipleFixtures < Error; end
   class CacheMissingError < Error; end
+  class CacheIdentifierCollision < Error; end
   class FixtureDefinitionNotFound < Error; end
   class RunnerAlreadyStartedError < Error; end
   class CircularFixtureInheritance < Error; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixture_kit
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Ngan Pham
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-04 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport