eac_tools 0.89.0 → 0.90.0

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/static_method_class_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/static_method_class'
+
+RSpec.describe EacRubyUtils::StaticMethodClass do
+  let(:sender_class) do
+    Class.new do
+      class << self
+        def sender_value
+          'AAA'
+        end
+      end
+    end
+  end
+
+  let(:method_class) do
+    the_described_class = described_class
+    Class.new do
+      def self.name
+        'TheSender::PerformX'
+      end
+
+      include the_described_class
+      attr_accessor :sender, :method_param
+
+      def initialize(sender, method_param)
+        self.sender = sender
+        self.method_param = method_param
+      end
+
+      def result
+        "#{sender.sender_value},#{method_param}"
+      end
+    end
+  end
+
+  before do
+    Object.const_set('TheSender', sender_class)
+    sender_class.const_set('PerformX', method_class)
+  end
+
+  it { expect(sender_class).to respond_to(:perform_x) }
+  it { expect(sender_class.perform_x('BBB')).to eq('AAA,BBB') }
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/struct_spec.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/struct'
+
+RSpec.describe EacRubyUtils::Struct do
+  let(:instance) { described_class.new('a' => 1, b: '') }
+  let(:other) { described_class.new('a' => 'm1', c: 'm2') }
+
+  describe '#[]' do
+    it { expect(instance[:a]).to eq(1) }
+    it { expect(instance['a']).to eq(1) }
+    it { expect(instance[:a?]).to be(true) }
+    it { expect(instance['a?']).to be(true) }
+    it { expect(instance[:b]).to eq('') }
+    it { expect(instance['b']).to eq('') }
+    it { expect(instance[:b?]).to be(false) }
+    it { expect(instance['b?']).to be(false) }
+    it { expect(instance[:c]).to be_nil }
+    it { expect(instance['c']).to be_nil }
+    it { expect(instance[:c?]).to be(false) }
+    it { expect(instance['c?']).to be(false) }
+  end
+
+  describe '#fetch' do
+    it { expect(instance.fetch(:a)).to eq(1) }
+    it { expect(instance.fetch('a')).to eq(1) }
+    it { expect(instance.fetch(:a?)).to be(true) }
+    it { expect(instance.fetch('a?')).to be(true) }
+    it { expect(instance.fetch(:b)).to eq('') }
+    it { expect(instance.fetch('b')).to eq('') }
+    it { expect(instance.fetch(:b?)).to be(false) }
+    it { expect(instance.fetch('b?')).to be(false) }
+    it { expect { instance.fetch(:c) }.to raise_error(KeyError) }
+    it { expect { instance.fetch('c') }.to raise_error(KeyError) }
+    it { expect { instance.fetch(:c?) }.to raise_error(KeyError) }
+    it { expect { instance.fetch('c?') }.to raise_error(KeyError) }
+  end
+
+  describe '#merge' do
+    let(:merged) { instance.merge(other) }
+
+    it { expect(merged.to_h).to eq(a: 'm1', b: '', c: 'm2') }
+  end
+
+  describe '#property_method' do
+    it { expect(instance.a).to eq(1) }
+    it { expect(instance.a?).to be(true) }
+    it { expect(instance.b).to eq('') }
+    it { expect(instance.b?).to be(false) }
+    it { expect { instance.c }.to raise_error(NoMethodError) }
+    it { expect { instance.c? }.to raise_error(NoMethodError) }
+  end
+
+  describe '#to_h' do
+    it { expect(instance.to_h).to eq(a: 1, b: '') }
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/wildcards_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/wildcards'
+
+RSpec.describe EacRubyUtils::Wildcards do
+  describe '#match' do
+    {
+      'h*llo' => { 'hello' => true, 'hallo' => true, 'hxllo' => true, 'hillo' => true },
+      'w?rld' => { 'world' => true, 'warld' => true, 'wzzrld' => false },
+      'h*l?o' => { 'hello' => true, 'hallo' => true, 'hxxllo' => true, 'hilbbo' => false },
+      '' => { '' => true, 'hello' => false },
+      'hello' => { '' => false, 'hello' => true }
+    }.each do |pattern, examples|
+      context "when pattern is '#{pattern}'" do
+        let(:instance) { described_class.new(pattern) }
+
+        examples.each do |string, expected_result|
+          context "when string is \"#{string}\"" do
+            it do
+              expect(instance.match?(string)).to eq(expected_result)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/yaml_spec.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'active_support/hash_with_indifferent_access'
+require 'eac_ruby_utils/yaml'
+
+RSpec.describe EacRubyUtils::Yaml do
+  let(:unpermitted_class) do
+    Class.new do
+      def initialize(value)
+        @value = value
+      end
+
+      def to_s
+        @value.to_s
+      end
+    end
+  end
+
+  let(:arrayliable_class) do
+    Class.new do
+      def initialize(value)
+        @value = value
+      end
+
+      def to_a
+        [@value]
+      end
+    end
+  end
+
+  let(:source) do
+    {
+      a: 'a', b: :b, c: false, d: true, e: nil,
+      f: [
+        'f',
+        {
+          g: 'g',
+          h: ActiveSupport::HashWithIndifferentAccess.new(
+            'i' => ['i', unpermitted_class.new('j')],
+            k: arrayliable_class.new('k')
+          )
+        }
+      ]
+    }
+  end
+
+  let(:target) do
+    {
+      a: 'a', b: :b, c: false, d: true, e: nil,
+      f: ['f', { g: 'g', h: { i: %w[i j], k: ['k'] } }]
+    }
+  end
+
+  describe '#dump' do
+    it { expect(described_class.load(described_class.dump(source))).to eq(target) }
+  end
+
+  describe '#sanitize' do
+    it { expect(described_class.sanitize(target)).to eq(target) }
+  end
+
+  describe '#yaml' do
+    {
+      ['text'] => false,
+      'text' => false,
+      "--- Text\n\n" => true,
+      "---\n:index: 0\n:codec_name: h264\n:codec_type: video\n" => true,
+      '--- - \n bla bla bla' => false,
+      "---\n*STRING" => false
+    }.each do |source, result|
+      it "return #{result} to source \"#{source}\"" do
+        expect(described_class.yaml?(source)).to eq(result)
+      end
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/locales/pt-BR.yml

