tdc 1.2 → 1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50ad351391fe24e0f4edac9aab8c3c168bd1663fc573453106f0dd705be52f6f
-  data.tar.gz: 4818a7bae4a7a81bd03e76c24af0f6fb70ab43cd38a9a4e3ccb6aa12d9b338a3
+  metadata.gz: 96f4dcb68a0b66da5d24ceb550ea17484044c4489dbc898f72b76529287b9d8a
+  data.tar.gz: b56e406533429d735cce8c26c338b111c66965d8341cd744d672d9ff8bc642d1
 SHA512:
-  metadata.gz: 5ed0d723f97ce97cb41c1f0158753212352167d1f0dae4c1a231fb588d68035dc3bb1a4d4f3d7a3d9c24f87bb60be6dedb22180672cca64c4be21d98396c1d9c
-  data.tar.gz: bf8dbccc23d5f42fb6ba6818e938b62309aad5a9c3683d55f7aeb831d32fb3ca2d928100336b737aba373e506b572d038da65906805c41394fa0ed980f07c4f2
+  metadata.gz: cb7c52792c80baac6651a2fa434cebd9a1331cd00a41350f34409d7d083dbf21aaf40717006ed72012be7b2cd07055eca0b0bf5784d0431efb52bc7b4b5cdd70
+  data.tar.gz: 6e761091a8cb869f160d28e652563fa88c8b5de959fef37f4f2a60aaadbfc9e4beae1323aa851c714422de05f73888c6730ec86079a50ee1e44bc8e9d883b3a1

data/.rubocop.yml

@@ -1,11 +1,12 @@
-require:
+plugins:
   - rubocop-performance
   - rubocop-rake
   - rubocop-rspec
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.1
+  SuggestExtensions: false
+  TargetRubyVersion: 3.3
 
   Exclude:
     - 'bin/**/*'
@@ -80,9 +81,13 @@ Style/DocumentDynamicEvalDefinition:
 Style/EmptyMethod:
   EnforcedStyle: expanded
 
-# We can ignore this small performance improvement.
 Style/FrozenStringLiteralComment:
-  Enabled: false
+  Enabled: true
+  Exclude:
+    - 'Appraisals'
+    - 'Gemfile'
+    - 'Rakefile'
+    - 'gemfiles/*.gemfile'
 
 # We like to use the hash rocket in rake files.
 Style/HashSyntax:

data/.ruby-version

@@ -1 +1 @@
-3.3.6
+3.4.7

data/CHANGELOG.md

@@ -6,6 +6,24 @@ 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
+
+#### Breaking Changes
+
+- Drop support for Ruby 3.2
+
 ## [1.2] - 2025-10-07
 
 - Support Rails 8.0.x

data/Gemfile

@@ -2,3 +2,15 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in tdc.gemspec
 gemspec
+
+group :development, :test do
+  gem "appraisal", "~> 2.5"
+  gem "rake", "~> 13.2"
+  gem "rspec", "~> 3.13"
+  gem "rubocop", "~> 1.69"
+  gem "rubocop-performance", "~> 1.23"
+  gem "rubocop-rake", "~> 0.6"
+  gem "rubocop-rspec", "~> 3.3"
+  gem "rubycritic", "~> 4.9"
+  gem "simplecov", "~> 0.22"
+end

data/gemfiles/rails_7_2.gemfile

@@ -4,4 +4,16 @@ source "https://rubygems.org"
 
 gem "rails", "7.2.2.1"
 
+group :development, :test do
+  gem "appraisal", "~> 2.5"
+  gem "rake", "~> 13.2"
+  gem "rspec", "~> 3.13"
+  gem "rubocop", "~> 1.69"
+  gem "rubocop-performance", "~> 1.23"
+  gem "rubocop-rake", "~> 0.6"
+  gem "rubocop-rspec", "~> 3.3"
+  gem "rubycritic", "~> 4.9"
+  gem "simplecov", "~> 0.22"
+end
+
 gemspec path: "../"

data/gemfiles/rails_8_0.gemfile

@@ -4,4 +4,16 @@ source "https://rubygems.org"
 
 gem "rails", "8.0.3"
 
+group :development, :test do
+  gem "appraisal", "~> 2.5"
+  gem "rake", "~> 13.2"
+  gem "rspec", "~> 3.13"
+  gem "rubocop", "~> 1.69"
+  gem "rubocop-performance", "~> 1.23"
+  gem "rubocop-rake", "~> 0.6"
+  gem "rubocop-rspec", "~> 3.3"
+  gem "rubycritic", "~> 4.9"
+  gem "simplecov", "~> 0.22"
+end
+
 gemspec path: "../"

data/lib/tdc/data_definition.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Knows how to read data definitions from the specified path elements.

data/lib/tdc/data_definition_file_reader.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Knows how to read data definitions from YAML files.

data/lib/tdc/definition_resolvers/definition_resolver.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module Tdc
   module DefinitionResolvers
     #
     # 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
@@ -12,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/definition_resolvers/tag_resolver.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module DefinitionResolvers
     #

data/lib/tdc/definition_resolvers.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Namespace to host definition resolvers.

data/lib/tdc/extended_attributes/default_interpreter.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module ExtendedAttributes
     #
@@ -6,6 +8,8 @@ module Tdc
     # Note: extended attribute keys are expected to be strings rather than symbols.
     #
     class DefaultInterpreter < Tdc::ExtendedAttributes::InterpreterBase
