tdc 0.4.1 → 0.4.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f00288e8e5b9fd0db193bd5cb1f861dc54decc8966acc22a7b3c0ca37107970c
-  data.tar.gz: 8e57f9daa09264951dc05b6f0addab100a885dd9ca4de1a49466bf34e97b74a4
+  metadata.gz: eca13ff55c92fc5eb5b78f57e7d4e21fab8cffbc6a06eb3f1e824339b678736b
+  data.tar.gz: '057623005580c59c306cf9efd677cfc36547cba6f2bc633ac456d7d219a0fa90'
 SHA512:
-  metadata.gz: 998df3b2cec606f557721fef093730ec59c038b492bc66087dea92793c0d5767dae2d2fa6b06edce00aa105e586597f92e71f5dd7624a7fd03ad6819c07a0435
-  data.tar.gz: f183c0656d49e69ad0c7834da267d2491ca2a58339a1cd820dd639459f7bfba7cf07a15df9cbe98d9749b1add54a5b03daa4a6815a70650286f52ed954595604
+  metadata.gz: 2f130af08383189a6b21cb2d35a71705efecc6e64fe17e44f13265bc8b4b0967b7a85e8baea4ca1a84effb60b6998de5e57c53c6eff8f1ad979917f37f161093
+  data.tar.gz: 1b3cf70a0abe5fa1b6f6cfcf1c3d3455a227ceeca98ed39714ad65b8ecf786a04af9c83ce5452840b469038661acbc076f6657251c3660519a6dbd2bf2efa98c

data/.rubocop.yml

@@ -15,6 +15,10 @@ Layout/LineLength:
 Layout/MultilineMethodCallBraceLayout:
   Enabled: false
 
+# Revisit. Seems a little harsh.
+Lint/MissingSuper:
+  Enabled: false
+
 Metrics/BlockLength:
   Enabled: false
 

data/CHANGELOG.md

@@ -6,6 +6,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.4.1] - 2020-09-12
+
+- Avoid registering the same class of interpreter a second time
+
+## [0.4.4] - 2020-08-25
+
+#### Breaking Changes
+
+- Enable ERB expansion of the YAML source with a `.yam.erb` filename suffix. 
+
+## [0.4.3] - 2020-08-25
+
+#### New Features
+
+- Support optional definitions 
+
+## [0.4.2] - 2020-08-22
+
+#### Breaking Changes
+
+- Extended attributes use `_xa` suffix
+
 ## [0.4.1] - 2020-08-22
 
 - Add the `first` method to `CatalogEntries`

data/lib/tdc.rb

@@ -41,6 +41,14 @@ require "tdc/generators/definition_sourcable"
 require "tdc/generators/generator_base"
 require "tdc/generators/standard_generator"
 
+# YAML Readers
+require "tdc/yaml_readers"
+require "tdc/yaml_readers/null_yaml_reader"
+require "tdc/yaml_readers/yaml_reader_base"
+require "tdc/yaml_readers/yaml_reader"
+require "tdc/yaml_readers/yaml_reader_with_expansion"
+require "tdc/yaml_readers/yaml_reader_factory"
+
 #
 # A framework for building a Test Data Catalog
 #

data/lib/tdc/data_definition_file_reader.rb

@@ -6,44 +6,13 @@ module Tdc
     EMPTY_DEFINITIONS = []
 
     def initialize(catalog_root_directory)
-      super()
-
       @catalog_root_directory = catalog_root_directory
     end
 
     def read(*path_elements)
-      data_definition_from(definitions_file(path_elements))
-    end
-
-    private
-
-    def definitions_file(path_elements)
-      fully_qualified_path_elements = [@catalog_root_directory].concat(path_elements.map(&:to_s))
-
-      fully_qualified_path_elements.last.concat(".yml")
-
-      File.join(*fully_qualified_path_elements)
-    end
-
-    def data_definition_from(definitions_file)
-      if File.exist?(definitions_file)
-        load_yaml(definitions_file) || EMPTY_DEFINITIONS
-      else
-        EMPTY_DEFINITIONS
-      end
-    end
-
-    def load_yaml(definitions_file)
-      YAML.load(expand_erb(definitions_file)) # rubocop:disable Security/YAMLLoad
-    rescue => e
-      raise Tdc::FatalError, <<~MSG
-        Unable to load YAML from #{definitions_file}
-        Cause: #{e.message}"
-      MSG
-    end
+      reader = Tdc::YamlReaders::YamlReaderFactory.new(@catalog_root_directory, path_elements).create
 
-    def expand_erb(definitions_file)
-      ERB.new(File.read(definitions_file)).result
+      reader.data_definitions
     end
   end
 end

data/lib/tdc/definition_resolvers/tag_resolver.rb

@@ -8,8 +8,6 @@ module Tdc
       attr_reader :key, :source
 
       def initialize(key:, source:)
-        super()
-
         @key = key
         @source = source
       end

