factory_trace 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8eb259ef9d3572a820e5fddc7a65d484f29a8d25bfdfa5947a8306cf3c22435f
-  data.tar.gz: 0b9eeaea9bf6355772994e4ca4d1dd7b62b82d43a00000c4453be067cad21376
+  metadata.gz: bd70e8ea6fe8ffb3e815147ea925478d36f4d298b9bbbd5b359b7d5e900d5265
+  data.tar.gz: e838d1f5525179c4fba7fa6daba3baf7ab8b23d27e981076069c3a4d33268472
 SHA512:
-  metadata.gz: 21c794f7215824581bd33ad9f90235c7c929e71803ace8bb3dfd8d0fe27ab912c052633141c21d23180b5244228b4ba38ef180284c1327da41678e618887d6f5
-  data.tar.gz: 3ef9526dfba81da0a0316aa4c45caa3b7a404c87e2573a320e719d03cc5f72d0bd041356d00d81a4dadb6fdaf8cacceb0c384a3c053ad096d6bfe3004f512807
+  metadata.gz: 0a0b4c5d0b471d570a4ab18567feed01559f861363779e4ba5010e8eb1b1a75a159d3affe54b0742da8c1909095df14cee0ec45eb7fbefcf3e594b8a58140037
+  data.tar.gz: 54b1804ed50d4ba0f327e9f18d100ad9c95c39c7ce6a373ed846aa5bbf8c6a9e7f5b42560db21b7922927aa135574a8f6d1acef6b39179b56bc911ba00dba151

data/lib/factory_trace/configuration.rb

@@ -2,7 +2,7 @@
 
 module FactoryTrace
   class Configuration
-    attr_accessor :path, :enabled, :color, :mode, :trace_definition
+    attr_accessor :path, :enabled, :color, :mode, :trace_definition, :fixture_path
 
     def initialize
       @enabled = ENV.key?("FB_TRACE") || ENV.key?("FB_TRACE_FILE")
@@ -10,6 +10,7 @@ module FactoryTrace
       @color = path.nil?
       @mode = extract_mode(ENV["FB_TRACE"]) || :full
       @trace_definition = true
+      @fixture_path = "test/fixtures"
     end
 
     def trace_definition?

data/lib/factory_trace/fixture_tracker.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module FactoryTrace
+  class FixtureTracker
+    attr_reader :storage
+
+    def initialize
+      @storage = {}
+    end
+
+    def track!
+      tracker_storage = @storage
+
+      ::ActiveRecord::FixtureSet.prepend(Module.new do
+        define_method(:[]) do |fixture_name|
+          if fixture_name
+            tracker_storage[name] ||= Set.new
+            tracker_storage[name].add(fixture_name.to_s)
+          end
+          super(fixture_name)
+        end
+      end)
+    end
+  end
+end

data/lib/factory_trace/monkey_patches/dsl.rb

@@ -10,7 +10,7 @@ module FactoryTrace
           proxy = FactoryBot::DefinitionProxy.new(factory.definition)
           proxy.instance_eval(&block) if block
 
-          REGISTER.register_factory(factory)
+          FactoryTrace.factory_bot_register.register_factory(factory)
 
           proxy.child_factories.each do |(child_name, child_caller_location, child_options, child_block)|
             parent_factory = child_options.delete(:parent) || name
@@ -19,7 +19,7 @@ module FactoryTrace
         end
 
         def trait(name, &block)
-          REGISTER.register_trait(FactoryBot::Trait.new(name, Helpers::Caller.location, &block))
+          FactoryTrace.factory_bot_register.register_trait(FactoryBot::Trait.new(name, Helpers::Caller.location, &block))
         end
       end
     end

data/lib/factory_trace/monkey_patches/monkey_patches.rb

@@ -2,6 +2,5 @@
 
 module FactoryTrace
   module MonkeyPatches
-    REGISTER = (FactoryBot::VERSION >= "5.1.0") ? FactoryBot::Internal : FactoryBot
   end
 end

data/lib/factory_trace/preprocessors/extract_defined.rb

@@ -7,7 +7,7 @@ module FactoryTrace
       def self.call
         collection = FactoryTrace::Structures::Collection.new
 
-        MonkeyPatches::REGISTER.traits.each do |trait|
+        FactoryTrace.factory_bot_register.traits.each do |trait|
           collection.add(FactoryTrace::Helpers::Converter.trait(trait))
         end
 

