eac_tools 0.90.0 → 0.91.0

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/command.rb

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/core_ext'
-require 'eac_ruby_utils/envs/base_command'
-
-module EacRubyUtils
-  module Envs
-    class Command
-      require_sub __FILE__, include_modules: true, require_dependency: true
-      include ::EacRubyUtils::Envs::BaseCommand
-
-      class << self
-        # @param command [Array]
-        # @return [Array]
-        def sanitize_initialize_arguments(arguments)
-          if arguments.count == 1 && arguments.first.is_a?(Array)
-            arguments.first
-          elsif arguments.is_a?(Array)
-            arguments
-          else
-            raise "Invalid argument command: #{arguments}|#{arguments.class}"
-          end
-        end
-      end
-
-      common_constructor :env, :args, :extra_options, default: [{}] do
-        self.extra_options = extra_options.with_indifferent_access
-        self.args = self.class.sanitize_initialize_arguments(args)
-      end
-
-      def append(args)
-        duplicate_by_command(self.args + args)
-      end
-
-      def prepend(args)
-        duplicate_by_command(args + self.args)
-      end
-
-      def to_s
-        "#{args} [ENV: #{env}]"
-      end
-
-      # @return [String]
-      def command_line_without_env
-        c = args
-        c = c.map { |x| escape(x) }.join(' ') if c.is_a?(Enumerable)
-        append_chdir(append_envvars(c))
-      end
-
-      protected
-
-      def duplicate(command, extra_options)
-        self.class.new(env, command, extra_options)
-      end
-
-      private
-
-      def duplicate_by_command(new_command)
-        duplicate(new_command, extra_options)
-      end
-
-      def duplicate_by_extra_options(set_extra_options)
-        duplicate(args, extra_options.merge(set_extra_options))
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/composite_command.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/core_ext'
-require 'eac_ruby_utils/envs/base_command'
-
-module EacRubyUtils
-  module Envs
-    class CompositeCommand
-      include ::EacRubyUtils::Envs::BaseCommand
-
-      enable_listable
-      lists.add_string :operator, '&&' => :and, ';' => :before, '||' => :or, '|' => :pipe
-
-      common_constructor :operator, :left_command, :right_command do
-        self.operator = self.class.lists.operator.value_validate!(operator.to_s)
-      end
-
-      # @return [EacRubyUtils::Envs::BaseEnv]
-      delegate :env, to: :left_command
-
-      # @return [String]
-      def command_line_without_env(_options = {})
-        ::Shellwords.join(['bash', '-c', bash_command])
-      end
-
-      # @return [String]
-      def bash_command
-        ['set', '-euo', 'pipefail', OPERATOR_BEFORE, left_command_line, operator,
-         right_command_line].join(' ')
-      end
-
-      def left_command_line
-        left_command.command_line_without_env
-      end
-
-      def right_command_line
-        if right_command.env == left_command.env
-          right_command.command_line_without_env
-        else
-          right_command.command
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/executable.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/listable'
-require 'eac_ruby_utils/simple_cache'
-
-module EacRubyUtils
-  module Envs
-    class Executable
-      include ::EacRubyUtils::Listable
-      include ::EacRubyUtils::SimpleCache
-
-      lists.add_symbol :option, :check_args, :exec_args, :auto_validate
-
-      DEFAULT_AUTO_VALIDATE = true
-
-      attr_reader :env, :name, :options
-
-      def initialize(env, name, *check_args)
-        @env = env
-        @name = name
-        self.options = self.class.lists.option.hash_keys_validate!(check_args.extract_options!)
-        options[OPTION_CHECK_ARGS] = check_args unless options.key?(OPTION_CHECK_ARGS)
-        options.freeze
-      end
-
-      def auto_validate?
-        options.key?(OPTION_AUTO_VALIDATE) ? options[OPTION_AUTO_VALIDATE] : DEFAULT_AUTO_VALIDATE
-      end
-
-      def check_args
-        options[OPTION_CHECK_ARGS]
-      end
-
-      def exist?
-        exist
-      end
-
-      def validate
-        return nil if exist?
-
-        "Program \"#{::Shellwords.join(executable_args)}\" not found in environment #{env}"
-      end
-
-      def validate!
-        message = validate
-
-        raise ProgramNotFoundError, message if message
-      end
-
-      def command(*command_args)
-        validate! if auto_validate?
-        env.command(*executable_args, *command_args)
-      end
-
-      def executable_args
-        executable_args_from_envvar || executable_args_from_options || executable_args_from_name
-      end
-
-      def executable_args_envvar
-        "#{name}_command".variableize.upcase
-      end
-
-      def executable_args_from_envvar
-        ENV[executable_args_envvar].if_present { |v| ::Shellwords.split(v) }
-      end
-
-      # @return [Enumerable<String>]
-      def executable_args_from_name
-        ::Shellwords.split(name)
-      end
-
-      # @return [Enumerable<String>]
-      def executable_args_from_options
-        options[OPTION_EXEC_ARGS].if_present do |v|
-          v.is_a?(::Enumerable) ? v.map(&:to_s) : ::Shellwords.split(v.to_s)
-        end
-      end
-
-      private
-
-      attr_writer :options
-
-      def exist_uncached
-        env.command(*executable_args, *check_args).execute!
-        true
-      rescue Errno::ENOENT
-        false
-      end
-
-      class ProgramNotFoundError < ::StandardError; end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/execution_error.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module Envs
-    class ExecutionError < ::RuntimeError
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/execution_result.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/envs/execution_error'
-
-module EacRubyUtils
-  module Envs
-    class ExecutionResult
-      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 ::EacRubyUtils::Envs::ExecutionError, '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

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/file.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module Envs
-    class File
-      attr_reader :env, :path
-
-      def initialize(env, path)
-        @env = env
-        @path = path
-      end
-
-      def exist?
-        env.command('stat', path).execute[:exit_code].zero?
-      end
-
-      def read
-        env.command('cat', path).execute!
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/local_env.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/envs/base_env'
-
-module EacRubyUtils
-  module Envs
-    class LocalEnv < ::EacRubyUtils::Envs::BaseEnv
-      def to_s
-        'LOCAL'
-      end
-
-      def command_line(line)
-        line
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/process.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require 'open3'
-
-module EacRubyUtils
-  module Envs
-    class Process
-      EXIT_CODE_KEY = :exit_code
-      ERR_KEY = :stderr
-      OUT_KEY = :stdout
-
-      def initialize(command)
-        self.data = { command: command }
-        data[OUT_KEY], data[ERR_KEY], data[EXIT_CODE_KEY] = Open3.capture3(command)
-        data[EXIT_CODE_KEY] = data[EXIT_CODE_KEY].to_i
-      end
-
-      def to_h
-        data.dup
-      end
-
-      private
-
-      attr_accessor :data
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/spawn.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module Envs
-    class Spawn
-      attr_reader :command, :pid
-
-      def initialize(command)
-        @command = command
-        @pid = ::Process.spawn(command)
-      end
-
-      def kill(signal)
-        ::Process.kill(signal, pid)
-      end
-
-      def kill_at_end(&block)
-        block.call(self)
-      ensure
-        kill('KILL')
-      end
-
-      def to_h
-        { command: command, pid: pid }
-      end
-
-      def wait
-        ::Process.wait pid
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env/dasho_options.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/patches/module/common_concern'
-require 'eac_ruby_utils/patches/module/simple_cache'
-
-module EacRubyUtils
-  module Envs
-    class SshEnv < ::EacRubyUtils::Envs::BaseEnv
-      module DashoOptions
-        common_concern
-
-        module ClassMethods
-          def add_nodasho_option(name)
-            return if nodasho_options.include?(name)
-
-            nodasho_options << name
-            const_set("#{name.underscore}_option".upcase, name)
-          end
-
-          def nodasho_options
-            @nodasho_options ||= []
-          end
-        end
-
-        module InstanceMethods
-          def ssh_command_line_dasho_args
-            r = []
-            uri.query_values&.each do |k, v|
-              r += ['-o', "#{k}=#{v}"] unless nodasho_options.include?(k)
-            end
-            r
-          end
-
-          def ssh_command_line_nodasho_args
-            nodasho_options.flat_map do |option_name|
-              uri_query_value(option_name).if_present([]) do |option_value|
-                send("ssh_command_line_#{option_name.underscore}_args", option_value)
-              end
-            end
-          end
-
-          def nodasho_options
-            self.class.nodasho_options
-          end
-
-          def uri_query_value(name)
-            uri.query_values.if_present { |v| v[name] }
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env/identity_file.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/concern'
-require 'eac_ruby_utils/envs/ssh_env/dasho_options'
-require 'eac_ruby_utils/listable'
-require 'eac_ruby_utils/patches/object/if_present'
-
-module EacRubyUtils
-  module Envs
-    class SshEnv < ::EacRubyUtils::Envs::BaseEnv
-      module IdentityFile
-        extend ::ActiveSupport::Concern
-
-        included do
-          include ::EacRubyUtils::Envs::SshEnv::DashoOptions
-          add_nodasho_option('IdentityFile')
-        end
-
-        def ssh_command_line_identity_file_args(value)
-          ['-i', value]
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env/quiet.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/concern'
-require 'eac_ruby_utils/boolean'
-require 'eac_ruby_utils/envs/ssh_env/dasho_options'
-
-module EacRubyUtils
-  module Envs
-    class SshEnv < ::EacRubyUtils::Envs::BaseEnv
-      module Quiet
-        extend ::ActiveSupport::Concern
-
-        included do
-          include ::EacRubyUtils::Envs::SshEnv::DashoOptions
-          add_nodasho_option('Quiet')
-        end
-
-        def ssh_command_line_quiet_args(value)
-          ::EacRubyUtils::Boolean.parse(value) ? ['-q'] : []
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env/terminal.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support/concern'
-require 'eac_ruby_utils/envs/ssh_env/dasho_options'
-require 'eac_ruby_utils/listable'
-require 'eac_ruby_utils/patches/object/if_present'
-
-module EacRubyUtils
-  module Envs
-    class SshEnv < ::EacRubyUtils::Envs::BaseEnv
-      module Terminal
-        extend ::ActiveSupport::Concern
-
-        included do
-          include ::EacRubyUtils::Envs::SshEnv::DashoOptions
-          add_nodasho_option('Terminal')
-          include ::EacRubyUtils::Listable
-          lists.add_string :terminal_option, :auto, :disable, :enable, :force
-        end
-
-        def ssh_command_line_terminal_args(value)
-          self.class.lists.terminal_option.value_validate!(value)
-          case value
-          when TERMINAL_OPTION_AUTO then ENV['TERM'].present? ? %w[-t] : []
-          when TERMINAL_OPTION_DISABLE then ['-T']
-          when TERMINAL_OPTION_ENABLE then ['-t']
-          when TERMINAL_OPTION_FORCE then ['-tt']
-          else raise "Invalid conditional branch: #{value}"
-          end
-        end
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require 'addressable'
-require 'eac_ruby_utils/envs/base_env'
-require 'eac_ruby_utils/patches/object/if_present'
-require 'eac_ruby_utils/patches/module/require_sub'
-require 'net/ssh'
-require 'shellwords'
-
-module EacRubyUtils
-  module Envs
-    class SshEnv < ::EacRubyUtils::Envs::BaseEnv
-      require_sub __FILE__, include_modules: true
-
-      USER_PATTERN = /[a-z_][a-z0-9_-]*/.freeze
-      HOSTNAME_PATTERN = /[^@]+/.freeze
-      USER_HOSTNAME_PATTERN = /\A(?:(#{USER_PATTERN})@)?(#{HOSTNAME_PATTERN})\z/.freeze
-
-      class << self
-        def parse_uri(uri)
-          uri_by_url(uri) || uri_by_user_hostname(uri) || raise("URI has no SSH scheme: #{uri}")
-        end
-
-        private
-
-        def uri_by_url(url)
-          r = ::Addressable::URI.parse(url)
-          r.scheme == 'ssh' && r.host.present? ? r : nil
-        end
-
-        def uri_by_user_hostname(user_hostname)
-          m = USER_HOSTNAME_PATTERN.match(user_hostname)
-          m ? ::Addressable::URI.new(scheme: 'ssh', host: m[2], user: m[1]) : nil
-        rescue Addressable::URI::InvalidURIError
-          nil
-        end
-      end
-
-      attr_reader :uri
-
-      def initialize(uri)
-        super()
-        @uri = self.class.parse_uri(uri).freeze
-      end
-
-      delegate :to_s, to: :uri
-
-      def command_line(line)
-        "#{ssh_command_line} #{Shellwords.escape(line)}"
-      end
-
-      private
-
-      def ssh_command_line
-        (%w[ssh] +
-          %w[nodasho dasho port].flat_map { |m| send("ssh_command_line_#{m}_args") } +
-          [user_hostname_uri])
-          .map { |a| Shellwords.escape(a) }.join(' ')
-      end
-
-      def ssh_command_line_port_args
-        uri.port.if_present([]) do |v|
-          ['-p', v]
-        end
-      end
-
-      def user_hostname_uri
-        r = uri.host
-        r = "#{uri.user}@#{r}" if uri.user.present?
-        r
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/envs.rb

@@ -1,23 +0,0 @@
-# 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/sub/eac_ruby_utils/lib/eac_ruby_utils/fs/clearable_directory.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'fileutils'
-require 'pathname'
-
-module EacRubyUtils
-  module Fs
-    class ClearableDirectory < ::Pathname
-      CLEARABLE_BASENAME = '.clearable_directory'
-
-      def clear
-        validate_clearable
-        directory? ? clear_directory : clear_no_directory
-        mkpath
-        ::FileUtils.touch(clearable_note_file.to_path)
-        self
-      end
-
-      def clearable?
-        clearable_negate_message ? true : false
-      end
-
-      def clearable_negate_message
-        return if !exist? || empty?
-        return "Path \"#{self}\" exists, is not empty and is not a directory" unless directory?
-        return if clearable_note_file.exist?
-
-        "Directory \"#{self}\" is not empty and does not have a #{CLEARABLE_BASENAME} file"
-      end
-
-      def clearable_note_file
-        join(CLEARABLE_BASENAME)
-      end
-
-      def validate_clearable
-        message = clearable_negate_message
-        raise message if message
-      end
-
-      private
-
-      def clear_directory
-        children.each do |child|
-          if child.directory?
-            child.rmtree
-          elsif child.file?
-            child.unlink
-          end
-        end
-      end
-
-      def clear_no_directory
-        ::FileUtils.rm_rf(to_path)
-      end
-    end
-  end
-end

data/sub/eac_ruby_utils/lib/eac_ruby_utils/fs/extname.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module EacRubyUtils
-  module Fs
-    class << self
-      # A [File.extname] which find multiple extensions (Ex.: .tar.gz).
-      def extname(path, limit = -1)
-        recursive_extension(::File.basename(path), limit)
-      end
-
-      # Shortcut to +extname(2)+.
-      def extname2(path)
-        extname(path, 2)
-      end
-
-      private
-
-      def recursive_extension(basename, limit)
-        return '' if limit.zero?
-
-        m = /\A(.+)(\.[a-z][a-z0-9]*)\z/i.match(basename)
-        if m
-          "#{recursive_extension(m[1], limit - 1)}#{m[2]}"
-        else
-          ''
-        end
-      end
-    end
-  end
-end