fixtury 1.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 514698ec587a7323fdc0cb3c81c93dd9666e16c87d7f5f2aa867d1cd6ac95ee3
-  data.tar.gz: dd34ff54006e203bef96d6fce2c4c1dd2c97f9143d2d29d5e022c496600e0aff
+  metadata.gz: 1d721c0d209b0c6d3862fbbc522c7c658de4b65ec717dd06cd14c3fdc1813841
+  data.tar.gz: 139981e92652bd20c0c272324e0c0e0c24ac06ad1d22f7bb46c2e01719d358ca
 SHA512:
-  metadata.gz: 0d1b1f1222fb51994a2ce522fcdec21b8b7bb3198eaecac72d7924d59996e5f0200c00a90dca5dbc75efded7292f26593bff266844bfb41ffd8214d9f25ae469
-  data.tar.gz: e3bc71e4a40c3a40f12e23895e55cee83fa34b93d5db13e486c62a2e004671e64f775712dd71ba68ed4441de622ce667d2a43529ea2dacb47dafcfd3b1fb0119
+  metadata.gz: 874a770245b43bec8d2de2d116acf0b7ea4e4b40565561784f25318c731afcca0c0e07078cec7ffef4988674a168f34891aeecdae1b55dfdd11309cfd08fb411
+  data.tar.gz: 19539f08615abc69f2b4659107336478424c917e83f6200457be6d8cb25e3b6157b1e75cf235abcd8d11051bdbf8070e1a2aa881df7be4feb5da2ab5df436a0e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fixtury (1.0.1)
+    fixtury (2.0.2)
 
 GEM
   remote: https://rubygems.org/
@@ -28,14 +28,14 @@ GEM
     benchmark (0.4.0)
     bigdecimal (3.1.9)
     byebug (11.1.3)
