eac_tools 0.117.2 → 0.117.4

data/sub/aranha/lib/aranha/temporary_errors_manager.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Aranha
+  module TemporaryErrorsManager
+    GEMS_REGISTRY_MODULE_SUFFIX = 'TemporaryErrors'
+
+    class << self
+      enable_simple_cache
+
+      # @return [Exception]
+      def errors
+        errors_providers.flat_map(&:errors)
+      end
+
+      # @return [Array]
+      def errors_providers
+        gems_registry.registered.map(&:registered_module)
+      end
+
+      # @param error Exception
+      # @return [Boolean]
+      def temporary_error?(error)
+        return true if errors.any? { |klass| error.is_a?(klass) }
+
+        error.cause.present? ? temporary_error?(error.cause) : false
+      end
+
+      private
+
+      # @return [EacRubyUtils::GemsRegistry]
+      def gems_registry_uncached
+        ::EacRubyUtils::GemsRegistry.new(GEMS_REGISTRY_MODULE_SUFFIX)
+      end
+    end
+  end
+end

data/sub/aranha/lib/aranha/version.rb

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

data/sub/aranha/lib/aranha.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base1'
+EacRubyBase1::RootModuleSetup.perform __FILE__

data/sub/aranha/spec/lib/aranha/temporary_errors_manager_spec.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class NonTemporaryError < StandardError
+end
+
+RSpec.describe(Aranha::TemporaryErrorsManager) do
+  describe '#temporary_error?' do
+    {
+      NonTemporaryError => false,
+      Errno::ECONNREFUSED => true
+    }.each do |error_class, expected_result|
+      context "when error is a #{error_class}" do
+        let(:error) { error_class.new('Any message') }
+
+        it do
+          expect(described_class.temporary_error?(error)).to eq(expected_result)
+        end
+      end
+    end
+  end
+end

data/sub/{eac_ruby_gem_support → aranha}/spec/spec_helper.rb

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

data/sub/avm/.gitignore

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

data/sub/avm/.gitrepo

@@ -0,0 +1,7 @@
+[subrepo]
+  cmdver = 0.4.9
+  commit = fb9059b1b26fa6f71743b838b165bf7da4983e62
+  method = merge
+  parent = b88ef2e3b021d442c1b4645ab97b9173d10fec7d
+  branch = master
+  remote = https://github.com/esquilo-azul/avm.git

data/sub/avm/.rspec

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

data/sub/avm/.rubocop.yml

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

data/sub/avm/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/avm/avm.gemspec

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'avm/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'avm'
+  s.version     = Avm::VERSION
+  s.authors     = ['Eduardo H. Bogoni']
+  s.summary     = 'Ruby base library for Agora Vai! Methodology (https://avm.esquiloazul.tech).'
+
+  s.files = Dir.glob('{lib,locale,template}/**/*', File::FNM_DOTMATCH)
+              .reject { |f| ['.', '..'].include?(File.basename(f)) }
+  s.required_ruby_version = '>= 3.2'
+
+  s.add_dependency 'eac_cli', '~> 0.47'
+  s.add_dependency 'eac_config', '~> 0.15'
+  s.add_dependency 'eac_docker', '~> 0.8', '>= 0.8.1'
+  s.add_dependency 'eac_fs', '~> 0.20', '>= 0.20.2'
+  s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
+  s.add_dependency 'eac_templates', '~> 0.9'
+  s.add_dependency 'minitar', '~> 0.12', '>= 0.12.1'
+
+  s.add_development_dependency 'avm-eac_ruby_base1', '~> 0.43', '>= 0.43.1'
+  s.add_development_dependency 'avm-git', '~> 0.21', '>= 0.21.2'
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.14'
+end

data/sub/avm/lib/avm/application_scms/base.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Avm
+  module ApplicationScms
+    class Base
+      acts_as_abstract
+
+      class << self
+        # @return [String]
+        def type_name
+          name.gsub(/#{Regexp.quote('::ApplicationScms::Base')}$/, '').demodulize
+        end
+      end
+
+      # !method initialize(application)
+      # @param application [Avm::Application::Base]
+      common_constructor :application
+      delegate :type_name, to: :class
+
+      # @param path [Pathname]
+      # @return [Pathname]
+      def assert_main_at(path) # rubocop:disable Lint/UnusedMethodArgument
+        raise_abstract_method __method__
+      end
+
+      # @return [String]
+      def to_s
+        "#{type_name}[#{to_s_type_specific}]"
+      end
+
+      # @return [String]
+      def to_s_type_specific
+        ''
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/application_stereotypes/base.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Avm
+  module ApplicationStereotypes
+    class Base
+      enable_listable
+      lists.add_symbol :resource, :instance, :source, :source_generator
+      common_constructor :namespace_module, :resources do
+        self.resources = self.class.lists.resource.hash_keys_validate!(resources)
+      end
+
+      # @return [String]
+      def name
+        namespace_module.name.demodulize
+      end
+
+      # @return [String]
+      def to_s
+        name
+      end
+
+      lists.resource.each_value do |resource|
+        define_method "#{resource}_class" do
+          resources[resource]
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/auto_local_source_path.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      class AutoLocalSourcePath
+        acts_as_instance_method
+        common_constructor :application
+
+        # @return [Pathname]
+        def result
+          application.scm.assert_main_at(fs_cache.path.to_pathname)
+        end
+
+        # @return [String]
+        def fs_object_id
+          application.id.to_s.parameterize
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/local_instance.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module LocalInstance
+        LOCAL_INSTANCE_SUFFIX = 'dev'
+
+        # @return [String]
+        def local_instance_id
+          ::Avm::Instances::Ids.build(id, local_instance_suffix)
+        end
+
+        # @return [String]
+        def local_instance_suffix
+          LOCAL_INSTANCE_SUFFIX
+        end
+
+        private
+
+        # @return [Avm::Instances::Base]
+        def local_instance_uncached
+          instance(local_instance_suffix)
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/local_source.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module LocalSource
+        # @return [Pathname]
+        def local_source_path
+          user_local_source_path || auto_local_source_path
+        end
+
+        # @return [EacConfig::Entry]
+        def local_source_path_entry
+          ::EacConfig::Node.context.current.entry([local_instance_id, 'install', 'path'])
+        end
+
+        # @return [Path, nil]
+        def user_local_source_path
+          local_source_path_entry.value.if_present(&:to_pathname)
+        end
+
+        private
+
+        # @return [Avm::Sources::Base]
+        def local_source_uncached
+          ::Avm::Registry.sources.detect(local_source_path)
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/naming.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module Naming
+        DEFAULT_NAME = '_Undefined_'
+
+        # @return [String]
+        def default_name
+          DEFAULT_NAME
+        end
+
+        # @return [String]
+        def name
+          name_from_configuration || default_name
+        end
+
+        # @return [String]
+        def name_from_configuration
+          entry(::Avm::Instances::EntryKeys::NAME).optional_value
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/organization.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module Organization
+        DEFAULT_ORGANIZATION = '_undefined_'
+        ORGANIZATION_CONFIG_KEY = 'organization'
+
+        # @return [String]
+        def default_organization
+          DEFAULT_ORGANIZATION
+        end
+
+        # @return [String, nil]
+        def organization_by_configuration
+          entry(ORGANIZATION_CONFIG_KEY).optional_value
+        end
+
+        # @return [String]
+        def organization
+          organization_by_configuration || default_organization
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/publishing.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module Publishing
+        PUBLISHABLE_KEY = 'publishable'
+
+        def publishable?
+          publishable_value ? true : false
+        end
+
+        def stereotype_publishable?(stereotype)
+          return publishable? unless publishable_value.is_a?(::Hash)
+
+          parse_publishable_value(publishable_value[stereotype.stereotype_name], true)
+        end
+
+        private
+
+        def publishable_value
+          parse_publishable_value(entry(PUBLISHABLE_KEY).optional_value, false)
+        end
+
+        def parse_publishable_value(value, hash_to_true)
+          return value.with_indifferent_access if parse_publishable_value_hash?(value, hash_to_true)
+          return true if value.nil? || value == true
+          return false if value == false || value.is_a?(::EacRubyUtils::BlankNotBlank)
+
+          value ? true : false
+        end
+
+        def parse_publishable_value_hash?(value, hash_to_true)
+          !hash_to_true && value.is_a?(::Hash)
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/scm.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module Scm
+        common_concern do
+          uri_components_entries_values 'scm', %w[repos_path ssh_username type]
+        end
+
+        # @return [Avm::ApplicationScms::Base]
+        def scm
+          @scm ||= ::Avm::Registry.application_scms.detect(self)
+        end
+
+        # @param value [String]
+        # @return [String]
+        def scm_repos_path_inherited_value_proc(value)
+          value.to_pathname.join(id).to_path
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base/stereotype.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      module Stereotype
+        # @return [Avm::ApplicationStereotypes::Base, nil]
+        def stereotype_by_configuration
+          entry('stereotype').optional_value.if_present do |v|
+            ::Avm::Registry.application_stereotypes.detect(v)
+          end
+        end
+
+        # @return [Avm::ApplicationStereotypes::Base, nil]
+        def stereotype_by_source
+          ::Avm::Registry.application_stereotypes.detect_optional(local_source.class)
+        end
+
+        private
+
+        # @return [Avm::ApplicationStereotypes::Base]
+        def stereotype_uncached
+          stereotype_by_configuration || stereotype_by_source ||
+            raise("Could not find stereotype for application \"#{self}\"")
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/applications/base.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Avm
+  module Applications
+    class Base
+      enable_simple_cache
+      include ::Avm::Entries::Base
+
+      AVM_TYPE = 'Application'
+
+      class << self
+        # @param id [String]
+        # @return [Avm::Applications::Base]
+        def by_id(id)
+          new(id)
+        end
+      end
+
+      common_constructor :id do
+        self.id = id.to_s
+      end
+
+      def to_s
+        id
+      end
+
+      def instance(suffix)
+        stereotype.instance_class.new(self, suffix)
+      end
+
+      require_sub __FILE__, include_modules: true, require_mode: :kernel
+    end
+  end
+end

data/sub/avm/lib/avm/data/callbacks.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'active_support/callbacks'
+
+module Avm
+  module Data
+    module Callbacks
+      common_concern do
+        include ::ActiveSupport::Callbacks
+
+        %i[dump load].each do |action|
+          define_callbacks action
+
+          %i[before after].each do |callback|
+            method_name = "#{callback}_#{action}"
+            singleton_class.class_eval do
+              define_method method_name do |callback_method = nil, &block|
+                if callback_method
+                  set_callback action, callback, callback_method
+                else
+                  set_callback action, callback, &block
+                end
+                self
+              end
+            end
+
+            define_method method_name do |callback_method = nil, &block|
+              singleton_class.send(method_name, callback_method, &block)
+              self
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/data/clearer.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Avm
+  module Data
+    class Clearer < ::Avm::Data::Performer
+      def cannot_perform_reason
+        nil
+      end
+
+      protected
+
+      def internal_perform
+        data_owner.clear(*include_excludes_arguments)
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/data/dumper.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module Avm
+  module Data
+    class Dumper < ::Avm::Data::Performer
+      DEFAULT_EXPIRE_TIME = 1.day
+      DEFAULT_OVERWRITE = false
+      DEFAULT_ROTATE = true
+
+      enable_speaker
+      enable_listable
+      immutable_accessor :expire_time, :target_path
+      immutable_accessor :overwrite, :rotate, type: :boolean
+
+      # @return [nil]
+      def cannot_perform_reason
+        nil
+      end
+
+      # @return [Pathname]
+      def default_dump_path
+        r = data_owner.data_default_dump_path
+        include_excludes_path_suffix.if_present(r) do |v|
+          r.basename_sub('.*') { |b| "#{b}#{v}#{r.extname}" }
+        end
+      end
+
+      # @return [Boolean]
+      def target_path_expired?
+        target_path_time.if_present(true) { |v| v >= expire_time }
+      end
+
+      # @return [ActiveSupport::Duration, nil]
+      def target_path_time
+        target_path.exist? ? ::Time.now - ::File.mtime(target_path) : nil
+      end
+
+      protected
+
+      attr_reader :temp_data_path
+
+      # @return [Array<Symbol>]
+      def all_units
+        data_owner.units.keys.sort
+      end
+
+      def build_temp_data_file
+        data_owner.dump(temp_data_path, *include_excludes_arguments)
+        raise "\"#{temp_data_path}\" do not exist" unless temp_data_path.exist?
+        raise "\"#{temp_data_path}\" is not a file" unless temp_data_path.file?
+      end
+
+      # @return [String, nil]
+      def do_rotate
+        return unless target_path.exist?
+        return unless rotate?
+
+        infom "Rotating \"#{target_path}\"..."
+        ::Avm::Data::Rotate.new(target_path).run
+      end
+
+      # @return [Array<Symbol>]
+      def excluded_units
+        excludes.map(&:to_sym).sort
+      end
+
+      # @return [ActiveSupport::Duration]
+      def expire_time_get_filter(value)
+        value || DEFAULT_EXPIRE_TIME
+      end
+
+      # @return [String]
+      def include_excludes_path_suffix
+        return nil unless data_owner.respond_to?(:units)
+
+        r = included_units.any? ? included_units : all_units
+        r -= excluded_units if excluded_units.any?
+        r.any? && r != all_units ? "_#{r.join('-')}" : ''
+      end
+
+      # @return [Array<Symbol>]
+      def included_units
+        includes.map(&:to_sym).sort
+      end
+
+      # @return [self]
+      def internal_perform
+        use_current? ? internal_perform_use_current : internal_perform_new
+      end
+
+      def internal_perform_new
+        on_temp_data_file do
+          build_temp_data_file
+          do_rotate
+          move_data_to_target_path
+        end
+      end
+
+      def internal_perform_use_current
+        infom "Dump \"#{target_path}\" exists and is unexpired"
+      end
+
+      def move_data_to_target_path
+        ::FileUtils.mv(temp_data_path, target_path.assert_parent)
+      end
+
+      def on_temp_data_file
+        ::EacRubyUtils::Fs::Temp.on_file do |file|
+          @temp_data_path = file.to_pathname
+          yield
+        end
+      end
+
+      # @return [Boolean]
+      def overwrite_get_filter(value)
+        value.nil? ? DEFAULT_OVERWRITE : value
+      end
+
+      def rotate_get_filter(value)
+        value.nil? ? DEFAULT_ROTATE : value
+      end
+
+      # @return [Pathname]
+      def target_path_get_filter(value)
+        (value || default_dump_path).to_pathname
+      end
+
+      # @return [Boolean]
+      def use_current?
+        return false unless target_path.exist?
+        return false if overwrite?
+
+        !target_path_expired?
+      end
+    end
+  end
+end