@@ -0,0 +1,58 @@
+pt-BR:
+  eac_ruby_utils:
+    listable:
+      stub:
+        inteiro:
+          a:
+            label: Inteiro A
+            description: Inteiro A Descr.
+          b:
+            label: Inteiro BB
+            description: Inteiro BB Descr.
+          c:
+            label: Inteiro CCC
+            description: Inteiro CCC Descr.
+          __blank:
+            label: Inteiro em branco
+            description: Inteiro em branco Descr.
+        cadeia:
+          a:
+            label: Cadeia AAA
+            description: Cadeia AAA Descr.
+          b:
+            label: Cadeia BB
+            description: Cadeia BB Descr.
+          c:
+            label: Cadeia C
+            description: Cadeia C Descr.
+        code:
+          a:
+            label: Código A
+            description: Código A Descr.
+          b:
+            label: Código B
+            description: Código B Descr.
+        type:
+          a:
+            label: Tipo A
+            description: Tipo A Descr.
+          b:
+            label: Tipo B
+            description: Tipo B Descr.
+        simbolo:
+          a:
+            label: Simbolo A
+            description: Simbolo A Descr.
+          b:
+            label: Simbolo B
+            description: Simbolo B Descr.
+          c:
+            label: Simbolo C
+            description: Simbolo C Descr.
+        tipado:
+          a:
+            label: Tipado A
+            description: Tipado A Descr.
+          b:
+            label: Tipado B
+            description: Tipado B Descr.