data/lib/factory_trace/preprocessors/extract_defined_fixtures.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module FactoryTrace
+  module Preprocessors
+    class ExtractDefinedFixtures
+      # Extracts all defined fixture sets and their entries from fixture YAML files
+      #
+      # @param [String, Array<String>] fixture_path path(s) to directories containing fixture YAML files
+      #
+      # @return [FactoryTrace::Structures::Collection]
+      def self.call(fixture_path)
+        collection = FactoryTrace::Structures::Collection.new
+
+        Array(fixture_path).each do |path|
+          Dir.glob(File.join(path, "**", "*.yml")).sort.each do |file|
+            fixture_set_name = File.basename(file, ".yml")
+            entries = parse_fixture_file(file)
+
+            traits = entries.map do |entry_name, definition_path|
+              FactoryTrace::Structures::Trait.new(entry_name, definition_path: definition_path)
+            end
+
+            factory = FactoryTrace::Structures::Factory.new(
+              [fixture_set_name],
+              traits,
+              definition_path: "#{file}:1"
+            )
+
+            collection.add(factory)
+          end
+        end
+
+        collection
+      end
+
+      # Parses a fixture YAML file and returns a hash of entry names to definition paths
+      #
+      # @param [String] file_path
+      #
+      # @return [Hash<String, String>]
+      def self.parse_fixture_file(file_path)
+        entries = {}
+        lineno = 1
+
+        File.foreach(file_path) do |line|
+          if (match = line.match(/\A(\w+):(?:\s|$)/))
+            entries[match[1]] = "#{file_path}:#{lineno}"
+          end
+          lineno += 1
+        end
+
+        entries
+      end
+
+      private_class_method :parse_fixture_file
+    end
+  end
+end

data/lib/factory_trace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FactoryTrace
-  VERSION = "2.0.0"
+  VERSION = "3.0.0"
 end

data/lib/factory_trace/writers/report_writer.rb

@@ -16,11 +16,14 @@ module FactoryTrace
       }.freeze
 
       # @param [Array<Hash>] results
-      def write(results)
+      # @param [Symbol] kind - :factory (default) or :fixture
+      def write(results, kind:)
+        io.puts("")
+
         total_color = (results.any? { |result| result[:code] == :unused && !result.key?(:value) }) ? :red : :green
 
         results.each do |result|
-          io.puts(convert(result, total_color: total_color))
+          io.puts(convert(result, total_color: total_color, kind: kind))
         end
       end
 
@@ -28,13 +31,23 @@ module FactoryTrace
 
       # @param [Hash<Symbol, Object>] result
       # @param [Symbol] total_color
-      def convert(result, total_color:)
+      # @param [Symbol] kind - :factory_bot or :fixtures
+      def convert(result, total_color:, kind:)
         if result[:value]
-          colorize(total_color, "total number of unique #{humanize_code(result[:code])} factories & traits: #{result[:value]}")
+          label = (kind == :fixtures) ? "fixture sets & entries" : "factories & traits"
+          colorize(total_color, "total number of unique #{humanize_code(result[:code])} #{label}: #{result[:value]}")
         elsif result[:factory_names] && result[:trait_name]
-          append_definition_path(result) { "#{humanize_code(result[:code])} trait #{colorize(:blue, result[:trait_name])} of factory #{list(result[:factory_names])}" }
+          if kind == :fixtures
+            append_definition_path(result) { "#{humanize_code(result[:code])} fixture entry #{colorize(:blue, result[:trait_name])} of fixture set #{list(result[:factory_names])}" }
+          else
+            append_definition_path(result) { "#{humanize_code(result[:code])} trait #{colorize(:blue, result[:trait_name])} of factory #{list(result[:factory_names])}" }
+          end
         elsif result[:factory_names]
-          append_definition_path(result) { "#{humanize_code(result[:code])} factory #{list(result[:factory_names])}" }
+          if kind == :fixtures
+            append_definition_path(result) { "#{humanize_code(result[:code])} fixture set #{list(result[:factory_names])}" }
+          else
+            append_definition_path(result) { "#{humanize_code(result[:code])} factory #{list(result[:factory_names])}" }
+          end
         else
           append_definition_path(result) { "#{humanize_code(result[:code])} global trait #{colorize(:blue, result[:trait_name])}" }
         end

data/lib/factory_trace/writers/trace_writer.rb

@@ -5,7 +5,14 @@ module FactoryTrace
     class TraceWriter < Writer
       # @param [FactoryTrace::Structures::Collection] defined
       # @param [FactoryTrace::Structures::Collection] used
-      def write(defined, used)
+      def write(defined, used, kind:)
+        io.puts("")
+        text =
+          case kind
+          when :factory_bot then "FactoryBot"
+          when :fixtures then "Fixtures"
+          end
+        io.puts("#{text} definitions and usages:")
         io.puts(JSON.pretty_generate(defined: defined.to_h, used: used.to_h))
       end
     end