+      EXTENDED_ATTRIBUTE_SUFFIX = "_xa"
+
       def interpret(instance_definition)
         extended_attribute_definitions = keep_extended_attributes(instance_definition)
 
@@ -27,8 +31,6 @@ module Tdc
 
       private
 
-      EXTENDED_ATTRIBUTE_SUFFIX = "_xa"
-
       def convert_to_standard_attribute(extended_attribute_key)
         extended_attribute_key.delete_suffix(EXTENDED_ATTRIBUTE_SUFFIX)
       end

data/lib/tdc/extended_attributes/interpreter_base.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module ExtendedAttributes
     class InterpreterBase

data/lib/tdc/extended_attributes/interpreter_registry.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module ExtendedAttributes
     #

data/lib/tdc/extended_attributes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Namespace to host extended attributes.

data/lib/tdc/fatal_error.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   class FatalError < RuntimeError
   end

data/lib/tdc/generators/catalog_entries.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #

data/lib/tdc/generators/definition_resolvable.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #
@@ -40,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/definition_sourcable.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #

data/lib/tdc/generators/generation_context.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #
@@ -9,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/generator_base.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #

data/lib/tdc/generators/standard_generator.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module Generators
     #
@@ -18,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
@@ -33,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.
       #
@@ -40,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.
       #
@@ -49,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/generators.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Namespace to host generators.

data/lib/tdc/in_memory_data_definition.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Knows how to read data definitions from an in-memory representation.

data/lib/tdc/missing_override_error.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   MissingOverrideError = Class.new(Tdc::FatalError)
 end

data/lib/tdc/version.rb

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

data/lib/tdc/with_indifferent_access_decorator.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Knows how to transform the result of calling the TestDefinitionReader#read method from an Array

data/lib/tdc/yaml_readers/null_yaml_reader.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module YamlReaders
     #

data/lib/tdc/yaml_readers/yaml_reader.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module YamlReaders
     #

data/lib/tdc/yaml_readers/yaml_reader_base.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module YamlReaders
     #
@@ -40,9 +42,9 @@ module Tdc
 
       def definitions_file
         @_definitions_file ||= begin
-          fully_qualified_path_elements = [@catalog_root_directory].concat(@path_elements.map(&:to_s))
+          fully_qualified_path_elements = [@catalog_root_directory] + @path_elements.map(&:to_s)
 
-          fully_qualified_path_elements.last.concat(file_extension)
+          fully_qualified_path_elements[-1] = "#{fully_qualified_path_elements.last}#{file_extension}"
 
           File.join(*fully_qualified_path_elements)
         end

data/lib/tdc/yaml_readers/yaml_reader_factory.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module YamlReaders
     #

data/lib/tdc/yaml_readers/yaml_reader_with_expansion.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   module YamlReaders
     #

data/lib/tdc/yaml_readers.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tdc
   #
   # Namespace to host YAML readers.

data/lib/tdc.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "ostruct"
 require "yaml"
 

data/tdc.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative "lib/tdc/version"
 
 Gem::Specification.new do |spec|
@@ -10,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.homepage = "https://github.com/nulogy/tdc"
   spec.license = "MIT"
 
-  spec.required_ruby_version = Gem::Requirement.new(">= 3.2")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.3")
 
   spec.metadata = {
     "homepage_uri" => "https://github.com/nulogy/tdc",
@@ -29,15 +31,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activesupport", ">= 7.2", "< 8.1"
+  spec.add_dependency "ostruct", ">= 0.6"
   spec.add_dependency "zeitwerk", ">= 2.7"
-
-  spec.add_development_dependency "appraisal", "~> 2.5"
-  spec.add_development_dependency "rake", "~> 13.2"
-  spec.add_development_dependency "rspec", "~> 3.13"
-  spec.add_development_dependency "rubocop", "~> 1.69"
-  spec.add_development_dependency "rubocop-performance", "~> 1.23"
-  spec.add_development_dependency "rubocop-rake", "~> 0.6"
-  spec.add_development_dependency "rubocop-rspec", "~> 3.3"
-  spec.add_development_dependency "rubycritic", "~> 4.9"
-  spec.add_development_dependency "simplecov", "~> 0.22"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tdc
 version: !ruby/object:Gem::Version
-  version: '1.2'
+  version: '1.4'
 platform: ruby
 authors:
 - Alistair McKinnell
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -31,146 +30,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '8.1'
 - !ruby/object:Gem::Dependency
-  name: zeitwerk
+  name: ostruct
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: appraisal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.5'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.2'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.13'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.13'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.69'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.69'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.23'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.23'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
 - !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.3'
-- !ruby/object:Gem::Dependency
-  name: rubycritic
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.9'
-- !ruby/object:Gem::Dependency
-  name: simplecov
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
+        version: '2.7'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.22'
-description:
+        version: '2.7'
 email:
 - alistairm@nulogy.com
 executables: []
@@ -230,7 +116,6 @@ metadata:
   changelog_uri: https://github.com/nulogy/tdc/blob/master/CHANGELOG.md
   bug_tracker_uri: https://github.com/nulogy/tdc/issues
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -238,15 +123,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.8
 specification_version: 4
 summary: A simple framework for creating a Test Data Catalog
 test_files: []