foundries 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12575eccffc55ee4735cc1fe6cb981ed1109d252d45b6435ab4b8333862f2663
-  data.tar.gz: 5ecb9d8707258542b76ec9e72caf4daa3619d72c0dff8f4778163a880302aa3b
+  metadata.gz: 26171ce16e8737361c8ac3dcfbed573f17ec11d274eade9a26b465b6a687bfd2
+  data.tar.gz: 384a4c0d4f68ed3bb706262a3cea621666549d96e825b53884797c56f906cf8d
 SHA512:
-  metadata.gz: bb1eba53555fdf59b449b06cef7e973516341d2806ceed56d42d2e26a43e58be877bf6459cb551b71610acb6790a7f001a3761b5098b25245bb8d3c58be6805e
-  data.tar.gz: ef7bd963c7c76e978a96ffed6562358a47cbfdb0da52e873f9613b4aecb3bcc357a4143282b7ff743ddada31e142fcdb8bd395035fa99291dbef4b890d06f419
+  metadata.gz: 53632c7bc3809bb486bad25597d4044d75c3b923a4657bca554d4ca57b58de2524bcd9d054fc86fdf1c3dae71920ab93c873cd72252b70e447a6b8af6b74da68
+  data.tar.gz: f73d427438035744750939c0a1f75491a3c930b1943bce3b97e007868a8e06ff0daeffaea0acd2e7937a322759991f074259a3d9a886d1371df8a6d78db93ce4

data/CHANGELOG.md

@@ -5,21 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [0.1.6] - 2026-08-25
+## [0.1.7] - 2026-09-10
 
-### Fixed
+### Added
 
-- Snapshot files are read and written in binary, so captured data with non-ASCII bytes round-trips (6a7d3a3)
-- Restoring a snapshot no longer rewinds a sequence below its current value (df66836)
+- Foundries::Snapshot.with_lock for application-owned snapshot caches (fe91e06)
 
-## [0.1.5] - 2026-08-12
+### Fixed
 
-### Changed
+- Serialize snapshot publication and restoration across workers (fe91e06)
+- Reject incomplete snapshots before restoring rows (fe91e06)
+- Clean staging directories after failed snapshot captures (fe91e06)
+- Restore parent context when a nested blueprint block raises (7fd6e4b)
 
-- Development dependencies are locked (1129826)
+## [0.1.6] - 2026-08-25
 
 ### Fixed
 
-- Snapshot no longer caches a partial tree when a preset writes to a table that already held rows (2e9f863)
-- Lint under standard 1.56.0 (52be9eb)
-- Releases write a SHA512 checksum again (813a2ae)
+- Snapshot files are read and written in binary, so captured data with non-ASCII bytes round-trips (6a7d3a3)
+- Restoring a snapshot no longer rewinds a sequence below its current value (df66836)

data/lib/foundries/base.rb

@@ -187,7 +187,9 @@ module Foundries
 
     def execute_and_restore_state
       initial_state = @current.dup
-      yield.tap { @current = initial_state }
+      yield
+    ensure
+      @current = initial_state
     end
 
     def load_state(object)

data/lib/foundries/snapshot/store.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "fileutils"
+require "tmpdir"
 
 module Foundries
   module Snapshot
@@ -18,9 +19,7 @@ module Foundries
       end
 
       def cached?
-        cache_dir.exist? &&
-          cache_dir.join(".fingerprint").exist? &&
-          cache_dir.join(".fingerprint").read.strip == @fingerprint.current
+        with_lock { valid_cache? }
       end
 
       # Record which tables are empty before the preset block runs.
@@ -55,8 +54,8 @@ module Foundries
 
         tables = @capturable_tables || @adapter.table_names
 
-        tmp_dir = Pathname.new("#{cache_dir}.#{$$}.tmp")
-        tmp_dir.mkpath
+        FileUtils.mkdir_p(@storage_path)
+        tmp_dir = Pathname.new(Dir.mktmpdir("#{@preset_name}.", @storage_path))
 
         tables.each do |table|
           tmp_dir.join("#{table}.dat").open("wb") do |f|
@@ -64,29 +63,50 @@ module Foundries
           end
         end
 
+        tmp_dir.join(".tables").write(tables.join("\n"))
         tmp_dir.join(".fingerprint").write(@fingerprint.current)
 
-        # Atomic swap
-        FileUtils.rm_rf(cache_dir) if cache_dir.exist?
-        FileUtils.mv(tmp_dir, cache_dir)
+        with_lock do
+          FileUtils.rm_rf(cache_dir)
+          FileUtils.mv(tmp_dir, cache_dir)
+        end
+      ensure
+        FileUtils.rm_rf(tmp_dir) if tmp_dir
       end
 
       def restore
-        @adapter.disable_referential_integrity do
-          cache_dir.glob("*.dat").each do |file|
-            next unless file.size > 0
+        with_lock do
+          raise "Invalid or incomplete snapshot: #{@preset_name}" unless valid_cache?
+
+          @adapter.disable_referential_integrity do
+            captured_tables.each do |table|
+              file = cache_dir.join("#{table}.dat")
+              next unless file.size > 0
 
-            table = file.basename(".dat").to_s
-            file.open("rb") do |f|
-              @adapter.restore(table, f)
+              file.open("rb") { |io| @adapter.restore(table, io) }
+              @adapter.reset_sequence(table)
             end
-            @adapter.reset_sequence(table)
           end
         end
       end
 
       private
 
+      def with_lock(&block)
+        Snapshot.with_lock(@preset_name, storage_path: @storage_path, &block)
+      end
+
+      def captured_tables
+        cache_dir.join(".tables").read.lines.map(&:chomp)
+      end
+
+      def valid_cache?
+        stamp = cache_dir.join(".fingerprint")
+        stamp.file? && stamp.read.strip == @fingerprint.current &&
+          cache_dir.join(".tables").file? &&
+          captured_tables.all? { |table| cache_dir.join("#{table}.dat").file? }
+      end
+
       # Pre-populated tables whose row count moved while the preset ran. Their
       # new rows can't be told apart from the ones that were already there, so
       # the snapshot would silently omit them.

data/lib/foundries/snapshot.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "digest"
+require "fileutils"
 require_relative "snapshot/fingerprint"
 require_relative "snapshot/adapter"
 require_relative "snapshot/adapters/postgres_adapter"
@@ -12,6 +13,19 @@ module Foundries
     class << self
       attr_writer :storage_path, :connection, :enabled, :source_paths
 
+      # Keep the lock outside the replaceable cache directory. Readers and
+      # publishers must hold it for the entire filesystem operation.
+      def with_lock(name, storage_path: self.storage_path)
+        FileUtils.mkdir_p(storage_path)
+        lock_path = File.join(storage_path, "#{name}.lock")
+        File.open(lock_path, File::RDWR | File::CREAT, 0o600) do |lock|
+          lock.flock(File::LOCK_EX)
+          yield
+        ensure
+          lock.flock(File::LOCK_UN)
+        end
+      end
+
       def storage_path
         @storage_path || "tmp/foundries"
       end

data/lib/foundries/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Foundries
-  VERSION = "0.1.6"
-  RELEASE_DATE = "2026-08-25"
+  VERSION = "0.1.7"
+  RELEASE_DATE = "2026-09-10"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foundries
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - John Dowd