data/lib/factory_trace.rb

@@ -2,7 +2,6 @@
 
 # External dependencies
 require "active_support"
-require "factory_bot"
 require "json"
 require "set"
 require "pathname"
@@ -13,6 +12,7 @@ require "factory_trace/helpers/converter"
 require "factory_trace/helpers/statusable"
 require "factory_trace/helpers/caller"
 require "factory_trace/tracker"
+require "factory_trace/fixture_tracker"
 
 require "factory_trace/structures/factory"
 require "factory_trace/structures/trait"
@@ -20,6 +20,7 @@ require "factory_trace/structures/collection"
 
 require "factory_trace/preprocessors/extract_defined"
 require "factory_trace/preprocessors/extract_used"
+require "factory_trace/preprocessors/extract_defined_fixtures"
 
 require "factory_trace/processors/find_unused"
 
@@ -44,19 +45,24 @@ module FactoryTrace
       return unless configuration.enabled
       trace_definitions! if configuration.trace_definition?
 
-      tracker.track!
+      tracker.track! if factory_bot?
+      fixture_tracker.track! if fixtures?
     end
 
     def stop
       return unless configuration.enabled
 
       # This is required to exclude parent traits from +defined_traits+
-      FactoryBot.reload
+      FactoryBot.reload if factory_bot?
 
       if configuration.mode?(:full)
-        Writers::ReportWriter.new(configuration.out, configuration).write(Processors::FindUnused.call(defined, used))
+        writer = Writers::ReportWriter.new(configuration.out, configuration)
+        writer.write(Processors::FindUnused.call(defined, used), kind: :factory_bot) if factory_bot?
+        writer.write(Processors::FindUnused.call(defined_fixtures, used_fixtures), kind: :fixtures) if fixtures?
       elsif configuration.mode?(:trace_only)
-        Writers::TraceWriter.new(configuration.out, configuration).write(defined, used)
+        writer = Writers::TraceWriter.new(configuration.out, configuration)
+        writer.write(defined, used, kind: :factory_bot) if factory_bot?
+        writer.write(defined_fixtures, used_fixtures, kind: :fixtures) if fixtures?
       end
     end
 
@@ -68,6 +74,10 @@ module FactoryTrace
       @configuration ||= Configuration.new
     end
 
+    def factory_bot_register
+      @factory_bot_register ||= (FactoryBot::VERSION >= "5.1.0") ? FactoryBot::Internal : FactoryBot
+    end
+
     private
 
     def used
@@ -82,7 +92,29 @@ module FactoryTrace
       @tracker ||= Tracker.new
     end
 
+    def fixture_tracker
+      @fixture_tracker ||= FixtureTracker.new
+    end
+
+    def defined_fixtures
+      @defined_fixtures ||= Preprocessors::ExtractDefinedFixtures.call(configuration.fixture_path)
+    end
+
+    def used_fixtures
+      @used_fixtures ||= Preprocessors::ExtractUsed.call(fixture_tracker.storage)
+    end
+
+    def factory_bot?
+      defined?(FactoryBot)
+    end
+
+    def fixtures?
+      defined?(ActiveRecord::FixtureSet)
+    end
+
     def trace_definitions!
+      return unless factory_bot?
+
       FactoryBot::Factory.prepend(FactoryTrace::MonkeyPatches::Factory)
       FactoryBot::Trait.prepend(FactoryTrace::MonkeyPatches::Trait)
       FactoryBot::Syntax::Default::DSL.prepend(FactoryTrace::MonkeyPatches::Default::DSL)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factory_trace
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - djezzzl
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-03-10 00:00:00.000000000 Z
+date: 2026-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_bot
@@ -17,7 +17,21 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
-  type: :runtime
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -91,6 +105,7 @@ files:
 - exe/factory_trace
 - lib/factory_trace.rb
 - lib/factory_trace/configuration.rb
+- lib/factory_trace/fixture_tracker.rb
 - lib/factory_trace/helpers/caller.rb
 - lib/factory_trace/helpers/converter.rb
 - lib/factory_trace/helpers/statusable.rb
@@ -100,6 +115,7 @@ files:
 - lib/factory_trace/monkey_patches/monkey_patches.rb
 - lib/factory_trace/monkey_patches/trait.rb
 - lib/factory_trace/preprocessors/extract_defined.rb
+- lib/factory_trace/preprocessors/extract_defined_fixtures.rb
 - lib/factory_trace/preprocessors/extract_used.rb
 - lib/factory_trace/processors/find_unused.rb
 - lib/factory_trace/readers/trace_reader.rb