foundries 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0ecd2813e2ccbe57b1889f98748c0590d208e83005b32fb0302004b8c31b708
-  data.tar.gz: 82dd0fe2b8f3fee39e3eb6821fb2fd3e2c222cebd599c4d6a0cd898b3af780f6
+  metadata.gz: d9bda37a762c9a055ca42c5faa685e30a6201fbeccaa5bbb7adffa0ccaef3386
+  data.tar.gz: 4fe49113055d53bb2e61df790fa037c849cff8d7b380011e6fd298fab0ec68af
 SHA512:
-  metadata.gz: 8585abf3336113d8ba508a67b9b83c207f7e3de3deeeb251f34cd1ba2449e9f62928e73b8e0f350205438f4284f0e07df59ac15456305fb8088d66febff6d738
-  data.tar.gz: 02db8e30a432fddd54df80e32aa801bea689660bd252746ab3b79bc3a04e6bccf9cc75eed9c0977641ff37be25bce1237325bed770c457ca78225ec073d692bb
+  metadata.gz: 6e2b1f8a7fbc9107f684883ae9435c8c6cfc004698f7a5316ec47fb3531b9d100be9b12b55a4c097cefbb48e871c653717dbdf4ed5733dcbaf1032f5fed6a8e0
+  data.tar.gz: f25ae1307f8f675d4b6d617b13b9102639e49f29bd6f80f90145cc68023725a36eb3169207107c9af6cb1078188f8a0d104c6e591959fc1ee48d992563b9e827

data/CHANGELOG.md

@@ -5,4 +5,34 @@ 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.0] - 2026-02-25
+## [0.1.2] - 2026-03-12
+
+### Added
+
+- aliases DSL on Base for shorthand method names (377632f)
+- lookup_order DSL on Blueprint for ancestor traversal (377632f)
+- find_or_create pattern on Blueprint (377632f)
+- Tests for inherited registries, parent-scoped find, collection_find_by kwargs, find_or_create, ascending_find, and parent_present? (2d92945)
+
+### Changed
+
+- Collections initialize before blueprints (377632f)
+- Fix find parent scoping and collection_find_by kwargs handling (3ebfc3e)
+
+## [0.1.1] - 2026-03-06
+
+### Added
+
+- Blueprint base class with collection tracking, parent scoping, and factory_bot integration (0002336)
+- Snapshot caching system with Postgres and SQLite adapters for test suite acceleration (0002336)
+- Source file content hashing in snapshot fingerprint for automatic cache invalidation (cfb348d)
+
+### Changed
+
+- Snapshot caching is opt-in via ARMATURE_CACHE=1 environment variable (0002336)
+- Similarity detection only warns on identical structure, not containment (a5bdf25)
+
+### Fixed
+
+- Parentless blueprints no longer raise NameError when find calls same_parent? (cfb348d)
+- Snapshot-cached presets no longer produce false similarity warnings (a5bdf25)

data/lib/foundries/base.rb

@@ -59,6 +59,18 @@ module Foundries
         blueprint_registry.keys.filter_map { |klass| klass.collection_name&.to_s }
       end
 
+      # Declare shorthand aliases for blueprint methods.
+      #
+      #   aliases member: :enrollment, hva_mod: :skilled_mod
+      #
+      # Resolves aliases during method_missing before blueprint
+      # delegation.
+      def aliases(mapping = nil)
+        return @aliases || {} unless mapping
+
+        @aliases = (@aliases || {}).merge(mapping)
+      end
+
       # Methods delegated from this foundry to its blueprint instances.
       def delegations
         blueprint_registry.select { |_, methods| methods.any? }
@@ -77,20 +89,22 @@ module Foundries
       #
       def preset(name, &block)
         define_singleton_method(name) do
-          with_similarity_recording(name, Similarity.enabled?) do
-            if defined?(Foundries::Snapshot) && Foundries::Snapshot.enabled?
-              store = Foundries::Snapshot::Store.new(name)
-
-              if store.cached?
-                store.restore
-                next new # hollow — no block, data already in DB
-              end
-
-              store.record_empty_tables
-              foundry = new(&block)
-              store.capture
-              foundry
-            else
+          if defined?(Foundries::Snapshot) && Foundries::Snapshot.enabled?
+            store = Foundries::Snapshot::Store.new(name)
+
+            if store.cached?
+              store.restore
+              next new # hollow — no block, data already in DB
+            end
+
+            store.record_empty_tables
+            foundry = with_similarity_recording(name, Similarity.enabled?) do
+              new(&block)
+            end
+            store.capture
+            foundry
+          else
+            with_similarity_recording(name, Similarity.enabled?) do
               new(&block)
             end
           end
@@ -119,16 +133,17 @@ module Foundries
 
       def inherited(subclass)
         super
-        # Ensure subclasses get their own registries
-        subclass.instance_variable_set(:@blueprint_registry, {})
-        subclass.instance_variable_set(:@extra_collections, [])
+        # Copy parent registries so subclasses inherit blueprints
+        subclass.instance_variable_set(:@blueprint_registry, blueprint_registry.dup)
+        subclass.instance_variable_set(:@extra_collections, extra_collections.dup)
+        subclass.instance_variable_set(:@aliases, aliases.dup)
       end
     end
 
     def initialize(&block)
       @_similarity_recorder = self.class._active_similarity_recorder
-      instantiate_blueprints
       initialize_collections
+      instantiate_blueprints
       @current = OpenStruct.new(resource: self)
       setup
       instance_exec(&block) if block
@@ -211,6 +226,13 @@ module Foundries
           end
         end
       end
+
+      # Set up alias methods that delegate to existing blueprint methods
+      self.class.aliases.each do |alias_name, target_name|
+        define_singleton_method(alias_name) do |*args, **kwargs, &block|
+          send(target_name, *args, **kwargs, &block)
+        end
+      end
     end
 
     def initialize_collections

data/lib/foundries/blueprint.rb

@@ -103,6 +103,19 @@ module Foundries
         end
       end
 
+      # Declare ancestor traversal order for ascending_find.
+      #
+      #   lookup_order %i[evented_mod phase cohort]
+      #
+      # When no parent is present, ascending_find walks these
+      # ancestor types on `current`, checking collection_name
+      # on each.
+      def lookup_order(ancestors = nil)
+        return @lookup_order || [] unless ancestors
+
+        @lookup_order = ancestors
+      end
+
       # Declare which attributes are allowed through to factory_bot.
       def permitted_attrs(attr_list)
         define_method(:permitted_attrs) do |attrs|
@@ -195,6 +208,47 @@ module Foundries
       end
     end
 
+    # Find or create: when no parent is present, walks ancestors
+    # via lookup_order; otherwise finds from parent or creates.
+    def find_or_create(name, attrs = {})
+      return ascending_find(name) unless parent_present?
+
+      find_from_parent(name) || create_object(name, attrs)
+    end
+
+    # Walk ancestor types declared in lookup_order, checking
+    # collection_name on each ancestor found in current state.
+    # Falls back to collection find.
+    def ascending_find(name)
+      object = nil
+      self.class.lookup_order.each do |ancestor_type|
+        ancestor = current.send(ancestor_type)
+        next unless ancestor
+
+        col = self.class.collection_name
+        object = ancestor.send(col).find_by(name:)
+        break if object
+      end
+
+      object || find(name)
+    end
+
+    # Whether a parent is available in the current context.
+    def parent_present?
+      parent_method = self.class.parent
+      return true if parent_method.in?(%i[self none])
+
+      parent
+    end
+
+    # Find from the parent's association, falling back to
+    # collection find.
+    def find_from_parent(name, col_name: "name")
+      col = self.class.collection_name
+      parent.send(col).find_by(col_name => name) ||
+        find(name, col_name:)
+    end
+
     # Find a record in the collection by name, falling back to the database.
     def find(name, col_name: "name")
       raise "#find called with nil :name, for col_name: #{col_name}." unless name
@@ -202,9 +256,13 @@ module Foundries
       found_record = collection.detect do |object|
         object.send(col_name).casecmp?(name) && same_parent?(object)
       end
+      return found_record if found_record
 
-      found_record ||
-        record_class.find_by(col_name => name)&.tap { |rec| collection << rec }
+      scope = record_class.where(col_name => name)
+      if parent_key && parent_id
+        scope = scope.where(parent_key => parent_id)
+      end
+      scope.first&.tap { |rec| collection << rec }
     end
 
     # Find a record in the collection by arbitrary criteria, falling back to the database.
@@ -254,7 +312,8 @@ module Foundries
     def method_missing(name, *args, **kwargs, &block)
       if (match = missing_find_by_request?(name))
         klass_name = match.named_captures["klass"]
-        return collection_find_by(klass_name, args)
+        attrs = kwargs.any? ? kwargs : args.first
+        return collection_find_by(klass_name, attrs)
       end
 
       if foundry.respond_to?(name)
@@ -274,8 +333,7 @@ module Foundries
       method_name.match(/^find_(?<klass>.*)_by$/)
     end
 
-    def collection_find_by(klass_name, args)
-      attrs = args.first
+    def collection_find_by(klass_name, attrs)
       target_collection_name = "#{klass_name.pluralize}_collection"
       objects = foundry.send(target_collection_name)
       objects.detect do |object|

data/lib/foundries/similarity/comparator.rb

@@ -17,18 +17,6 @@ module Foundries
                 ":#{preset_name(existing_key)} have identical structure " \
                 "(#{display_tree(new_tree)})"
             }
-          elsif existing_tree.contains?(new_tree)
-            warnings << {
-              pair: pair_key,
-              message: "[Foundries] Preset :#{preset_name(new_key)} is " \
-                "structurally contained within :#{preset_name(existing_key)}"
-            }
-          elsif new_tree.contains?(existing_tree)
-            warnings << {
-              pair: pair_key,
-              message: "[Foundries] Preset :#{preset_name(existing_key)} is " \
-                "structurally contained within :#{preset_name(new_key)}"
-            }
           end
         end
 

data/lib/foundries/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foundries
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - John Dowd
@@ -87,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Declarative trees of related data using factory_bot
 test_files: []