data/lib/tdc/extended_attributes/default_interpreter.rb

@@ -7,7 +7,7 @@ module Tdc
     #
     class DefaultInterpreter < Tdc::ExtendedAttributes::InterpreterBase
       def interpret(instance_definition)
-        extended_attribute_definitions = keep_extended_attributes_from(instance_definition)
+        extended_attribute_definitions = keep_extended_attributes(instance_definition)
 
         extended_attribute_definitions.each do |extended_attribute_key, extended_attribute_value|
           # Remove the extended attribute.
@@ -20,23 +20,27 @@ module Tdc
       end
 
       concerning :HookMethods do
-        def convert_to_standard_attribute(extended_attribute_key)
-          extended_attribute_key.gsub(/_(at|date|on)x$/, "_\\1")
-        end
-
         def extended_attribute_context
           Time.zone
         end
-
-        def extended_attribute?(extended_attribute_key)
-          /_(at|date|on)x$/ =~ extended_attribute_key
-        end
       end
 
       private
 
-      def keep_extended_attributes_from(instance_definition)
-        instance_definition.select { |extended_attribute_key, _| extended_attribute?(extended_attribute_key) }
+      EXTENDED_ATTRIBUTE_SUFFIX = "_xa"
+
+      def convert_to_standard_attribute(extended_attribute_key)
+        extended_attribute_key.delete_suffix(EXTENDED_ATTRIBUTE_SUFFIX)
+      end
+
+      def extended_attribute?(extended_attribute_key)
+        extended_attribute_key.end_with?(EXTENDED_ATTRIBUTE_SUFFIX)
+      end
+
+      def keep_extended_attributes(instance_definition)
+        instance_definition.select do |extended_attribute_key, _|
+          extended_attribute?(extended_attribute_key)
+        end
       end
     end
   end

data/lib/tdc/extended_attributes/interpreter_registry.rb

@@ -14,6 +14,10 @@ module Tdc
         @interpreters = []
       end
 
+      def clear
+        @interpreters = []
+      end
+
       def interpreters
         @interpreters.empty? ? [default_interpreter] : @interpreters
       end
@@ -23,6 +27,9 @@ module Tdc
           Cannot register an interpreter unless it inherits from Tdc::ExtendedAttributes::InterpreterBase
         MSG
 
+        # Avoid registering the same class of interpreter a second time.
+        return if @interpreters.map(&:class).include?(interpreter.class)
+
         @interpreters << interpreter
       end
 

data/lib/tdc/fatal_error.rb

@@ -1,7 +1,4 @@
 module Tdc
   class FatalError < RuntimeError
-    def initialize(msg = nil)
-      super
-    end
   end
 end

data/lib/tdc/generators/definition_sourcable.rb

@@ -3,7 +3,10 @@ module Tdc
     #
     # Creates ghost methods for use in generators.
     #
-    # All ghost methods are named 'key'_definition where 'key' is a key into the instance_definition hash.
+    # All ghost methods are named 'key'_definition or 'key'_definition_optional where 'key' is
+    # a key into the instance_definition hash.
+    #
+    # Choose optional if the key may not be present in the instance_definition.
     #
     # Example:
     #
@@ -11,6 +14,7 @@ module Tdc
     # ghost methods could be used to refer to the value associated with those keys:
     #
     #  line_definition
+    #  line_definition_optional
     #  replenishment_parameters_definition
     #
     module DefinitionSourcable
@@ -33,19 +37,25 @@ module Tdc
       private
 
       def method_missing(method, *args)
-        key = transform_method_to_definition_source_key(method)
-
-        definition_source&.key?(key) ? definition_source.fetch(key) : super
+        if ghost_definition?(method)
+          definition_source.fetch(method.to_s.gsub(/_definition$/, ""))
+        elsif ghost_optional_definition?(method)
+          definition_source[method.to_s.gsub(/_definition_optional$/, "")]
+        else
+          super
+        end
       end
 
       def respond_to_missing?(method, include_all = false) # rubocop:disable Style/OptionalBooleanParameter
-        key = transform_method_to_definition_source_key(method)
+        ghost_definition?(method) || ghost_optional_definition?(method) ? true : super
+      end
 
-        definition_source&.key?(key) ? true : super
+      def ghost_definition?(method)
+        method.to_s.end_with?("_definition")
       end
 
-      def transform_method_to_definition_source_key(method)
-        method.to_s.gsub(/_definition$/, "")
+      def ghost_optional_definition?(method)
+        method.to_s.end_with?("_definition_optional")
       end
     end
   end

data/lib/tdc/in_memory_data_definition.rb

@@ -4,8 +4,6 @@ module Tdc
   #
   class InMemoryDataDefinition < Tdc::DataDefinition
     def initialize(path_elements_data = {})
-      super()
-
       @store = path_elements_data
     end
 

data/lib/tdc/version.rb

@@ -1,3 +1,3 @@
 module Tdc