data/sub/eac_ruby_utils/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('../lib', __dir__)
+require 'tmpdir'
+
+require 'i18n'
+I18n.load_path << File.join(__dir__, 'locales/pt-BR.yml')
+I18n.locale = 'pt-BR' # rubocop:disable Rails/I18nLocaleAssignment
+
+RSpec.configure do |config|
+  config.example_status_persistence_file_path = File.join(Dir.tmpdir, 'eac_ruby_utils_rspec')
+
+  require 'eac_ruby_utils/rspec/default_setup'
+  EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__), config)
+end

data/sub/eac_templates/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+local_gemfile = File.join(File.dirname(__FILE__), 'Gemfile.local')
+eval_gemfile local_gemfile if File.exist?(local_gemfile)

data/sub/eac_templates/README.textile

@@ -0,0 +1,59 @@
+h1. E.A.C. Templates
+
+Seja a árvore fonte:
+
+<pre><code class="shell">
+./
+├── path1/
+│   ├── a_module/
+│   │   ├── a/
+│   │   │   └── a_a
+│   │   └── b
+│   ├── sub_class/
+│   │   └── a/
+│   │       └── a_c
+│   └── super_class/
+│       ├── a/
+│       │   └── a_b
+│       └── b
+└── path2/
+    ├── a_module/
+    │   ├── a/
+    │   │   └── a_b
+    │   ├── b
+    │   └── c
+    ├── prepended_module/
+    │   └── c
+    ├── sub_class/
+    │   └── b
+    └── super_class/
+        ├── a/
+        │   └── a_b
+        └── b
+</code></pre>
+
+Com caminhos de busca @./path1/@ e @./path2/@, nessa ordem. E os módulos:
+
+<pre><code class="ruby">
+module AModule; end
+
+class SuperClass
+  include AModule
+end
+
+module PrependedModule; end
+
+class SubClass < SuperClass
+  prepend PrependedModule
+end
+</code></pre>
+
+O resultado da busca deve ser:
+
+|_. Caminho buscado |_. AModule |_. SuperClass |_. PrependedModule |_. SubClass |
+|_. a | @[a_a, a_b]@ | @[a_a, a_b]@ | @[a_a, a_b]@ |  @[a_a, a_b, a_c]@ |
+|_. a/a_a | @path1/a_module/a/a_a@ | @path1/a_module/a/a_a@ | _Não encontra_ | @path1/a_module/a/a_a@  |
+|_. a/a_b | @path2/a_module/a/a_b@ | @path1/super_class/a/a_b@| _Não encontra_ | @path1/super_class/a/a_b@ |
+|_. a/a_c | _Não encontra_ | _Não encontra_  | _Não encontra_ |  @path1/a_module/a/a_c@ |
+|_. b | @path1/a_module/b@ | @path1/super_class/b@ | _Não encontra_ | @path1/sub_class/b@ |
+|_. c | @path2/a_module/c@ | @path2/a_module/c@ |@path2/prepended_module/c@ | @path2/prepended_module/c@ |

