avm-tools 0.47.0 → 0.52.0

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

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'colorize'
+require 'io/console'
+require 'eac_ruby_utils/patches/hash/options_consumer'
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub __FILE__
+
+module EacRubyUtils
+  module Console
+    # https://github.com/fazibear/colorize
+    module Speaker
+      def on_speaker_node(&block)
+        ::EacRubyUtils::Console::Speaker.on_node(&block)
+      end
+
+      def puts(string = '')
+        string.to_s.each_line do |line|
+          current_node.stderr.puts(current_node.stderr_line_prefix.to_s + line)
+        end
+      end
+
+      def out(string = '')
+        current_node.stdout.write(string.to_s)
+      end
+
+      def fatal_error(string)
+        puts "ERROR: #{string}".white.on_red
+        Kernel.exit 1 # rubocop:disable Rails/Exit
+      end
+
+      def title(string)
+        string = string.to_s
+        puts(('-' * (8 + string.length)).green)
+        puts("--- #{string} ---".green)
+        puts(('-' * (8 + string.length)).green)
+        puts
+      end
+
+      def info(string)
+        puts string.to_s.white
+      end
+
+      def infom(string)
+        puts string.to_s.light_yellow
+      end
+
+      def warn(string)
+        puts string.to_s.yellow
+      end
+
+      # Options:
+      #   +bool+ ([Boolean], default: +false+): requires a answer "yes" or "no".
+      #   +list+ ([Hash] or [Array], default: +nil+): requires a answer from a list.
+      #   +noecho+ ([Boolean], default: +false+): does not output answer.
+      def request_input(question, options = {})
+        bool, list, noecho = options.to_options_consumer.consume_all(:bool, :list, :noecho)
+        if list
+          request_from_list(question, list, noecho)
+        elsif bool
+          request_from_bool(question, noecho)
+        else
+          request_string(question, noecho)
+        end
+      end
+
+      def infov(*args)
+        r = []
+        args.each_with_index do |v, i|
+          if i.even?
+            r << "#{v}: ".cyan
+          else
+            r.last << v.to_s
+          end
+        end
+        puts r.join(', ')
+      end
+
+      def success(string)
+        puts string.to_s.green
+      end
+
+      private
+
+      def list_value(list, input)
+        values = list_values(list)
+        return input, true unless values
+        return input, false unless values.include?(input)
+      end
+
+      def list_values(list)
+        if list.is_a?(::Hash)
+          list.keys.map(&:to_s)
+        elsif list.is_a?(::Array)
+          list.map(&:to_s)
+        end
+      end
+
+      def request_from_bool(question, noecho)
+        request_from_list(question, { yes: true, y: true, no: false, n: false }, noecho)
+      end
+
+      def request_from_list(question, list, noecho)
+        list = ::EacRubyUtils::Console::Speaker::List.build(list)
+        loop do
+          input = request_string("#{question} [#{list.valid_labels.join('/')}]", noecho)
+          return list.build_value(input) if list.valid_value?(input)
+
+          warn "Invalid input: \"#{input}\" (Valid: #{list.valid_labels.join(', ')})"
+        end
+      end
+
+      def request_string(question, noecho)
+        current_node.stderr.write "#{question}: ".to_s.yellow
+        noecho ? request_string_noecho : request_string_echo
+      end
+
+      def request_string_noecho
+        r = current_node.stdin.noecho(&:gets).chomp.strip
+        current_node.stderr.write("\n")
+        r
+      end
+
+      def request_string_echo
+        current_node.stdin.gets.chomp.strip
+      end
+
+      def current_node
+        ::EacRubyUtils::Console::Speaker.current_node
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/_class_methods.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/console/speaker/node'
+
+module EacRubyUtils
+  module Console
+    module Speaker
+      class << self
+        def current_node
+          nodes_stack.last
+        end
+
+        def on_node(&block)
+          push
+          yield(*(block.arity.zero? ? [] : [current_node]))
+        ensure
+          pop
+        end
+
+        def push
+          nodes_stack << ::EacRubyUtils::Console::Speaker::Node.new
+          current_node
+        end
+
+        def pop
+          return nodes_stack.pop if nodes_stack.count > 1
+
+          raise "Cannot remove first node (nodes_stack.count: #{nodes_stack.count})"
+        end
+
+        private
+
+        def nodes_stack
+          @nodes_stack ||= [::EacRubyUtils::Console::Speaker::Node.new]
+        end
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/_constants.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/by_reference'
+
+module EacRubyUtils
+  module Console
+    # https://github.com/fazibear/colorize
+    module Speaker
+      STDERR = ::EacRubyUtils::ByReference.new { $stderr }
+      STDIN = ::EacRubyUtils::ByReference.new { $stdin }
+      STDOUT = ::EacRubyUtils::ByReference.new { $stdout }
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/list.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'active_support/hash_with_indifferent_access'
+require 'ostruct'
+
+module EacRubyUtils
+  module Console
+    module Speaker
+      class List
+        class << self
+          def build(list)
+            return List.new(hash_to_values(list)) if list.is_a?(::Hash)
+            return List.new(array_to_values(list)) if list.is_a?(::Array)
+
+            raise "Invalid list: #{list} (#{list.class})"
+          end
+
+          private
+
+          def hash_to_values(list)
+            list.map { |key, value| ::OpenStruct.new(key: key, label: key, value: value) }
+          end
+
+          def array_to_values(list)
+            list.map { |value| ::OpenStruct.new(key: value, label: value, value: value) }
+          end
+        end
+
+        attr_reader :values
+
+        def initialize(values)
+          @values = values.map do |v|
+            ::OpenStruct.new(key: to_key(v.key), label: to_label(v.label), value: v.value)
+          end
+        end
+
+        def valid_labels
+          values.map(&:label)
+        end
+
+        def valid_value?(value)
+          values.any? { |v| v.key == to_key(value) }
+        end
+
+        def to_key(value)
+          to_label(value).downcase
+        end
+
+        def to_label(value)
+          value.to_s.strip
+        end
+
+        def build_value(value)
+          key = to_key(value)
+          values.each do |v|
+            return v.value if v.key == key
+          end
+          raise "Value not found: \"#{value}\" (#{values})"
+        end
+      end
+    end
+  end
+end

data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/node.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patches/object/if_present'
+require 'eac_ruby_utils/console/speaker/_constants'
+
+module EacRubyUtils
+  module Console
+    module Speaker
+      class Node
+        attr_accessor :stdin, :stdout, :stderr, :stderr_line_prefix
+
+        def initialize(parent = nil)
+          self.stdin = parent.if_present(::EacRubyUtils::Console::Speaker::STDIN, &:stdin)
+          self.stdout = parent.if_present(::EacRubyUtils::Console::Speaker::STDOUT, &:stdout)
+          self.stderr = parent.if_present(::EacRubyUtils::Console::Speaker::STDERR, &:stderr)
+          self.stderr_line_prefix = parent.if_present('', &:stderr_line_prefix)
+        end
+
+        def configure
+          yield(self)
+          self
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  # Provides the method context which search and call a method in self and ancestor objects.
+  module Contextualizable
+    def context(method)
+      current = self
+      while current
+        return current.send(method) if current.respond_to?(method)
+
+        current = current.respond_to?(:parent) ? current.parent : nil
+      end
+      raise "Context method \"#{method}\" not found for #{self.class}"
+    end
+  end
+end

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

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/patches'
+require 'active_support/dependencies/autoload'
+require 'active_support/core_ext'

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  # A formatter like [String.sprintf].
+  class CustomFormat
+    TYPE_PATTERN = /[a-zA-Z]/.freeze
+    SEQUENCE_PATTERN = /(?<!%)%(#{TYPE_PATTERN})/.freeze
+
+    attr_reader :mapping
+
+    def initialize(mapping)
+      @mapping = mapping.map { |k, v| [k.to_sym, v] }.to_h.freeze
+    end
+
+    def format(string)
+      ::EacRubyUtils::CustomFormat::String.new(self, string)
+    end
+
+    class String
+      attr_reader :format, :string
+
+      def initialize(format, string)
+        @format = format
+        @string = string
+      end
+
+      def mapping
+        @mapping ||= format.mapping.select do |k, _v|
+          sequences.include?(k)
+        end
+      end
+
+      def sequences
+        @sequences ||= string.scan(SEQUENCE_PATTERN).map(&:first).uniq.map(&:to_sym)
+      end
+
+      def source_object_value(object, method)
+        return object.send(method) if object.respond_to?(method)
+        return object[method] if object.respond_to?('[]')
+
+        raise ::ArgumentError, "Methods \"#{method}\" or \"[]\" not found for #{object}"
+      end
+
+      def with(source_object)
+        r = string
+        mapping.each do |key, method|
+          r = r.gsub(/%#{::Regexp.quote(key)}/, source_object_value(source_object, method).to_s)
+        end
+        r.gsub('%%', '%')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/envs/base_env'
+require 'eac_ruby_utils/envs/command'
+require 'eac_ruby_utils/envs/file'
+require 'eac_ruby_utils/envs/local_env'
+require 'eac_ruby_utils/envs/process'
+require 'eac_ruby_utils/envs/ssh_env'
+require 'eac_ruby_utils/envs/executable'
+
+module EacRubyUtils
+  module Envs
+    class << self
+      def local
+        @local ||= ::EacRubyUtils::Envs::LocalEnv.new
+      end
+
+      def ssh(user_hostname)
+        ::EacRubyUtils::Envs::SshEnv.new(user_hostname)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/envs/command'
+require 'eac_ruby_utils/envs/executable'
+require 'eac_ruby_utils/envs/file'
+
+module EacRubyUtils
+  module Envs
+    class BaseEnv
+      def command(*args)
+        ::EacRubyUtils::Envs::Command.new(self, args)
+      end
+
+      # <b>DEPRECATED:</b> Please use <tt>file(file).exist?</tt> instead.
+      def file_exist?(file)
+        self.file(file).exist?
+      end
+
+      def executable(*executable_new_args)
+        ::EacRubyUtils::Envs::Executable.new(self, *executable_new_args)
+      end
+
+      def file(path)
+        ::EacRubyUtils::Envs::File.new(self, path)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/hash/indifferent_access'
+require 'eac_ruby_utils/console/speaker'
+require 'eac_ruby_utils/envs/command/extra_options'
+require 'eac_ruby_utils/envs/process'
+require 'eac_ruby_utils/envs/spawn'
+require 'pp'
+require 'shellwords'
+
+module EacRubyUtils
+  module Envs
+    class Command
+      include EacRubyUtils::Console::Speaker
+      include EacRubyUtils::Envs::Command::ExtraOptions
+
+      def initialize(env, command, extra_options = {})
+        @env = env
+        @extra_options = extra_options.with_indifferent_access
+        if command.count == 1 && command.first.is_a?(Array)
+          @command = command.first
+        elsif command.is_a?(Array)
+          @command = command
+        else
+          raise "Invalid argument command: #{command}|#{command.class}"
+        end
+      end
+
+      def args
+        @command
+      end
+
+      def append(args)
+        duplicate_by_command(@command + args)
+      end
+
+      def prepend(args)
+        duplicate_by_command(args + @command)
+      end
+
+      def to_s
+        "#{@command} [ENV: #{@env}]"
+      end
+
+      def command(options = {})
+        c = @command
+        c = c.map { |x| escape(x) }.join(' ') if c.is_a?(Enumerable)
+        append_command_options(
+          @env.command_line(
+            append_chdir(append_pipe(append_envvars(c)))
+          ),
+          options
+        )
+      end
+
+      def execute!(options = {})
+        er = ExecuteResult.new(execute(options), options)
+        return er.result if er.success?
+
+        raise "execute! command failed: #{self}\n#{er.r.pretty_inspect}"
+      end
+
+      def execute(options = {})
+        c = command(options)
+        puts "BEFORE: #{c}".light_red if debug?
+        t1 = Time.now
+        r = ::EacRubyUtils::Envs::Process.new(c).to_h
+        i = Time.now - t1
+        puts "AFTER [#{i}]: #{c}".light_red if debug?
+        r
+      end
+
+      def spawn(options = {})
+        c = command(options)
+        puts "SPAWN: #{c}".light_red if debug?
+        ::EacRubyUtils::Envs::Spawn.new(c)
+      end
+
+      def system!(options = {})
+        return if system(options)
+
+        raise "system! command failed: #{self}"
+      end
+
+      def system(options = {})
+        c = command(options)
+        puts c.light_red if debug?
+        Kernel.system(c)
+      end
+
+      protected
+
+      def duplicate(command, extra_options)
+        self.class.new(@env, command, extra_options)
+      end
+
+      private
+
+      attr_reader :extra_options
+
+      def duplicate_by_command(new_command)
+        duplicate(new_command, @extra_options)
+      end
+
+      def duplicate_by_extra_options(set_extra_options)
+        duplicate(@command, @extra_options.merge(set_extra_options))
+      end
+
+      def debug?
+        ENV['DEBUG'].to_s.strip != ''
+      end
+
+      def append_command_options(command, options)
+        command = options[:input].command + ' | ' + command if options[:input]
+        if options[:input_file]
+          command = "cat #{Shellwords.escape(options[:input_file])}" \
+            " | #{command}"
+        end
+        command += ' > ' + Shellwords.escape(options[:output_file]) if options[:output_file]
+        command
+      end
+
+      def escape(arg)
+        arg = arg.to_s
+        m = /^\@ESC_(.+)$/.match(arg)
+        m ? m[1] : Shellwords.escape(arg)
+      end
+
+      class ExecuteResult
+        attr_reader :r, :options
+
+        def initialize(result, options)
+          @r = result
+          @options = options
+        end
+
+        def result
+          return exit_code_zero_result if exit_code_zero?
+          return expected_error_result if expected_error?
+
+          raise 'Failed!'
+        end
+
+        def success?
+          exit_code_zero? || expected_error?
+        end
+
+        private
+
+        def exit_code_zero?
+          r[:exit_code]&.zero?
+        end
+
+        def exit_code_zero_result
+          r[options[:output] || :stdout]
+        end
+
+        def expected_error_result
+          options[:exit_outputs][r[:exit_code]]
+        end
+
+        def expected_error?
+          options[:exit_outputs].is_a?(Hash) && options[:exit_outputs].key?(r[:exit_code])
+        end
+      end
+    end
+  end
+end