tdc 0.4.3.1 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f01cdb5f72c9481d031888d6c1729d6ba6976c79184807dfeb4213fa3205ee99
-  data.tar.gz: 64ef598c74252a48925ad77c9f779df6c7a45957bb8b2cf641122981c9cfcc30
+  metadata.gz: 9afbee316bed8c63956e2a3f1626e376101940ecbb83e45fc6f7dd699d626df4
+  data.tar.gz: c4f164c51b6421490d157cbf4761ad4d9e634af72a6a52a6bce0443cfd4b32a9
 SHA512:
-  metadata.gz: d093ea28c783c4a5b62c951c815cfb915c7ae7cf13ec2e97cb6ddaceedb09b968b6bb6bf9d80723d8146edac1c7bb6c562d59dec957d074cd67f985a0ce4c79f
-  data.tar.gz: c99360136e1857226fef356850499c8aa4bfbe5762c808ab115e4ca40bf4a8f9b097d06dc7c277e0b50e77e9655a2056dc544ca733552238c6de3b203b391c37
+  metadata.gz: fd3f18ae6079f57dce2faa700c27ec64c86f266eb54820a2952beeeefcf3d4e8bcb0a785e69b02b222bcfa29f56ad5484c888dcea3d8d74e58610435ac4273e0
+  data.tar.gz: 219c4136fc7dc4717e9c83849d7318cbe05751b661dd9d95bbbaa2cc5a621188a44b13b7e2624c9c80c4126e34ced7274673dabe0af6e62488977cefa26e29ac

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,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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

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/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.3.1"
+  VERSION = "0.4.4"
 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.3.1
+  version: 0.4.4
 platform: ruby
 authors:
 - Alistair McKinnell
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-25 00:00:00.000000000 Z
+date: 2020-09-03 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: