eac_tools 0.92.0 → 0.93.0

data/sub/avm-files/lib/avm/files/runner_with/filesystem_traverser.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner'
+require 'eac_fs/traversable'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/settings_provider'
+
+module Avm
+  module Files
+    module RunnerWith
+      module FilesystemTraverser
+        DEFAULT_DEFAULT_TRAVERSER_RECURSIVE = false
+
+        common_concern do
+          include ::EacCli::Runner
+          include ::EacFs::Traversable
+          enable_settings_provider
+          include TopMethods
+          runner_definition do
+            bool_opt '-R', '--recursive', 'Recursive.'
+            bool_opt '--no-recursive', 'No recursive.'
+            pos_arg :paths, optional: true, repeat: true
+          end
+        end
+
+        module TopMethods
+          def on_none_path_informed
+            infom 'Warning: none path informed'
+          end
+
+          def paths
+            parsed.paths.map(&:to_pathname)
+          end
+
+          def run_filesystem_traverser
+            if parsed.paths.any?
+              parsed.paths.each { |path| traverser_check_path(path) }
+            else
+              on_none_path_informed
+            end
+          end
+
+          def traverser_recursive
+            return false if parsed.no_recursive?
+            return true if parsed.recursive?
+
+            setting_value(:default_traverser_recursive, required: false)
+              .if_not_nil(DEFAULT_DEFAULT_TRAVERSER_RECURSIVE)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/{avm/lib/avm/launcher/paths.rb → avm-files/lib/avm/files/runner_with.rb}

@@ -3,8 +3,8 @@
 require 'eac_ruby_utils/core_ext'
 
 module Avm
-  module Launcher
-    module Paths
+  module Files
+    module RunnerWith
       require_sub __FILE__
     end
   end

data/sub/avm-files/lib/avm/files/text_replacer/gsub.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Files
+    class TextReplacer
+      class Gsub
+        common_constructor :from, :to do
+          self.from = from
+          self.to = to
+        end
+
+        def apply(input)
+          input.gsub(from, to)
+        end
+
+        def to_s
+          "\"#{from}\" => \"#{to}\""
+        end
+      end
+    end
+  end
+end

data/sub/avm-files/lib/avm/files/text_replacer.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Files
+    class TextReplacer
+      require_sub __FILE__
+      enable_immutable
+
+      immutable_accessor :replacement, type: :array
+
+      def apply(input)
+        replacements.inject(input) { |a, e| e.apply(a) }
+      end
+
+      def file_apply(file)
+        file = file.to_pathname
+        input = file.read
+        output = apply(file.read)
+        return false if output == input
+
+        file.write(output)
+        true
+      end
+
+      def gsub(from, to)
+        replacement(::Avm::Files::TextReplacer::Gsub.new(from, to))
+      end
+    end
+  end
+end

data/sub/{avm/spec/dummy/avm-tools_stub/lib/avm/tools.rb → avm-files/lib/avm/files/version.rb}

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Avm
-  module Tools
+  module Files
+    VERSION = '0.8.0'
   end
 end

data/sub/{avm/lib/avm/rspec.rb → avm-files/lib/avm/files.rb}

@@ -3,7 +3,7 @@
 require 'eac_ruby_utils/core_ext'
 
 module Avm
-  module Rspec
+  module Files
     require_sub __FILE__
   end
 end

data/sub/avm-files/spec/rubocop_spec.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+EacRubyUtils::Rspec.default_setup.describe_rubocop

data/sub/avm-files/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/rspec/default_setup'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__))

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,21 @@
+# 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_fs', '~> 0.17'
+  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/errors/not_found'
+
+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::Errors::NotFound, 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/with_directory_file_methods.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require 'eac_templates/errors/not_found'
+
+module EacTemplates
+  module Abstract
+    module WithDirectoryFileMethods
+      common_concern do
+        enable_simple_cache
+      end
+
+      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 [Boolean]
+      def directory?
+        directory.found?
+      end
+
+      # @return [Boolean]
+      def file?
+        file.found?
+      end
+
+      # @return [Boolean]
+      def file_template?
+        file? && file.template?
+      end
+
+      # @return [Boolean]
+      def found?
+        directory? || 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
+        return file if file.found?
+        return directory if directory.found?
+
+        raise ::EacTemplates::Errors::NotFound, "No template found: #{self}"
+      end
+
+      # @return [String]
+      def to_s
+        v = 'NOT_FOUND'
+        v = directory.to_s if directory?
+        v = file.to_s if file?
+        "#{self.class.name}[#{v}]"
+      end
+
+      private
+
+      # @return [EacTemplates::Abstract::Directory]
+      def directory_uncached
+        build_fs_object(:directory)
+      end
+
+      # @return [EacTemplates::Abstract::File]
+      def file_uncached
+        build_fs_object(:file)
+      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/errors/not_found.rb

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

data/sub/eac_templates/lib/eac_templates/errors/type_mismatch.rb

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

data/sub/{avm/lib/avm/entries.rb → eac_templates/lib/eac_templates/errors.rb}

@@ -2,8 +2,8 @@
 
 require 'eac_ruby_utils/core_ext'
 
-module Avm
-  module Entries
+module EacTemplates
+  module Errors
     require_sub __FILE__
   end
 end

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,37 @@
+# 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 :found?, :path, to: :source_object
+
+        # @return [Hash<Pathname, Symbol>]
+        def children_basenames
+          source_object.children_basenames.to_h { |k, v| parse_child_basename(k, v) }
+        end
+
+        protected
+
+        # @param basename [Pathname]
+        # @param type [Symbol]
+        # @return [Array]
+        def parse_child_basename(basename, type)
+          return [basename, type] unless type == :file
+
+          new_basename = ::EacTemplates::Modules::Ancestor::File.parse_basename(basename)
+
+          return [basename, type] if new_basename == basename
+
+          [new_basename, :file_template]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,64 @@
+# 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
+
+        TEMPLATE_EXTNAME_PATTERN =
+          /#{::Regexp.quote(::EacTemplates::Variables::FsObject::TEMPLATE_EXTNAME)}\z/.freeze
+
+        class << self
+          def parse_basename(basename)
+            basename.if_present do |v|
+              v.to_pathname
+                .to_path
+                .gsub(TEMPLATE_EXTNAME_PATTERN, '')
+                .to_pathname
+            end
+          end
+        end
+
+        # @return [Boolean]
+        def found?
+          source_object.found? || template?
+        end
+
+        # @return [Pathname]
+        def path
+          template? ? template_source_object.path : source_object.path
+        end
+
+        # @return [Pathname]
+        def basename
+          self.class.parse_basename(super)
+        end
+
+        # @return [Boolean]
+        def template?
+          template_source_object.found?
+        end
+
+        protected
+
+        # @return [EacTemplates::Sources::File]
+        def template_source_object_uncached
+          owner.source_set.send(type, template_source_object_path_for_search)
+        end
+
+        # @return [Pathname]
+        def template_source_object_path_for_search
+          path_for_search.basename_sub do |b|
+            "#{b}#{::EacTemplates::Variables::FsObject::TEMPLATE_EXTNAME}"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/interface_methods'
+
+module EacTemplates
+  module Modules
+    class Ancestor
+      module FsObject
+        # @return [Pathname]
+        delegate :path_for_search, to: :owner
+
+        # @return [String]
+        def to_s
+          "#{self.class.name}[#{path_for_search}]"
+        end
+
+        private
+
+        def source_object_uncached
+          owner.source_set.send(type, path_for_search)
+        end
+      end
+    end
+  end
+end