eac_tools 0.117.3 → 0.117.4

data/sub/eac_docker/lib/eac_docker/images/named.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module EacDocker
+  module Images
+    class Named < ::EacDocker::Images::Base
+      common_constructor :source_tag
+
+      def id
+        source_tag
+      end
+
+      def provide
+        provide_command.execute!
+        self
+      end
+
+      def provide_command
+        ::EacDocker::Executables.docker.command(*docker_provide_args)
+      end
+
+      def docker_provide_args
+        ['pull', source_tag]
+      end
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/images/templatized.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module EacDocker
+  module Images
+    class Templatized < ::EacDocker::Images::Base
+      enable_immutable
+      immutable_accessor :tag
+      attr_reader :provide_dir
+
+      def id
+        tag
+      end
+
+      def provide
+        ::EacRubyUtils::Fs::Temp.on_directory do |provide_dir|
+          self.provide_dir = provide_dir
+          write_in_provide_dir
+          coded_image(provide_dir).tag(tag).provide
+        ensure
+          self.provide_dir = nil
+        end
+      end
+
+      def coded_image(provide_dir)
+        ::EacDocker::Images::Coded.new(provide_dir)
+      end
+
+      protected
+
+      def variables_source
+        self
+      end
+
+      def write_in_provide_dir
+        eac_template.apply(variables_source, provide_dir)
+      end
+
+      private
+
+      attr_writer :provide_dir
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/registry.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Registry
+    common_constructor :name
+
+    def to_s
+      name
+    end
+
+    def sub(suffix)
+      self.class.new("#{name}#{suffix}")
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/rspec/setup.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module EacDocker
+  module Rspec
+    module Setup
+      def self.extended(obj)
+        obj.setup_conditional_docker_executable
+      end
+
+      def setup_conditional_docker_executable
+        conditional(:docker) { ::EacDocker::Executables.docker.validate }
+      end
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/rspec/stub_image.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module EacDocker
+  module Rspec
+    class StubImage
+      include ::ActiveSupport::Callbacks
+
+      define_callbacks :on_container
+      common_constructor :image
+
+      def build_container
+        image.provide.container.temporary(true)
+      end
+
+      def container
+        raise 'internal container is blank' if internal_container.blank?
+
+        internal_container
+      end
+
+      def on_container(&block)
+        raise 'A container was already created' if internal_container.present?
+
+        build_container.on_detached do |container|
+          self.internal_container = container
+          begin
+            run_callbacks(:on_container, &block)
+          ensure
+            self.internal_container = nil
+          end
+        end
+      end
+
+      private
+
+      attr_accessor :internal_container
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/version.rb

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

data/sub/eac_docker/lib/eac_docker.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base1'
+EacRubyBase1::RootModuleSetup.perform __FILE__ do
+  require 'eac_templates'
+end

data/sub/eac_docker/spec/lib/eac_docker/executables_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+RSpec.describe(EacDocker::Executables, :docker) do
+  it 'output version' do
+    expect(described_class.docker.command('--version').execute!).to be_present
+  end
+end

data/sub/eac_docker/spec/lib/eac_docker/images/coded_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+RSpec.describe(EacDocker::Images::Coded, :docker) do
+  let(:fixtures_dir) { Pathname.new('coded_spec_files').expand_path(__dir__) }
+  let(:instance) { described_class.new(fixtures_dir / 'image1') }
+
+  describe '#provide' do
+    it { expect { instance.provide }.not_to raise_error }
+  end
+end

data/sub/eac_docker/spec/lib/eac_docker/images/coded_spec_files/image1/Dockerfile

@@ -0,0 +1 @@
+from ubuntu:bionic

data/sub/eac_docker/spec/lib/eac_docker/images/templatized_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+RSpec.describe(EacDocker::Images::Templatized, :docker) do
+  let(:fixtures_dir) { Pathname.new('templatized_spec_files').expand_path(__dir__) }
+  let(:instance) { StubDockerImage.new }
+
+  before do
+    EacTemplates::Sources::Set.default.included_paths << fixtures_dir
+    stub_const('StubDockerImage', Class.new(described_class))
+  end
+
+  describe '#provide' do
+    it { expect { instance.provide }.not_to raise_error }
+  end
+end

data/sub/eac_docker/spec/lib/eac_docker/images/templatized_spec_files/stub_docker_image/Dockerfile

@@ -0,0 +1 @@
+from ubuntu:bionic

data/sub/eac_docker/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'eac_docker'
+require 'eac_ruby_gem_support'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__))

data/sub/eac_templates/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.local
+Gemfile.lock

data/sub/eac_templates/.gitrepo

@@ -0,0 +1,7 @@
+[subrepo]
+  cmdver = 0.4.9
+  commit = 2686486c391fcaa97f0c3006d272b010761cd8a5
+  method = merge
+  parent = 18fa852cf64b761c394038673f1ab0c8fbac65d3
+  branch = master
+  remote = https://github.com/esquilo-azul/eac_templates.git

data/sub/eac_templates/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/sub/eac_templates/.rubocop.yml

@@ -0,0 +1,3 @@
+---
+inherit_gem:
+  eac_ruby_gem_support: ".rubocop.yml"

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 = '>= 3.2'
+
+  s.add_dependency 'eac_config', '~> 0.15'
+  s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
+
+  s.add_development_dependency 'eac_fs', '~> 0.20', '>= 0.20.2'
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.14'
+end

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+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}\" in \"#{self}\"")
+      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,20 @@
+# frozen_string_literal: true
+
+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,95 @@
+# frozen_string_literal: true
+
+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
+
+      def to_s
+        source_set = options.if_key(:source_set, '-', &:included_paths)
+        "#{self.class}[Basename: #{basename}, Source Set: #{source_set}]"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+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,75 @@
+# frozen_string_literal: true
+
+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,3 @@
+# frozen_string_literal: true
+
+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/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,33 @@
+# frozen_string_literal: true
+
+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