eac_tools 0.60.2 → 0.60.3

data/sub/eac_templates/lib/eac_templates/sources/from_gem.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'eac_templates/sources/set'
+
+module EacTemplates
+  module Sources
+    class FromGem
+      class << self
+        def include_all(searcher = nil)
+          ::Gem::Specification.each { |gemspec| new(gemspec, searcher).include }
+        end
+      end
+
+      TEMPLATES_DIR_SUBPATH = 'template'
+
+      common_constructor :gemspec, :searcher, default: [nil] do
+        self.searcher ||= ::EacTemplates::Sources::Set.default
+      end
+
+      # @return [Boolean]
+      delegate :exist?, to: :path
+
+      # @return [Pathname]
+      def include
+        return nil unless exist?
+
+        searcher.included_paths << path
+        path
+      end
+
+      # @return [Pathname]
+      def path
+        gemspec.gem_dir.to_pathname.join(TEMPLATES_DIR_SUBPATH)
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/sources/fs_object.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Sources
+    class FsObject
+      enable_abstract_methods
+      enable_simple_cache
+      common_constructor :source_set, :subpath do
+        self.subpath = subpath.to_pathname
+      end
+
+      # @return [Boolean]
+      def found?
+        real_paths.any?
+      end
+
+      protected
+
+      # @return [Class]
+      def applier_class
+        raise_abstract_method __method__
+      end
+
+      # @return [EacTemplates::Variables::SourceFile]
+      def applier_uncached
+        raise "No #{self.class.name.downcase} found for \"#{subpath}\"" unless found?
+
+        applier_class.new(real_paths.first)
+      end
+
+      # @return [Array<Pathname>]
+      def real_paths_uncached
+        source_set.included_paths.lazy.map { |source_single| source_single_search(source_single) }
+          .select(&:present?)
+      end
+
+      # @param path [Pathname]
+      # @return [Boolean]
+      def select_path?(path)
+        path.present?
+      end
+
+      # @param source_single [EacTemplates::Sources::Single]
+      # @return [Pathname, nil]
+      def source_single_search(source_single)
+        r = source_single.search(subpath)
+        select_path?(r) ? r : nil
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/sources/internal_set.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/sources/single'
+
+module EacTemplates
+  module Sources
+    class InternalSet < ::Set
+      # @param single [EacTemplates::Sources::Single]
+      # @return [self]
+      def add(single)
+        super(::EacTemplates::Sources::Single.assert(single))
+      end
+
+      # @param single [EacTemplates::Sources::Single]
+      # @return [self]
+      def <<(single)
+        add(single)
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/sources/set.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/object/blank'
+require 'eac_templates/sources/directory'
+require 'eac_templates/sources/file'
+require 'eac_templates/sources/internal_set'
+
+module EacTemplates
+  module Sources
+    class Set
+      class << self
+        def default
+          @default ||= new
+        end
+      end
+
+      # @param subpath [Pathname]
+      # @return [EacTemplates::Sources::Directory]
+      def directory(subpath)
+        ::EacTemplates::Sources::Directory.new(self, subpath)
+      end
+
+      # @param subpath [Pathname]
+      # @return [EacTemplates::Sources::Directory]
+      def file(subpath)
+        ::EacTemplates::Sources::File.new(self, subpath)
+      end
+
+      def template(subpath, required = true)
+        found_file = file(subpath)
+        return found_file if found_file.found?
+
+        found_directory = directory(subpath)
+        return found_directory if found_directory.found?
+
+        return nil unless required
+
+        raise_template_not_found(subpath)
+      end
+
+      # @return [EacTemplates::Sources::InternalSet]
+      def included_paths
+        @included_paths ||= ::EacTemplates::Sources::InternalSet.new
+      end
+
+      private
+
+      def raise_template_not_found(subpath)
+        raise "Template not found for subpath \"#{subpath}\"" \
+          " (Included paths: #{included_paths.to_a.join(::File::PATH_SEPARATOR)})"
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/sources/single.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Sources
+    class Single
+      class << self
+        # @param object [EacTemplates::Sources::Single, Pathname]
+        # @return [EacTemplates::Sources::Single]
+        def assert(object)
+          return object if object.is_a?(self)
+
+          new(object.to_pathname)
+        end
+      end
+
+      common_constructor :path do
+        self.path = path.to_pathname.expand_path
+      end
+
+      # @return [Pathname, nil]
+      def search(subpath)
+        r = path.join(subpath)
+        r.exist? ? r : nil
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/sources.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Sources
+    require_sub __FILE__
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/directory.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/file'
+require 'eac_templates/variables/fs_object'
+
+module EacTemplates
+  module Variables
+    class Directory
+      attr_reader :path
+
+      def initialize(path)
+        @path = path.is_a?(::Pathname) ? path : ::Pathname.new(path.to_s)
+      end
+
+      def apply(variables_source, directory)
+        ::EacTemplates::Variables::FsObject.new(self, '.', directory, variables_source).apply
+      end
+
+      def child(subpath)
+        child_path = ::File.join(path, subpath)
+        return ::EacTemplates::Variables::File.new(child_path) if ::File.file?(child_path)
+        return ::EacTemplates::Variables::Directory.new(child_path) if ::File.directory?(child_path)
+
+        raise "Child \"#{subpath}\" from \"#{path}\" not found"
+      end
+
+      def children
+        path.children.map do |path_child|
+          child(path_child.basename.to_path)
+        end
+      end
+
+      private
+
+      def apply_fs_object(source_relative, target)
+        if ::File.directory?(source_absolute(source_relative))
+          apply_directory(source_relative, target)
+        elsif ::File.file?(source_absolute(source_relative))
+        end
+      end
+
+      def source_absolute(source_relative)
+        ::File.expand_path(source_relative, path)
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/file.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/variables/providers'
+
+module EacTemplates
+  module Variables
+    class File
+      VARIABLE_DELIMITER = ::Regexp.quote('%%')
+      VARIABLE_PATTERN = /#{VARIABLE_DELIMITER}([a-z0-9\._]*)#{VARIABLE_DELIMITER}/i.freeze
+
+      enable_simple_cache
+      common_constructor :path do
+        self.path = path.to_pathname
+      end
+
+      # +variables_provider+ A [Hash] or object which responds to +read_entry(entry_name)+.
+      def apply(variables_source)
+        variables_provider = ::EacTemplates::Variables::Providers.build(variables_source)
+        variables.inject(content) do |a, e|
+          a.gsub(variable_pattern(e), variables_provider.variable_value(e).to_s)
+        end
+      end
+
+      def apply_to_file(variables_source, output_file_path)
+        output_file_path.to_pathname.write(apply(variables_source))
+      end
+
+      private
+
+      def variables_uncached
+        content.scan(VARIABLE_PATTERN).map(&:first).map do |name|
+          sanitize_variable_name(name)
+        end.to_set
+      end
+
+      def content_uncached
+        path.read
+      end
+
+      def sanitize_variable_name(variable_name)
+        variable_name.to_s.downcase
+      end
+
+      def variable_pattern(name)
+        /#{VARIABLE_DELIMITER}#{::Regexp.quote(name)}#{VARIABLE_DELIMITER}/i
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/fs_object.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/file'
+
+module EacTemplates
+  module Variables
+    class FsObject
+      TEMPLATE_EXTNAME = '.template'
+
+      common_constructor :source_directory, :source_relative, :target_root_directory,
+                         :variables_source
+
+      def apply
+        if file?
+          apply_file
+        elsif directory?
+          apply_directory
+        else
+          raise "Unknown filesystem type: #{source_absolute}"
+        end
+      end
+
+      private
+
+      def apply_directory
+        ::FileUtils.mkdir_p(target_absolute)
+        Dir.entries(source_absolute).each do |entry|
+          child(entry).apply unless %w[. ..].include?(entry)
+        end
+      end
+
+      def apply_file
+        if ::File.extname(source_absolute) == TEMPLATE_EXTNAME
+          ::EacTemplates::Variables::File.new(source_absolute).apply_to_file(
+            variables_source, target_absolute
+          )
+        else
+          ::FileUtils.cp(source_absolute, target_absolute)
+        end
+      end
+
+      def child(entry)
+        self.class.new(source_directory, ::File.join(source_relative, entry),
+                       target_root_directory, variables_source)
+      end
+
+      def file?
+        ::File.file?(source_absolute)
+      end
+
+      def directory?
+        ::File.directory?(source_absolute)
+      end
+
+      def source_absolute
+        ::File.expand_path(source_relative, source_directory.path)
+      end
+
+      def target_absolute
+        ::File.expand_path(source_relative, target_root_directory)
+          .gsub(/#{::Regexp.quote(TEMPLATE_EXTNAME)}\z/, '')
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/not_found_error.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module EacTemplates
+  module Variables
+    class NotFoundError < StandardError; end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers/base.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/not_found_error'
+
+module EacTemplates
+  module Variables
+    module Providers
+      class Base
+        attr_reader :source
+
+        def initialize(source)
+          @source = source
+        end
+
+        def variable_value(name)
+          return variable_fetch(name) if variable_exist?(name)
+
+          raise VariableNotFoundError, "Variable \"#{name}\" not found in #{source}"
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers/config_reader.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'eac_config/node'
+require 'eac_templates/variables/providers/base'
+
+module EacTemplates
+  module Variables
+    module Providers
+      class ConfigReader < ::EacTemplates::Variables::Providers::Base
+        class << self
+          def accept?(variables_source)
+            return false unless variables_source.respond_to?(:entry)
+
+            entry = variables_source.entry(:any_value)
+            entry.respond_to?(:value) && entry.respond_to?(:found?)
+          end
+        end
+
+        def variable_exist?(name)
+          source.entry(name).found?
+        end
+
+        def variable_fetch(name)
+          source.entry(name).value
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers/entries_reader.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/providers/base'
+
+module EacTemplates
+  module Variables
+    module Providers
+      class EntriesReader < ::EacTemplates::Variables::Providers::Base
+        class << self
+          def accept?(variables_source)
+            variables_source.respond_to?(:read_entry)
+          end
+        end
+
+        def variable_exist?(_name)
+          true
+        end
+
+        def variable_fetch(name)
+          source.read_entry(name)
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers/generic.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/providers/base'
+
+module EacTemplates
+  module Variables
+    module Providers
+      class Generic < ::EacTemplates::Variables::Providers::Base
+        class << self
+          def accept?(variables_source)
+            variables_source.is_a?(::Object)
+          end
+        end
+
+        def variable_exist?(name)
+          source.respond_to?(name)
+        end
+
+        def variable_fetch(name)
+          source.send(name)
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers/hash.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'eac_templates/variables/providers/base'
+
+module EacTemplates
+  module Variables
+    module Providers
+      class Hash < ::EacTemplates::Variables::Providers::Base
+        class << self
+          def accept?(variables_source)
+            variables_source.is_a?(::Hash)
+          end
+        end
+
+        def initialize(source)
+          super(source.with_indifferent_access)
+        end
+
+        def variable_exist?(name)
+          source.key?(name)
+        end
+
+        def variable_fetch(name)
+          source.fetch(name)
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables/providers.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Variables
+    module Providers
+      require_sub __FILE__
+
+      PROVIDERS = %w[config_reader entries_reader hash generic].map do |name|
+        "eac_templates/variables/providers/#{name}".camelize.constantize
+      end
+
+      class << self
+        def build(variables_source)
+          PROVIDERS.each do |provider|
+            return provider.new(variables_source) if provider.accept?(variables_source)
+          end
+
+          raise "Variables provider not found for #{variables_source}"
+        end
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/variables.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Variables
+    require_sub __FILE__
+  end
+end

data/sub/eac_templates/lib/eac_templates/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EacTemplates
+  VERSION = '0.4.0'
+end

data/sub/eac_templates/lib/eac_templates.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  require_sub __FILE__
+end

data/sub/eac_templates/spec/lib/eac_templates/patches/module/template_spec.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require 'eac_templates/patches/module/template'
+require 'eac_templates/sources/set'
+
+RSpec.describe ::Module do
+  def self.on_node_specs(node_name, &block)
+    context "when object is \"#{node_name}\"" do # rubocop:disable RSpec/EmptyExampleGroup
+      let(:node) { send(node_name) }
+
+      instance_eval(&block)
+    end
+  end
+
+  def self.dir_specs(node_name, expected_children)
+    on_node_specs(node_name) do
+      it do
+        expect(node.children.map { |child| child.path.basename.to_path }).to(
+          eq(expected_children)
+        )
+      end
+    end
+  end
+
+  def self.file_specs_ok(node_name, expected_content, expected_apply, # rubocop:disable Metrics/AbcSize
+                         expected_variables)
+    on_node_specs(node_name) do
+      it { expect(node.content).to eq(expected_content) }
+      it { expect(node.variables).to eq(::Set.new(expected_variables)) }
+      it { expect(node.apply(variables_source)).to eq(expected_apply) }
+
+      it do
+        target_file = temp_file
+        node.apply_to_file(variables_source, target_file)
+        expect(target_file.read).to eq(expected_apply)
+      end
+    end
+  end
+
+  def self.file_specs_error(node_name)
+    on_node_specs(node_name) do
+      it do
+        expect { node }.to raise_error(::RuntimeError)
+      end
+    end
+  end
+
+  let(:a_module) do
+    described_class.new do
+      def self.name
+        'AModule'
+      end
+    end
+  end
+  let(:super_class) do
+    r = ::Class.new do
+      def self.name
+        'SuperClass'
+      end
+    end
+    r.include a_module
+    r
+  end
+  let(:sub_class) do
+    r = ::Class.new(super_class) do
+      def self.name
+        'SuperClass'
+      end
+    end
+    r
+  end
+  let(:files_dir) { __dir__.to_pathname.join('template_spec_files') }
+  let(:variables_source) { { vx: '_X_', vy: '_Y_' } }
+
+  let(:a) { instance.template.child('a') }
+  let(:a_a) { a.child('a_a') }
+  let(:a_b) { a.child('a_b') }
+  let(:a_c) { a.child('a_c') }
+  let(:b) { instance.template.child('b') }
+  let(:c) { instance.template.child('c') }
+
+  before do
+    %w[path1 path2].each do |sub|
+      ::EacTemplates::Sources::Set.default.included_paths << files_dir.join(sub)
+    end
+  end
+
+  context 'when module is AModule' do # rubocop:disable RSpec/EmptyExampleGroup
+    let(:instance) { a_module }
+
+    dir_specs(:a, %w[a_a])
+    file_specs_ok(:a_a, "A_MODULE_A_A\n", "A_MODULE_A_A\n", [])
+    file_specs_error(:a_b)
+    file_specs_error(:a_c)
+    file_specs_ok(:b, "A_MODULE_B%%vy%%\n", "A_MODULE_B_Y_\n", %w[vy])
+    file_specs_error(:c)
+  end
+
+  context 'when module is SuperClass' do # rubocop:disable RSpec/EmptyExampleGroup
+    let(:instance) { super_class }
+
+    dir_specs(:a, %w[a_b])
+    file_specs_error(:a_a)
+    file_specs_ok(:a_b, "SUPER_CLASS_A_B\n", "SUPER_CLASS_A_B\n", [])
+    file_specs_error(:a_c)
+    file_specs_ok(:b, "SUPER_CLASS_B\n", "SUPER_CLASS_B\n", [])
+    file_specs_error(:c)
+  end
+
+  context 'when module is SubClass' do # rubocop:disable RSpec/EmptyExampleGroup
+    let(:instance) { sub_class }
+
+    dir_specs(:a, %w[a_b])
+    file_specs_error(:a_a)
+    file_specs_ok(:a_b, "SUPER_CLASS_A_B\n", "SUPER_CLASS_A_B\n", [])
+    file_specs_error(:a_c)
+    file_specs_ok(:b, "SUPER_CLASS_B\n", "SUPER_CLASS_B\n", [])
+    file_specs_error(:c)
+  end
+end

data/sub/eac_templates/spec/lib/eac_templates/patches/module/template_spec_files/path1/a_module/a/a_a

@@ -0,0 +1 @@
+A_MODULE_A_A