avm-tools 0.50.0 → 0.54.1

data/vendor/gems/eac_ruby_utils/README.rdoc

@@ -0,0 +1,3 @@
+= E.A.C. Ruby Utilities
+
+Utilities for E.A.C.'s Ruby projects.

data/vendor/gems/eac_ruby_utils/eac_ruby_utils.gemspec

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+# Maintain your gem's version:
+require 'eac_ruby_utils/version'
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = 'eac_ruby_utils'
+  s.version     = ::EacRubyUtils::VERSION
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Utilities for E.A.C.\'s Ruby projects.'
+  s.license     = 'MIT'
+
+  s.files = Dir['{lib}/**/*', 'MIT-LICENSE', 'README.rdoc']
+
+  s.add_dependency 'activesupport', '>= 4.0'
+  s.add_dependency 'addressable', '~> 2.6'
+  s.add_dependency 'colorize', '~> 0.8.1'
+  s.add_dependency 'docopt', '~> 0.6.1'
+  s.add_dependency 'net-ssh', '~> 4.2'
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.1', '>= 0.1.1'
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  require 'eac_ruby_utils/require_sub'
+  ::EacRubyUtils.require_sub __FILE__
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/arguments_consumer.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'active_support/hash_with_indifferent_access'
+require 'ostruct'
+
+module EacRubyUtils
+  class ArgumentsConsumer
+    class << self
+      def parse(args, positional = [], options = {})
+        new(args, positional, options).data
+      end
+    end
+
+    attr_reader :positional, :default_options
+
+    def initialize(positional, default_options)
+      @positional = positional.dup.freeze
+      @default_options = default_options.dup.freeze
+    end
+
+    def parse(args)
+      Parser.new(self, args).data
+    end
+
+    class Parser
+      attr_reader :data, :arguments_consumer
+
+      def initialize(arguments_consumer, args)
+        @arguments_consumer = arguments_consumer
+        @data = ::ActiveSupport::HashWithIndifferentAccess.new
+        @options_found = false
+        arguments_consumer.positional.each { |key| data[key] = nil }
+        data.merge!(arguments_consumer.default_options)
+        args.each_with_index { |value, index| add_arg(value, index) }
+        data.freeze
+      end
+
+      private
+
+      def add_arg(value, index)
+        arg = ::OpenStruct.new(value: value, index: index)
+        if arg.value.is_a?(::Hash)
+          add_hash_arg(arg)
+        else
+          add_positional_arg(arg)
+        end
+      end
+
+      def add_hash_arg(arg)
+        check_no_more_arguments(arg)
+        data.merge!(arg.value)
+        @options_found = true
+      end
+
+      def add_positional_arg(arg)
+        check_no_more_arguments(arg)
+        invalid_argument arg, 'No more valid positional' if
+          arg.index >= arguments_consumer.positional.count
+        data[arguments_consumer.positional[arg.index]] = arg.value
+      end
+
+      def check_no_more_arguments(arg)
+        return unless @options_found
+
+        invalid_argument arg, 'Hash already found - no more positional allowed'
+      end
+
+      def invalid_argument(arg, message)
+        raise InvalidArgumentError.new(self, arg, message)
+      end
+    end
+
+    class InvalidArgumentError < StandardError
+      def initialize(args_consumer, arg, message)
+        @args_consumer = args_consumer
+        @arg = arg
+        super "#{message} (Arg: #{arg}, Args Consumer: #{args_consumer})"
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/by_reference.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  class ByReference
+    def initialize(&object_provider)
+      @object_provider = object_provider
+    end
+
+    def method_missing(method_name, *arguments, &block)
+      return object.send(method_name, *arguments, &block) if object.respond_to?(method_name)
+
+      super
+    end
+
+    def object
+      @object_provider.call
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      object.respond_to?(method_name, include_private)
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/common_concern.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'active_support/concern'
+require 'eac_ruby_utils/simple_cache'
+require 'eac_ruby_utils/patches/object/if_present'
+
+module EacRubyUtils
+  class CommonConcern
+    CLASS_METHODS_MODULE_NAME = 'ClassMethods'
+    INSTANCE_METHODS_MODULE_NAME = 'InstanceMethods'
+
+    attr_reader :after_callback
+
+    def initialize(&after_callback)
+      @after_callback = after_callback
+    end
+
+    def setup(a_module)
+      Setup.new(self, a_module).run
+    end
+
+    class Setup
+      include ::EacRubyUtils::SimpleCache
+      attr_reader :a_module, :common_constructor
+
+      def initialize(common_constructor, a_module)
+        @common_constructor = common_constructor
+        @a_module = a_module
+      end
+
+      def run
+        setup = self
+        a_module.extend(::ActiveSupport::Concern)
+        a_module.included do
+          %w[class_methods instance_methods after_callback].each do |suffix|
+            setup.send("setup_#{suffix}", self)
+          end
+        end
+      end
+
+      def setup_class_methods(base)
+        class_methods_module.if_present { |v| base.extend v }
+      end
+
+      def setup_instance_methods(base)
+        instance_methods_module.if_present { |v| base.include v }
+      end
+
+      def setup_after_callback(base)
+        common_constructor.after_callback.if_present do |v|
+          base.instance_eval(&v)
+        end
+      end
+
+      def class_methods_module_uncached
+        a_module.const_get(CLASS_METHODS_MODULE_NAME)
+      rescue NameError
+        nil
+      end
+
+      def instance_methods_module_uncached
+        a_module.const_get(INSTANCE_METHODS_MODULE_NAME)
+      rescue NameError
+        nil
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/common_constructor.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'active_support/callbacks'
+require 'eac_ruby_utils/arguments_consumer'
+require 'ostruct'
+
+module EacRubyUtils
+  class CommonConstructor
+    attr_reader :args, :options, :after_set_block
+
+    class << self
+      def parse_args_options(args)
+        result = ::OpenStruct.new(args: [], options: {})
+        options_reached = false
+        args.each do |arg|
+          raise "Options reached and there is more arguments (Arguments: #{args})" if
+          options_reached
+
+          options_reached = parse_arg_options_process_arg(result, arg)
+        end
+        result
+      end
+
+      private
+
+      def parse_arg_options_process_arg(result, arg)
+        if arg.is_a?(::Hash)
+          result.options = arg
+          true
+        else
+          result.args << arg
+          false
+        end
+      end
+    end
+
+    def initialize(*args, &after_set_block)
+      args_processed = self.class.parse_args_options(args)
+      @args = args_processed.args
+      @options = args_processed.options
+      @after_set_block = after_set_block
+    end
+
+    def args_count
+      (args_count_min..args_count_max)
+    end
+
+    def args_count_min
+      args.count - default_values.count
+    end
+
+    def args_count_max
+      args.count
+    end
+
+    def default_values
+      options[:default] || []
+    end
+
+    def setup_class(klass)
+      setup_class_attr_readers(klass)
+      setup_class_attr_writers(klass)
+      setup_class_initialize(klass)
+    end
+
+    def setup_class_attr_readers(klass)
+      klass.send(:attr_reader, *args)
+      klass.send(:public, *args)
+    end
+
+    def setup_class_attr_writers(klass)
+      klass.send(:attr_writer, *args)
+      klass.send(:private, *args.map { |a| "#{a}=" })
+    end
+
+    def setup_class_initialize(klass)
+      common_constructor = self
+      klass.include(::ActiveSupport::Callbacks)
+      klass.define_callbacks :initialize
+      klass.send(:define_method, :initialize) do |*args|
+        Initialize.new(common_constructor, args, self).run
+      end
+    end
+
+    class Initialize
+      attr_reader :common_constructor, :args, :object
+
+      def initialize(common_constructor, args, object)
+        @common_constructor = common_constructor
+        @args = args
+        @object = object
+      end
+
+      def run
+        validate_args_count
+        object.run_callbacks :initialize do
+          object_attributes_set
+          object_after_callback
+        end
+      end
+
+      private
+
+      def arg_value(arg_name)
+        arg_index = common_constructor.args.index(arg_name)
+        if arg_index < args.count
+          args[arg_index]
+        else
+          common_constructor.default_values[arg_index - common_constructor.args_count_min]
+        end
+      end
+
+      def object_after_callback
+        return unless common_constructor.after_set_block
+
+        object.instance_eval(&common_constructor.after_set_block)
+      end
+
+      def object_attributes_set
+        common_constructor.args.each do |arg_name|
+          object.send("#{arg_name}=", arg_value(arg_name))
+        end
+      end
+
+      def validate_args_count
+        return if common_constructor.args_count.include?(args.count)
+
+        raise ArgumentError, "#{object.class}.initialize: wrong number of arguments" \
+          " (given #{args.count}, expected #{common_constructor.args_count})"
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/configs.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'yaml'
+require 'eac_ruby_utils/configs/file'
+require 'eac_ruby_utils/patches/hash/sym_keys_hash'
+require 'eac_ruby_utils/paths_hash'
+require 'eac_ruby_utils/simple_cache'
+
+module EacRubyUtils
+  class Configs
+    include ::EacRubyUtils::SimpleCache
+
+    attr_reader :configs_key, :options
+
+    # Valid options: [:storage_path]
+    def initialize(configs_key, options = {})
+      @configs_key = configs_key
+      @options = options.to_sym_keys_hash.freeze
+      load
+    end
+
+    delegate :clear, to: :file
+
+    delegate :save, to: :file
+
+    delegate :load, to: :file
+
+    def []=(entry_key, entry_value)
+      write_entry(entry_key, entry_value)
+    end
+
+    def write_entry(entry_key, entry_value)
+      file.write(entry_key, entry_value)
+    end
+
+    def [](entry_key)
+      read_entry(entry_key)
+    end
+
+    def read_entry(entry_key)
+      file.read(entry_key)
+    end
+
+    delegate :autosave?, to: :file
+
+    private
+
+    attr_accessor :data
+
+    def file_uncached
+      ::EacRubyUtils::Configs::File.new(
+        storage_path, options
+      )
+    end
+
+    def storage_path_uncached
+      path = options_storage_path || default_storage_path
+      return path if ::File.exist?(path) && ::File.size(path).positive?
+
+      ::FileUtils.mkdir_p(::File.dirname(path))
+      ::File.write(path, {}.to_yaml)
+      path
+    end
+
+    def options_storage_path
+      options[:storage_path]
+    end
+
+    def default_storage_path
+      ::File.join(ENV['HOME'], '.config', configs_key, 'settings.yml')
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/configs/file.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'yaml'
+require 'eac_ruby_utils/patches/hash/sym_keys_hash'
+require 'eac_ruby_utils/paths_hash'
+require 'eac_ruby_utils/simple_cache'
+
+module EacRubyUtils
+  class Configs
+    class File
+      include ::EacRubyUtils::SimpleCache
+
+      attr_reader :path, :options
+
+      # Valid options: [:autosave]
+      def initialize(path, options = {})
+        @path = path
+        @options = options.to_sym_keys_hash.freeze
+        load
+      end
+
+      def clear
+        self.data = ::EacRubyUtils::PathsHash.new({})
+      end
+
+      def save
+        ::FileUtils.mkdir_p(::File.dirname(path))
+        ::File.write(path, data.to_h.to_yaml)
+      end
+
+      def load
+        self.data = if ::File.exist?(path) && ::File.size(path).positive?
+                      ::EacRubyUtils::PathsHash.new(YAML.load_file(path))
+                    else
+                      {}
+                    end
+      end
+
+      def []=(entry_key, entry_value)
+        write(entry_key, entry_value)
+      end
+
+      def write(entry_key, entry_value)
+        data[entry_key] = entry_value
+        save if autosave?
+      end
+
+      def [](entry_key)
+        read(entry_key)
+      end
+
+      def read(entry_key)
+        data[entry_key]
+      end
+
+      def autosave?
+        options[:autosave] ? true : false
+      end
+
+      private
+
+      attr_accessor :data
+    end
+  end
+end