data/sub/eac_templates/eac_templates.gemspec

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'eac_templates/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'eac_templates'
+  s.version     = EacTemplates::VERSION
+  s.authors     = ['Put here the authors']
+  s.summary     = 'Put here de description.'
+
+  s.files = Dir['{lib}/**/*']
+  s.required_ruby_version = '>= 2.7'
+
+  s.add_dependency 'eac_config', '~> 0.14', '>= 0.14.2'
+  s.add_dependency 'eac_ruby_utils', '~> 0.122'
+
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.10'
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/interface_methods'
+require 'eac_templates/abstract/fs_object'
+require 'eac_templates/variables/directory'
+
+module EacTemplates
+  module Abstract
+    class Directory < ::EacTemplates::Abstract::FsObject
+      enable_abstract_methods
+      delegate(*::EacTemplates::InterfaceMethods::DIRECTORY - %i[child chidren], to: :applier)
+
+      # @param basename [Pathname]
+      # @return [EacTemplates::Abstract::FsObject
+      def build_child(child_basename, child_type)
+        child_basename = child_basename.to_pathname
+        child_type = type_list.value_validate!(child_type)
+        category_module.const_get(child_type.to_s.camelize)
+          .new(owner, self, child_basename, options)
+      end
+
+      # @param basename [Pathname]
+      # @return [EacTemplates::Abstract::FsObject]
+      def child(basename)
+        basename = basename.to_pathname
+        children.find { |c| c.basename == basename } ||
+          raise_not_found("No child found with basename \"#{basename}\"")
+      end
+
+      # @return [Enumerable<EacTemplates::Abstract::FsObject>]
+      def children
+        children_basenames.map { |c_basename, c_type| build_child(c_basename, c_type) }
+      end
+
+      # @return [Hash<Pathname, Symbol>]
+      def children_basenames
+        raise_abstract_method __method__
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/interface_methods'
+require 'eac_templates/abstract/fs_object'
+require 'eac_templates/variables/file'
+
+module EacTemplates
+  module Abstract
+    class File < ::EacTemplates::Abstract::FsObject
+      enable_abstract_methods
+      delegate(*::EacTemplates::InterfaceMethods::FILE - %i[content path], to: :applier)
+
+      # @return [String]
+      def content
+        path.read
+      end
+
+      # @return [Pathname]
+      def path
+        raise_abstract_method __method__
+      end
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/abstract/fs_object_by_pathname'
+require 'eac_templates/abstract/not_found_error'
+
+module EacTemplates
+  module Abstract
+    class FsObject
+      class << self
+        # @param obj [Object]
+        # @return [EacTemplates::Abstract::FsObject, EacTemplates::Abstracts::FsObjectByPathname]
+        def assert(obj)
+          if obj.is_a?(self)
+            obj
+          else
+            ::EacTemplates::Abstract::FsObjectByPathname.new(obj)
+          end
+        end
+
+        # @param owner [Object]
+        # @param parent_object [Object, nil]
+        # @param subpath [Pathname]
+        # @return [EacTemplates::Abstract::FsObject]
+        def by_subpath(owner, parent_object, subpath, options = {})
+          r = new(owner, parent_object, nil, options)
+          subpath.if_present(::Pathname.new(''), &:to_pathname).each_filename do |basename|
+            parent_object = r
+            r = new(owner, parent_object, basename, options)
+          end
+          r
+        end
+      end
+
+      enable_abstract_methods
+      enable_simple_cache
+      enable_listable
+      lists.add_symbol :option, :source_set
+      lists.add_symbol :type, :directory, :file
+      common_constructor :owner, :parent_object, :basename, :options, default: [{}] do
+        self.basename = basename.present? ? basename.to_pathname : ::Pathname.new('')
+        self.options = ::EacTemplates::Abstract::FsObject.lists.option.hash_keys_validate!(options)
+      end
+
+      # @return [EacTemplates::Variables::Directory, EacTemplates::Variables::File]
+      def applier
+        applier_class.new(self)
+      end
+
+      # @return [Class]
+      def applier_class
+        ::EacTemplates::Variables.const_get(type.to_s.camelize)
+      end
+
+      # @return [Module]
+      def category_module
+        self.class.module_parent
+      end
+
+      # @return [Pathname]
+      def path_for_search
+        if parent_object.present?
+          parent_object.path_for_search.join(basename)
+        else
+          path_for_search_prefix.join(basename)
+        end
+      end
+
+      # @return [Pathname]
+      def path_for_search_prefix
+        raise_abstract_method __method__
+      end
+
+      def raise_not_found(message)
+        raise ::EacTemplates::Abstract::NotFoundError, message
+      end
+
+      # @return [EacTemplates::Sources::Set]
+      def source_set
+        options[OPTION_SOURCE_SET] || ::EacTemplates::Sources::Set.default
+      end
+
+      # @return [Symbol]
+      def type
+        type_list.value_validate!(self.class.name.demodulize.underscore.to_sym)
+      end
+
+      # @return [EacRubyUtils::Listable::SymbolList]
+      def type_list
+        ::EacTemplates::Abstract::FsObject.lists.type
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/abstract/fs_object_by_pathname.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacTemplates
+  module Abstract
+    class FsObjectByPathname
+      common_constructor :path do
+        self.path = path.to_pathname
+      end
+    end
+  end
+end

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

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module EacTemplates
+  module Abstract
+    class NotFoundError < ::RuntimeError
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/abstract/with_directory_file_methods.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'eac_templates/abstract/not_found_error'
+
+module EacTemplates
+  module Abstract
+    module WithDirectoryFileMethods
+      def build_fs_object(type)
+        fs_object_class(type).by_subpath(self, nil, subpath, source_set: source_set)
+      end
+
+      # @param child_basename [Pathname
+      # @return [Pathname]
+      def child_subpath(child_basename)
+        subpath.if_present(child_basename) { |v| v.join(child_basename) }.to_pathname
+      end
+
+      # @return [EacTemplates::Abstract::Directory]
+      def directory
+        build_fs_object(:directory)
+      end
+
+      # @return [EacTemplates::Abstract::File]
+      def file
+        build_fs_object(:file)
+      end
+
+      # @param type [Symbol]
+      # @return [Class]
+      def fs_object_class(type)
+        self.class.const_get(type.to_s.camelize)
+      end
+
+      # @return [EacTemplates::Abstract::Directory, EacTemplates::Abstract::File]
+      def sub_fs_object
+        file_search = file
+        return file_search if file_search.found?
+
+        directory_search = directory
+        return directory_search if directory_search.found?
+
+        raise ::EacTemplates::Abstract::NotFoundError, "No template found: #{self}"
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/core_ext.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_templates/patches'
+require 'eac_templates/sources/from_all_gems'