-  VERSION = "0.4.1"
+  VERSION = "0.4.4.1"
 end

data/lib/tdc/yaml_readers.rb

@@ -0,0 +1,7 @@
+module Tdc
+  #
+  # Namespace to host YAML readers.
+  #
+  module YamlReaders
+  end
+end

data/lib/tdc/yaml_readers/null_yaml_reader.rb

@@ -0,0 +1,12 @@
+module Tdc
+  module YamlReaders
+    #
+    # When we can't find a YAML source.
+    #
+    class NullYamlReader
+      def data_definitions
+        []
+      end
+    end
+  end
+end

data/lib/tdc/yaml_readers/yaml_reader.rb

@@ -0,0 +1,16 @@
+module Tdc
+  module YamlReaders
+    #
+    # YAML source is a YAML file.
+    #
+    class YamlReader < Tdc::YamlReaders::YamlReaderBase
+      def file_extension
+        ".yml"
+      end
+
+      def source_string
+        File.read(definitions_file)
+      end
+    end
+  end
+end

data/lib/tdc/yaml_readers/yaml_reader_base.rb

@@ -0,0 +1,52 @@
+module Tdc
+  module YamlReaders
+    #
+    # YAML source.
+    #
+    class YamlReaderBase
+      def initialize(catalog_root_directory, path_elements)
+        @catalog_root_directory = catalog_root_directory
+        @path_elements = path_elements
+      end
+
+      def applies?
+        File.exist?(definitions_file)
+      end
+
+      def data_definitions
+        definitions_source
+      end
+
+      def definitions_source
+        source_string.empty? ? [] : YAML.load(source_string) # rubocop:disable Security/YAMLLoad
+      rescue => e
+        raise Tdc::FatalError, <<~MSG
+          Unable to load YAML from #{definitions_file}
+          Cause: #{e.message}"
+        MSG
+      end
+
+      concerning :HookMethods do
+        def file_extension
+          raise MissingOverrideError, "Implement the 'file_extension' method"
+        end
+
+        def source_string
+          raise MissingOverrideError, "Implement the 'source_string' method"
+        end
+      end
+
+      private
+
+      def definitions_file
+        @_definitions_file ||= begin
+          fully_qualified_path_elements = [@catalog_root_directory].concat(@path_elements.map(&:to_s))
+
+          fully_qualified_path_elements.last.concat(file_extension)
+
+          File.join(*fully_qualified_path_elements)
+        end
+      end
+    end
+  end
+end

data/lib/tdc/yaml_readers/yaml_reader_factory.rb

@@ -0,0 +1,38 @@
+module Tdc
+  module YamlReaders
+    #
+    # Knows how to create the appropriate YAML reader.
+    #
+    class YamlReaderFactory
+      def initialize(catalog_root_directory, path_elements)
+        @catalog_root_directory = catalog_root_directory
+        @path_elements = path_elements
+      end
+
+      def create
+        if yaml_reader_with_expansion.applies?
+          yaml_reader_with_expansion
+        elsif yaml_reader.applies?
+          yaml_reader
+        else
+          null_reader
+        end
+      end
+
+      private
+
+      def yaml_reader_with_expansion
+        @_yaml_reader_with_expansion ||=
+          Tdc::YamlReaders::YamlReaderWithExpansion.new(@catalog_root_directory, @path_elements)
+      end
+
+      def null_reader
+        @_null_reader ||= Tdc::YamlReaders::NullYamlReader.new
+      end
+
+      def yaml_reader
+        @_yaml_reader ||= Tdc::YamlReaders::YamlReader.new(@catalog_root_directory, @path_elements)
+      end
+    end
+  end
+end

data/lib/tdc/yaml_readers/yaml_reader_with_expansion.rb

@@ -0,0 +1,16 @@
+module Tdc
+  module YamlReaders
+    #
+    # YAML source is a YAML file that undergoes ERB expansion.
+    #
+    class YamlReaderWithExpansion < Tdc::YamlReaders::YamlReaderBase
+      def file_extension
+        ".yml.erb"
+      end
+
+      def source_string
+        ERB.new(File.read(definitions_file)).result
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tdc
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.4.1
 platform: ruby
 authors:
 - Alistair McKinnell
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-22 00:00:00.000000000 Z
+date: 2020-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -147,6 +147,12 @@ files:
 - lib/tdc/missing_override_error.rb
 - lib/tdc/version.rb
 - lib/tdc/with_indifferent_access_decorator.rb
+- lib/tdc/yaml_readers.rb
+- lib/tdc/yaml_readers/null_yaml_reader.rb
+- lib/tdc/yaml_readers/yaml_reader.rb
+- lib/tdc/yaml_readers/yaml_reader_base.rb
+- lib/tdc/yaml_readers/yaml_reader_factory.rb
+- lib/tdc/yaml_readers/yaml_reader_with_expansion.rb
 - tdc.gemspec
 homepage: https://github.com/nulogy/tdc
 licenses: