tdc 1.3 → 1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea0b752fe9e2b0de8af863a24943c1f9b3761361c954daeb30a8af0d19ff3618
-  data.tar.gz: '08057115b222377b4ec89752f2e45d6044d12ab3907efd0c2d6544ea888ab186'
+  metadata.gz: 96f4dcb68a0b66da5d24ceb550ea17484044c4489dbc898f72b76529287b9d8a
+  data.tar.gz: b56e406533429d735cce8c26c338b111c66965d8341cd744d672d9ff8bc642d1
 SHA512:
-  metadata.gz: 9dda429b7527bc63a9152e34197f15e6846d7ea99c54acbc6a6fa629efeacddea67e8416ea493f94c709d1a556b49cc1a7d3b34bedb5cfdac9d03c59d448de6d
-  data.tar.gz: 471e6576c1d97bed8ada0a23b4de078c9f8aec8adbae16893e0c4ddeaf5018add54edfa1784a3b53dd01ebc5ecc370ed2624dde9e64e3be691e7c8d5c1912675
+  metadata.gz: cb7c52792c80baac6651a2fa434cebd9a1331cd00a41350f34409d7d083dbf21aaf40717006ed72012be7b2cd07055eca0b0bf5784d0431efb52bc7b4b5cdd70
+  data.tar.gz: 6e761091a8cb869f160d28e652563fa88c8b5de959fef37f4f2a60aaadbfc9e4beae1323aa851c714422de05f73888c6730ec86079a50ee1e44bc8e9d883b3a1

data/CHANGELOG.md

@@ -6,6 +6,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4] - 2026-04-04
+
+#### New Features
+
+- Update-or-create support in `StandardGenerator`: when an extension row's tag matches a previously created
+  record, the generator routes to `update_instance` instead of `generate_instance`
+- `GenerationContext` tracks updating state via `with_updating` / `updating?`
+- `DefinitionResolver` exposes `updating?` via generation context so subclass resolvers can skip missing keys
+  when updating
+
 ## [1.3] - 2025-10-25
 
 - Support Ruby 3.4

data/lib/tdc/definition_resolvers/definition_resolver.rb

@@ -6,7 +6,7 @@ module Tdc
     # Base class for any definition resolver.
     #
     class DefinitionResolver
-      attr_reader :current_catalog
+      attr_reader :current_catalog, :generation_context
 
       def configure_current_catalog(current_catalog)
         @current_catalog = current_catalog
@@ -14,6 +14,16 @@ module Tdc
         self
       end
 
+      def configure_generation_context(generation_context)
+        @generation_context = generation_context
+
+        self
+      end
+
+      def updating?
+        generation_context&.updating? == true
+      end
+
       def resolve(_instance_definition)
         raise Tdc::MissingOverrideError, "Implement the 'resolve' method"
       end

data/lib/tdc/generators/definition_resolvable.rb

@@ -42,6 +42,7 @@ module Tdc
       def run_definition_resolvers(instance_definition)
         _definition_resolvers.each do |definition_resolver|
           definition_resolver.configure_current_catalog(current_catalog)
+          definition_resolver.configure_generation_context(generation_context)
 
           definition_resolver.resolve(instance_definition)
         end

data/lib/tdc/generators/generation_context.rb

@@ -11,6 +11,18 @@ module Tdc
       def initialize(current_catalog:, data_definition:)
         @current_catalog = current_catalog
         @data_definition = data_definition
+        @updating = false
+      end
+
+      def updating?
+        @updating
+      end
+
+      def with_updating
+        @updating = true
+        yield
+      ensure
+        @updating = false
       end
     end
   end

data/lib/tdc/generators/standard_generator.rb

@@ -20,7 +20,13 @@ module Tdc
             # Delete the tag so that the models do not need to filter it out.
             tag = instance_definition.delete("tag")
 
-            generated = run_resolvers_and_generate_instance
+            existing_record = find_existing_record(tag, catalog_entries)
+
+            if existing_record
+              generated = run_resolvers_and_update_instance(existing_record)
+            else
+              generated = run_resolvers_and_generate_instance
+            end
 
             # Add generated instance to the catalog entries whenever a tag provided.
             catalog_entries.add_catalog_entry(tag, generated) if tag
@@ -35,6 +41,15 @@ module Tdc
         generate_instance
       end
 
+      def run_resolvers_and_update_instance(existing_record)
+        generation_context.with_updating do
+          run_extended_attribute_interpreters(instance_definition)
+          run_definition_resolvers(instance_definition)
+
+          update_instance(existing_record)
+        end
+      end
+
       #
       # Hook method: subclasses are expected to define how to generate a model instance.
       #
@@ -42,6 +57,14 @@ module Tdc
         raise Tdc::MissingOverrideError, "Implement the 'generate_instance' method"
       end
 
+      #
+      # Hook method: subclasses may override to customize update behavior for existing records.
+      #
+      def update_instance(existing_record)
+        existing_record.update!(instance_definition)
+        existing_record
+      end
+
       #
       # Hook method: subclasses may include the DefinitionResolvable concern to override.
       #
@@ -51,6 +74,12 @@ module Tdc
 
       private
 
+      def find_existing_record(tag, catalog_entries)
+        return unless tag
+
+        catalog_entries.respond_to?(tag) ? catalog_entries.send(tag) : nil
+      end
+
       def configure_instance_definition(instance_definition)
         @instance_definition = instance_definition
 

data/lib/tdc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tdc
-  VERSION = "1.3"
+  VERSION = "1.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tdc
 version: !ruby/object:Gem::Version
-  version: '1.3'
+  version: '1.4'
 platform: ruby
 authors:
 - Alistair McKinnell
@@ -130,7 +130,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.8
 specification_version: 4
 summary: A simple framework for creating a Test Data Catalog
 test_files: []