data/sub/eac_templates/lib/eac_templates/interface_methods.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module EacTemplates
+  module InterfaceMethods
+    COMMON = %i[apply path].freeze
+    ONLY_DIRECTORY = %i[child children].freeze
+    DIRECTORY = COMMON + ONLY_DIRECTORY
+    ONLY_FILE = %i[apply_to_file content variables].freeze
+    FILE = COMMON + ONLY_FILE
+    ALL = COMMON + ONLY_DIRECTORY + ONLY_FILE
+  end
+end

data/sub/eac_templates/lib/eac_templates/modules/ancestor/directory.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/abstract/directory'
+require 'eac_templates/interface_methods'
+require 'eac_templates/modules/ancestor/fs_object'
+
+module EacTemplates
+  module Modules
+    class Ancestor
+      class Directory < ::EacTemplates::Abstract::Directory
+        include ::EacTemplates::Modules::Ancestor::FsObject
+        delegate :children_basenames, to: :source_object
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/modules/ancestor/file.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/abstract/file'
+require 'eac_templates/interface_methods'
+require 'eac_templates/modules/ancestor/fs_object'
+
+module EacTemplates
+  module Modules
+    class Ancestor
+      class File < ::EacTemplates::Abstract::File
+        include ::EacTemplates::Modules::Ancestor::FsObject
+      end
+    end
+  end
+end

data/sub/eac_templates/lib/eac_templates/modules/ancestor/fs_object.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/interface_methods'
+
+module EacTemplates
+  module Modules
+    class Ancestor
+      module FsObject
+        delegate :found?, :path, to: :source_object
+
+        # @return [Pathname]
+        delegate :path_for_search, to: :owner
+
+        private
+
+        def source_object_uncached
+          owner.source_set.send(type, path_for_search)
+        end
+      end
+    end
+  end
+end