-    concurrent-ruby (1.3.4)
-    connection_pool (2.4.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
     drb (2.2.1)
     globalid (1.2.1)
       activesupport (>= 6.1)
-    i18n (1.14.6)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    logger (1.6.4)
+    logger (1.6.5)
     m (1.6.2)
       method_source (>= 0.6.7)
       rake (>= 0.9.2.2)
@@ -96,13 +96,13 @@ CHECKSUMS
   benchmark (0.4.0) sha256=0f12f8c495545e3710c3e4f0480f63f06b4c842cc94cec7f33a956f5180e874a
   bigdecimal (3.1.9) sha256=2ffc742031521ad69c2dfc815a98e426a230a3d22aeac1995826a75dabfad8cc
   byebug (11.1.3) sha256=2485944d2bb21283c593d562f9ae1019bf80002143cc3a255aaffd4e9cf4a35b
-  concurrent-ruby (1.3.4) sha256=d4aa926339b0a86b5b5054a0a8c580163e6f5dcbdfd0f4bb916b1a2570731c32
-  connection_pool (2.4.1) sha256=0f40cf997091f1f04ff66da67eabd61a9fe0d4928b9a3645228532512fab62f4
+  concurrent-ruby (1.3.5) sha256=813b3e37aca6df2a21a3b9f1d497f8cbab24a2b94cab325bffe65ee0f6cbebc6
+  connection_pool (2.5.0) sha256=233b92f8d38e038c1349ccea65dd3772727d669d6d2e71f9897c8bf5cd53ebfc
   drb (2.2.1) sha256=e9d472bf785f558b96b25358bae115646da0dbfd45107ad858b0bc0d935cb340
-  fixtury (1.0.1)
+  fixtury (2.0.2)
   globalid (1.2.1) sha256=70bf76711871f843dbba72beb8613229a49429d1866828476f9c9d6ccc327ce9
-  i18n (1.14.6) sha256=dc229a74f5d181f09942dd60ab5d6e667f7392c4ee826f35096db36d1fe3614c
-  logger (1.6.4) sha256=b627b91c922231050932e7bf8ee886fe54790ba2238a468ead52ba21911f2ee7
+  i18n (1.14.7) sha256=ceba573f8138ff2c0915427f1fc5bdf4aa3ab8ae88c8ce255eb3ecf0a11a5d0f
+  logger (1.6.5) sha256=c3cfe56d01656490ddd103d38b8993d73d86296adebc5f58cefc9ec03741e56b
   m (1.6.2) sha256=2fb85aff050b6b699e6dbca47b45d426e2136ccdfabb64437e9630230d29108e
   method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
   mini_portile2 (2.8.8) sha256=8e47136cdac04ce81750bb6c09733b37895bf06962554e4b4056d78168d70a75
@@ -126,4 +126,4 @@ CHECKSUMS
   tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b
 
 BUNDLED WITH
-   2.6.2
+   2.6.3

data/README.md

@@ -21,7 +21,7 @@ class MyTest < ::Minitest::Test
 end
 ```
 
-Loading this file would ensure `users/fresh` is loaded into the fixture set before the suite is run. In the context of Minitest::Test, the Fixtury::MinitestHooks file will ensure the database records are present prior to your suite running. If you're using ActiveRecord `use_transactional_fixtures` and `use_transactional_tests` will be respected.
+Loading this file would ensure `users/fresh` is loaded into the fixture set before the suite is run. In the context of Minitest::Test, the Fixtury::MinitestHooks file will ensure the fixtures are present prior to your suite running.
 
 ## Configuration
 
@@ -109,3 +109,5 @@ end
 
 When installed with the railtie, a MutationObserver module is prepended into ActiveRecord::Base. It observes record mutations and ensures a record is not mutated outside of the declared isolation level. If you're not using ActiveRecord check out Fixtury::MutationObserver to see how you could hook into other frameworks.
 
+In your test suite when utilizing the Fixtury::MinitestHooks records will be loaded before ActiveRecord's transactional fixtures transaction is opened. This means the you can define all your fixtures in your tests, they will be prebuilt and, as long as the fixtury references are preserved, all your fixtures are cached across runs. The fixtures in each file are loaded on demand which means only the fixtures necessary for the test to run are prebuilt (and cached for reuse). Standard transactional fixture rollback occurs after each test run so any mutation to fixtures will not be persisted.
+

data/lib/fixtury/errors.rb

@@ -25,8 +25,12 @@ module Fixtury
 
     class DefinitionExecutionError < Base
 
+      attr_reader :original_error
+
       def initialize(pathname, error)
-        super("Error while building #{pathname.inspect}: #{error}")
+        @original_error = error
+        super("Error while building #{pathname.inspect}: #{original_error}")
+        set_backtrace(original_error.backtrace)
       end
 
     end

data/lib/fixtury/minitest_hooks.rb

@@ -7,8 +7,7 @@ module Fixtury
   # MinitestHooks is a module designed to hook into a Minitest test case, and
   # provide a way to load fixtures into the test case. It is designed to be
   # prepended into the test case class, and will automatically load fixtures
-  # before the test case is setup, and rollback any changes after the test
-  # case is torn down.
+  # before the test case is setup.
   #
   # The module also provides a way to define fixture dependencies, and will
   # automatically load those dependencies before the test case is setup.
@@ -44,14 +43,15 @@ module Fixtury
   #
   #   end
   #
+  # Use `as: false` if you do not want an accessor created.
+  #
   # A Set object named fixtury_dependencies is made available on the test class.
   # This allows you to load all Minitest runnables and analyze what fixtures are
   # needed. This is very helpful in CI pipelines when you want to prepare all fixtures
   # ahead of time to share between multiple processes.
   #
-  # The setup and teardown attempt to manage a transaction for each registered database
-  # connection if ActiveRecord::Base is present. If use_transaction_tests or use_transactional_fixtures
-  # are present, those settings will be respected. If neither are present, a transaction will be used.
+  # It is the responsibility of the suite to manage the snapshot or rollback of the database. Generally
+  # something like ActiveRecord's use_transactional_fixtures will work just fine.
   module MinitestHooks
 
     def self.prepended(klass)
@@ -67,8 +67,7 @@ module Fixtury
     module ClassMethods
 
       # Declare fixtury dependencies for this test case. This will automatically
-      # load the fixtures before the test case is setup, and rollback any changes
-      # after the test case is torn down.
+      # load the fixtures before the test case is setup.
       #
       # @param searches [Array<String>] A list of fixture names to load. These should be resolvable paths relative to Fixtury.schema (root).
       # @param opts [Hash] A list of options to customize the behavior of the fixtures.
@@ -115,12 +114,6 @@ module Fixtury
       super
     end
 
-    # Minitest after_teardown hook. This will rollback any changes made to the fixtures after the test.
-    def after_teardown(...)
-      super
-      fixtury_teardown if fixtury_dependencies.any?
-    end
-
     # Access a fixture via a search term. This will access the fixture from the Fixtury store.
     # If the fixture was not declared as a dependency, an error will be raised.
     #
@@ -138,44 +131,10 @@ module Fixtury
       Fixtury.store.get(dfn.pathname)
     end
 
-    # Retrieve all database connections that are currently registered with a writing role.
-    #
-    # @return [Array<ActiveRecord::ConnectionAdapters::AbstractAdapter>] The list of database connections.
-    def fixtury_database_connections
-      return [] unless defined?(ActiveRecord::Base)
-
-      pools = ActiveRecord::Base.connection_handler.connection_pool_list(:writing)
-      pools.map { |pool| pool.respond_to?(:lease_connection) ? pool.lease_connection : pool.connection }
-    end
-
     # Load all dependenct fixtures and begin a transaction for each database connection.
     def fixtury_setup
       Fixtury.store.clear_stale_references!
       fixtury_load_all_fixtures!
-      return unless fixtury_use_transactions?
-
-      fixtury_database_connections.each do |conn|
-        conn.begin_transaction joinable: false
-        if conn.pool.respond_to?(:lock_thread=)
-          conn.pool.lock_thread = true
-        elsif conn.pool.respond_to?(:pin_connection!)
-          conn.pool.pin_connection!(true)
-        end
-      end
-    end
-
-    # Rollback any changes made to the fixtures
-    def fixtury_teardown
-      return unless fixtury_use_transactions?
-
-      fixtury_database_connections.each do |conn|
-        conn.rollback_transaction if conn.open_transactions.positive?
-        if conn.pool.respond_to?(:lock_thread=)
-          conn.pool.lock_thread = false
-        elsif conn.pool.respond_to?(:unpin_connection!)
-          conn.pool.unpin_connection!
-        end
-      end
     end
 
     # Load all fixture dependencies that have not previously been loaded into the store.
@@ -190,13 +149,5 @@ module Fixtury
       end
     end
 
-    # Adhere to common Rails test transaction settings.
-    def fixtury_use_transactions?
-      return use_transactional_tests if respond_to?(:use_transactional_tests)
-      return use_transactional_fixtures if respond_to?(:use_transactional_fixtures)
-
-      true
-    end
-
   end
 end

data/lib/fixtury/version.rb

@@ -2,6 +2,11 @@
 
 module Fixtury
 
-  VERSION = "1.0.1"
+  MAJOR       = 2
+  MINOR       = 0
+  PATCH       = 2
+  PRERELEASE  = nil
+
+  VERSION = [MAJOR, MINOR, PATCH, PRERELEASE].compact.join(".")
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixtury
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Mike Nelson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-02 00:00:00.000000000 Z
+date: 2025-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -147,7 +147,6 @@ files:
 - ".github/workflows/build.yml"
 - ".gitignore"
 - ".ruby-version"
-- ".travis.yml"
 - Gemfile
 - Gemfile.lock
 - README.md

data/.travis.yml

@@ -1,7 +0,0 @@
----
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.3.7
-before_install: gem install bundler -v 2.0.2