fixtury 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dad3194d36ce43bfc6331ae5f8ed37abbf7509496f8b6d6344313f9512f22f8
-  data.tar.gz: d0c0324b038362cda1f2f12ad100fef087edb931c2aeb417d6ea04e0292aa4fa
+  metadata.gz: 03e33235b7dd547261eea486aee6d6ed0351157a11d1c76757d49b27c93b1b39
+  data.tar.gz: 8bd05c9be267d73b48b55fd7f20a4f6164ea22b41ba3ec889a8fd63026240e2c
 SHA512:
-  metadata.gz: c7a86120bf86a3cddc62c1d36294683fe2cd280d7aa8fa2e05af1d4b81f5c9fe99e7f5086b5028173c3d580c15b50665591f8377d153a098030ca317bfab839c
-  data.tar.gz: d8a18793cee0e6f4172e3d64826fd218c028e0b3ad1a9c33496877e5c5841cefd4741adf55bdf7ea119074822e0ea0f7c87134f565147ab71ffd82b09f2cf667
+  metadata.gz: a1a4e6331284da0e92b6af11567dd8d8e35ac079ddb8029a2c10ddc42538bce1157964dd923dda9a42819aedfc765d7095711863714d2490ed05759090ee0bc4
+  data.tar.gz: fa19480c1a11de53003580bf1a328561c00b11922c2aaeb34925961e8ab2a173a0185cbbd9db4ff60735ea2d013da16c914ae7e4e4f7df706d86289f15fa69a2

data/.github/dependabot.yml

@@ -21,4 +21,15 @@ updates:
     open-pull-requests-limit: 20
     insecure-external-code-execution: deny
     commit-message:
-      prefix: "[bundler] "      
+      prefix: "[bundler] "   
+    groups:
+      monthly:
+        patterns:
+          - "*"   
+    ignore:
+      - dependency-name: "activesupport"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "activemodel"
+        update-types: ["version-update:semver-major"]          
+      - dependency-name: "activerecord"
+        update-types: ["version-update:semver-major"]      

data/.github/workflows/build.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby-version: [3.2.2]
+        ruby-version: [3.2.6]
         experimental: [false]
     steps:
       - uses: actions/checkout@v4

data/.ruby-version

@@ -1 +1 @@
-3.2.2
+3.2.6

data/Gemfile.lock

@@ -1,56 +1,80 @@
 PATH
   remote: .
   specs:
-    fixtury (1.0.0)
+    fixtury (2.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (7.1.3.2)
-      activesupport (= 7.1.3.2)
-    activerecord (7.1.3.2)
-      activemodel (= 7.1.3.2)
-      activesupport (= 7.1.3.2)
+    activemodel (7.2.2.1)
+      activesupport (= 7.2.2.1)
+    activerecord (7.2.2.1)
+      activemodel (= 7.2.2.1)
+      activesupport (= 7.2.2.1)
       timeout (>= 0.4.0)
-    activesupport (7.1.3.2)
+    activesupport (7.2.2.1)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
     base64 (0.2.0)
-    bigdecimal (3.1.7)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
     byebug (11.1.3)
-    concurrent-ruby (1.2.3)
+    concurrent-ruby (1.3.4)
     connection_pool (2.4.1)
     drb (2.2.1)
     globalid (1.2.1)
       activesupport (>= 6.1)
-    i18n (1.14.4)
+    i18n (1.14.6)
       concurrent-ruby (~> 1.0)
+    logger (1.6.4)
     m (1.6.2)
       method_source (>= 0.6.7)
       rake (>= 0.9.2.2)
     method_source (1.1.0)
-    mini_portile2 (2.8.6)
-    minitest (5.22.3)
-    mocha (2.2.0)
+    mini_portile2 (2.8.8)
+    minitest (5.25.4)
+    mocha (2.7.1)
       ruby2_keywords (>= 0.0.5)
-    mutex_m (0.2.0)
     rake (13.2.1)
     ruby2_keywords (0.0.5)
-    sqlite3 (1.7.2)
+    securerandom (0.4.1)
+    sqlite3 (2.5.0)
       mini_portile2 (~> 2.8.0)
-    timeout (0.4.1)
+    sqlite3 (2.5.0-aarch64-linux-gnu)
+    sqlite3 (2.5.0-aarch64-linux-musl)
+    sqlite3 (2.5.0-arm-linux-gnu)
+    sqlite3 (2.5.0-arm-linux-musl)
+    sqlite3 (2.5.0-arm64-darwin)
+    sqlite3 (2.5.0-x86-linux-gnu)
+    sqlite3 (2.5.0-x86-linux-musl)
+    sqlite3 (2.5.0-x86_64-darwin)
+    sqlite3 (2.5.0-x86_64-linux-gnu)
+    sqlite3 (2.5.0-x86_64-linux-musl)
+    timeout (0.4.3)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
 
 PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
   ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
 
 DEPENDENCIES
   activerecord
@@ -64,5 +88,42 @@ DEPENDENCIES
   rake
   sqlite3
 
+CHECKSUMS
+  activemodel (7.2.2.1) sha256=8398861f9ee2c4671a8357ab39e9b38a045fd656f6685a3dd5890c2419dbfdaf
+  activerecord (7.2.2.1) sha256=79a31f71c32d5138717c2104e0ff105f5d82922247c85bdca144f2720e67fab9
+  activesupport (7.2.2.1) sha256=842bcbf8a92977f80fb4750661a237cf5dd4fdd442066b3c35e88afb488647f5
+  base64 (0.2.0) sha256=0f25e9b21a02a0cc0cea8ef92b2041035d39350946e8789c562b2d1a3da01507
+  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
+  drb (2.2.1) sha256=e9d472bf785f558b96b25358bae115646da0dbfd45107ad858b0bc0d935cb340
+  fixtury (2.0.0)
+  globalid (1.2.1) sha256=70bf76711871f843dbba72beb8613229a49429d1866828476f9c9d6ccc327ce9
+  i18n (1.14.6) sha256=dc229a74f5d181f09942dd60ab5d6e667f7392c4ee826f35096db36d1fe3614c
+  logger (1.6.4) sha256=b627b91c922231050932e7bf8ee886fe54790ba2238a468ead52ba21911f2ee7
+  m (1.6.2) sha256=2fb85aff050b6b699e6dbca47b45d426e2136ccdfabb64437e9630230d29108e
+  method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
+  mini_portile2 (2.8.8) sha256=8e47136cdac04ce81750bb6c09733b37895bf06962554e4b4056d78168d70a75
+  minitest (5.25.4) sha256=9cf2cae25ac4dfc90c988ebc3b917f53c054978b673273da1bd20bcb0778f947
+  mocha (2.7.1) sha256=8f7d538d5d3ebc75fc788b3d92fbab913a93a78462d2a3ce99d1bdde7af7f851
+  rake (13.2.1) sha256=46cb38dae65d7d74b6020a4ac9d48afed8eb8149c040eccf0523bec91907059d
+  ruby2_keywords (0.0.5) sha256=ffd13740c573b7301cf7a2e61fc857b2a8e3d3aff32545d6f8300d8bae10e3ef
+  securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
+  sqlite3 (2.5.0) sha256=87fa0036e6369c3f3cfeca749865c2b2b63649d3b17b223d1939a8eed4841a6b
+  sqlite3 (2.5.0-aarch64-linux-gnu) sha256=302085c3b932c027bc8de9f45fb5d0a3dc502357908dcc8f9bc8a92e4e9c7ab1
+  sqlite3 (2.5.0-aarch64-linux-musl) sha256=f6c8d25a6c7175bed154da82bc4c1ea3ef48580aeca17400b2e730c026821857
+  sqlite3 (2.5.0-arm-linux-gnu) sha256=5f22b4c72c38570593f9fe351751cb269568594525e0e3e0776187a3f1a55f32
+  sqlite3 (2.5.0-arm-linux-musl) sha256=b8e672106f341e9e4c85cdbc218710521c92082eec0ba61c180fb27a9c7780c6
+  sqlite3 (2.5.0-arm64-darwin) sha256=65370ddbc7bd7e65a03c18f8bf0e9be0f4f3cf50f758f8c1d3181aece5515ecf
+  sqlite3 (2.5.0-x86-linux-gnu) sha256=90488e9278ff23b9b22387a01354d5350b94d346fa9ab09256f154d0ca90dec6
+  sqlite3 (2.5.0-x86-linux-musl) sha256=09dd65d3752fb9d5cd93df841cbc357d2d117118f96f8b4122cd9cb38e020295
+  sqlite3 (2.5.0-x86_64-darwin) sha256=e3c6d2fa04db9d0773455cb6c79835f230c363424b69c34dd718e1aff8609d35
+  sqlite3 (2.5.0-x86_64-linux-gnu) sha256=c62c8d625da7e2ce93d694f02cd9c9d537638f56b09f2e8f28bea2d030b3923b
+  sqlite3 (2.5.0-x86_64-linux-musl) sha256=09fd262943eeb89465f6633e748b702b046de24cdab14b197302d0f4a0e250cb
+  timeout (0.4.3) sha256=9509f079b2b55fe4236d79633bd75e34c1c1e7e3fb4b56cb5fda61f80a0fe30e
+  tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b
+
 BUNDLED WITH
-   2.5.6
+   2.6.2

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/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,34 +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
-      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?
-      end
     end
 
     # Load all fixture dependencies that have not previously been loaded into the store.
@@ -180,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/reference.rb

@@ -21,7 +21,7 @@ module Fixtury
     def initialize(name, locator_key, **metadata)
       @name = name
       @locator_key = locator_key
-      @created_at = Time.now.to_i
+      @created_at = Fixtury.now.to_i
       @metadata = metadata
     end
 

data/lib/fixtury/store.rb

@@ -236,7 +236,7 @@ module Fixtury
     # @param ref [Fixtury::Reference] The reference to check.
     # @return [TrueClass, FalseClass] `true` if the reference is stale, `false` otherwise.
     def reference_stale?(ref)
-      return true if ttl && ref.created_at < (Time.now.to_i - ttl)
+      return true if ttl && ref.created_at < (Fixtury.now.to_i - ttl)
 
       !locator.recognizable_key?(ref.locator_key)
     end

data/lib/fixtury/version.rb

@@ -2,6 +2,6 @@
 
 module Fixtury
 
-  VERSION = "1.0.0"
+  VERSION = "2.0.0"
 
 end

data/lib/fixtury.rb

@@ -61,6 +61,12 @@ module Fixtury
     @hooks ||= ::Fixtury::Hooks.new
   end
 
+  def self.now
+    hooks.call(:time_access) do
+      ::Time.now
+    end
+  end
+
   # The default top level schema. Fixtury::Schema instances can be completely self-contained but most
   # usage would be through this shared definition.
   def self.schema

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixtury
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Mike Nelson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-13 00:00:00.000000000 Z
+date: 2025-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -198,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.15
+rubygems_version: 3.5.23
 signing_key:
 specification_version: 4
 summary: Treat fixtures like factories and factories like fixtures