foundries 0.1.0

data/lib/foundries/snapshot/store.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Foundries
+  module Snapshot
+    class Store
+      def initialize(preset_name, adapter: Snapshot.adapter,
+        storage_path: Snapshot.storage_path,
+        source_paths: Snapshot.source_paths)
+        @preset_name = preset_name.to_s
+        @adapter = adapter
+        @storage_path = storage_path
+        @fingerprint = Fingerprint.new(
+          adapter.instance_variable_get(:@connection),
+          source_paths: source_paths
+        )
+      end
+
+      def cached?
+        cache_dir.exist? &&
+          cache_dir.join(".fingerprint").exist? &&
+          cache_dir.join(".fingerprint").read.strip == @fingerprint.current
+      end
+
+      # Record which tables are empty before the preset block runs.
+      # Only these tables will be captured after the block completes.
+      def record_empty_tables
+        @capturable_tables = @adapter.table_names.select { |t| @adapter.empty?(t) }
+      end
+
+      def capture
+        tables = @capturable_tables || @adapter.table_names
+
+        tmp_dir = Pathname.new("#{cache_dir}.#{$$}.tmp")
+        tmp_dir.mkpath
+
+        tables.each do |table|
+          tmp_dir.join("#{table}.dat").open("w") do |f|
+            @adapter.capture(table, f)
+          end
+        end
+
+        tmp_dir.join(".fingerprint").write(@fingerprint.current)
+
+        # Atomic swap
+        FileUtils.rm_rf(cache_dir) if cache_dir.exist?
+        FileUtils.mv(tmp_dir, cache_dir)
+      end
+
+      def restore
+        @adapter.disable_referential_integrity do
+          cache_dir.glob("*.dat").each do |file|
+            next unless file.size > 0
+
+            table = file.basename(".dat").to_s
+            file.open("r") do |f|
+              @adapter.restore(table, f)
+            end
+            @adapter.reset_sequence(table)
+          end
+        end
+      end
+
+      private
+
+      def cache_dir
+        @cache_dir ||= Pathname.new(@storage_path).join(@preset_name)
+      end
+    end
+  end
+end

data/lib/foundries/snapshot.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "digest"
+require_relative "snapshot/fingerprint"
+require_relative "snapshot/adapter"
+require_relative "snapshot/adapters/postgres_adapter"
+require_relative "snapshot/adapters/sqlite_adapter"
+require_relative "snapshot/store"
+
+module Foundries
+  module Snapshot
+    class << self
+      attr_writer :storage_path, :connection, :enabled, :source_paths
+
+      def storage_path
+        @storage_path || "tmp/foundries"
+      end
+
+      def connection
+        @connection || ActiveRecord::Base.connection
+      end
+
+      def source_paths
+        @source_paths || []
+      end
+
+      def enabled?
+        return @enabled unless @enabled.nil?
+        ENV["FOUNDRIES_CACHE"] == "1"
+      end
+
+      def adapter
+        @adapter ||= Adapter.for(connection)
+      end
+
+      def reset!
+        @adapter = nil
+        @source_paths = nil
+      end
+    end
+  end
+end

data/lib/foundries/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Foundries
+  VERSION = "0.1.0"
+  RELEASE_DATE = "2026-02-25"
+end

data/lib/foundries.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "factory_bot"
+require_relative "foundries/version"
+require_relative "foundries/blueprint"
+require_relative "foundries/similarity"
+require_relative "foundries/base"
+
+module Foundries
+end
+
+require_relative "foundries/snapshot" if defined?(ActiveRecord)

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: foundries
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- John Dowd
+- Jim Gay
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: factory_bot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Compose factory_bot factories into foundries that build complex trees
+  of related records with a declarative DSL.
+email:
+- john.dowd@sofwarellc.com
+- jim.gay@sofwarellc.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- lib/foundries.rb
+- lib/foundries/base.rb
+- lib/foundries/blueprint.rb
+- lib/foundries/similarity.rb
+- lib/foundries/similarity/comparator.rb
+- lib/foundries/similarity/recorder.rb
+- lib/foundries/similarity/structure_tree.rb
+- lib/foundries/snapshot.rb
+- lib/foundries/snapshot/adapter.rb
+- lib/foundries/snapshot/adapters/postgres_adapter.rb
+- lib/foundries/snapshot/adapters/sqlite_adapter.rb
+- lib/foundries/snapshot/fingerprint.rb
+- lib/foundries/snapshot/store.rb
+- lib/foundries/version.rb
+homepage: https://github.com/SOFware/foundries
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/SOFware/foundries
+  source_code_uri: https://github.com/SOFware/foundries
+  changelog_uri: https://github.com/SOFware/foundries/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Declarative trees of related data using factory_bot
+test_files: []