eac_tools 0.113.0 → 0.113.1

data/sub/avm/lib/avm/sources/base/version_bump.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class Base
+      module VersionBump
+        # @return [Avm::Scms::Commit, nil]
+        def version_bump(target_version)
+          scm.commit_if_change(version_bump_commit_message(target_version)) do
+            version_bump_do_changes(target_version)
+            parent.if_present(&:on_sub_updated)
+          end
+        end
+
+        # @return [String]
+        def version_bump_commit_message(target_version)
+          i18n_translate(__method__, version: target_version, __locale: locale)
+        end
+
+        def version_bump_do_changes(_target_version)
+          raise_abstract_method(__method__)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class Base
+      require_sub __FILE__, include_modules: true
+      include ::Avm::With::ApplicationStereotype
+      include ::Avm::With::ExtraSubcommands
+
+      compare_by :path
+      enable_abstract_methods
+      enable_simple_cache
+      enable_listable
+      lists.add_symbol :option, :parent
+      common_constructor :path, :options, default: [{}] do
+        self.path = path.to_pathname.expand_path
+        self.options = ::Avm::Sources::Base.lists.option.hash_keys_validate!(options)
+      end
+
+      abstract_methods :valid?
+
+      # @param options [Hash<Symbol, Object>]
+      def completer(options = {})
+        scm.completer(options)
+      end
+
+      # @return [EacRubyUtils::Envs::LocalEnv]
+      def env
+        ::EacRubyUtils::Envs::LocalEnv.new
+      end
+
+      # @return [Pathname]
+      def relative_path
+        return path if parent.blank?
+
+        path.relative_path_from(parent.path)
+      end
+
+      def to_s
+        "#{self.class}[#{path}]"
+      end
+
+      # @return [Avm::VersionNumber, nil]
+      def version
+        raise_abstract __method__, 'Should return a Avm::VersionNumber or nil'
+      end
+
+      private
+
+      # @return [Avm::Scms::Base]
+      def scm_uncached
+        ::Avm::Registry.scms.detect_optional(path) || ::Avm::Scms::Null.new(path)
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/configuration/rubocop.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class Configuration < ::EacConfig::OldConfigs
+      module Rubocop
+        RUBOCOP_COMMAND_KEY = 'ruby.rubocop.command'
+        RUBOCOP_GEMFILE_KEY = 'ruby.rubocop.gemfile'
+
+        def rubocop_command
+          read_command(RUBOCOP_COMMAND_KEY)
+        end
+
+        def rubocop_gemfile
+          gemfile_path = read_entry(RUBOCOP_GEMFILE_KEY)
+          return nil if gemfile_path.blank?
+
+          gemfile_path = gemfile_path.to_pathname.expand_path(storage_path.parent)
+          return gemfile_path if gemfile_path.file?
+
+          raise "Gemfile path \"#{gemfile_path}\" does not exist or is not a file"
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/configuration.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Avm
+  module Sources
+    class Configuration < ::EacConfig::OldConfigs
+      require_sub __FILE__, include_modules: true
+
+      FILENAMES = %w[.avm.yml .avm.yaml].freeze
+
+      class << self
+        def find_by_path(path)
+          path = ::Pathname.new(path.to_s) unless path.is_a?(::Pathname)
+          internal_find_path(path.expand_path)
+        end
+
+        def find_in_path(path)
+          absolute_pathname = path.to_pathname.expand_path
+          if absolute_pathname.directory?
+            FILENAMES.each do |filename|
+              file = absolute_pathname.join(filename)
+              return new(file) if file.exist?
+            end
+          end
+          nil
+        end
+
+        def temp_instance
+          new(::Tempfile.new(['.avm', '.yaml']))
+        end
+
+        private
+
+        def internal_find_path(absolute_pathname)
+          r = find_in_path(absolute_pathname)
+          return r if r.present?
+
+          internal_find_path(absolute_pathname.dirname) unless absolute_pathname.root?
+        end
+      end
+
+      def initialize(path)
+        super(nil, storage_path: path)
+      end
+
+      # Utility to read a configuration as a [EacRubyUtils::Envs::Command].
+      # @return [EacRubyUtils::Envs::Command]
+      def read_command(key)
+        read_entry(key).if_present do |v|
+          args = v.is_a?(::Enumerable) ? v.map(&:to_s) : ::Shellwords.split(v)
+          ::EacRubyUtils::Envs.local.command(args).chdir(::File.dirname(storage_path))
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/issues/deliver.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'clipboard'
+
+module Avm
+  module Sources
+    module Issues
+      class Deliver
+        enable_simple_cache
+        enable_speaker
+
+        common_constructor :scm
+        delegate :head_branch, to: :scm
+
+        def run # rubocop:disable Naming/PredicateMethod
+          push
+          clipboard_copy_tracker_message
+          true
+        end
+
+        def start_banner
+          infov 'Branch ID', branch_id
+          infov 'Commit ID', branch_commit_id
+        end
+
+        private
+
+        def branch_commit_id
+          head_branch.head_commit.id
+        end
+
+        def branch_id
+          head_branch.id
+        end
+
+        def clipboard_copy_tracker_message
+          ::Clipboard.copy(textile_tracker_message)
+          infov 'Copied to clipboard', textile_tracker_message
+        end
+
+        def push
+          head_branch.push(scm.default_remote)
+        end
+
+        def textile_tracker_message
+          "#{branch_id}: commit:#{branch_commit_id}."
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/runner.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class Runner
+      runner_with :help, :subcommands do
+        desc 'Root command for sources.'
+        arg_opt '-C', '--path', 'Path to the source.', default: '.'
+        subcommands
+      end
+
+      for_context :optional_source, :source
+
+      def extra_available_subcommands
+        optional_source.if_present({}, &:extra_available_subcommands)
+      end
+
+      def source_banner
+        infov 'Source', source
+      end
+
+      # @return [Pathname]
+      def source_path
+        parsed.path.to_pathname
+      end
+
+      private
+
+      def source_uncached
+        ::Avm::Registry.sources.detect(source_path)
+      end
+
+      def optional_source_uncached
+        ::Avm::Registry.sources.detect_optional(source_path)
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/tests/builder.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    module Tests
+      class Builder
+        NO_TEST_TEST_NAME = 'no_test'
+
+        enable_immutable
+
+        immutable_accessor :include_main, :include_subs, type: :boolean
+        immutable_accessor :include_id, type: :array
+        common_constructor :main_source
+
+        def immutable_constructor_args
+          [main_source]
+        end
+
+        # @return [Avm::Sources::Tests::Performer]
+        def performer
+          ::Avm::Sources::Tests::Performer.new(self)
+        end
+
+        def selected_units
+          (select_units_from_subs + select_units_from_main + select_units_from_ids).sort.uniq
+        end
+
+        private
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def available_units
+          @available_units ||= ([main_source] + main_source.subs)
+                                 .flat_map { |a_source| create_source_units(a_source) }
+        end
+
+        def available_units_from_main
+          create_units([main_source])
+        end
+
+        def available_units_from_subs
+          create_units(main_source.subs)
+        end
+
+        # @return [Avm::Sources::Tests::Single]
+        def create_source_no_test_unit(source)
+          ::Avm::Sources::Tests::Single.new(self, source, NO_TEST_TEST_NAME,
+                                            source.env.command('true'))
+        end
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def create_source_units(source)
+          tests = source.test_commands
+          return create_source_no_test_unit(source) unless tests.any?
+
+          tests.map do |test_name, test_command|
+            ::Avm::Sources::Tests::Single.new(self, source, test_name, test_command)
+          end
+        end
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def create_units(sources)
+          sources.flat_map { |a_source| create_source_units(a_source) }
+        end
+
+        # @return [Avm::Sources::Tests::Single]
+        def create_units_by_id(source_id)
+          r = available_units.select { |unit| unit.source.relative_path.to_path == source_id.to_s }
+          return r if r.any?
+
+          raise ::ArgumentError, "Source not found with ID=#{source_id}" \
+                                 "(Available: #{available_units.map(&:id).join(', ')})"
+        end
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def select_units_from_ids
+          include_ids.flat_map { |source_id| create_units_by_id(source_id) }
+        end
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def select_units_from_main
+          include_main? ? available_units_from_main : []
+        end
+
+        # @return [Array<Avm::Sources::Tests::Single>]
+        def select_units_from_subs
+          include_subs? ? available_units_from_subs : []
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/tests/performer.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    module Tests
+      class Performer
+        enable_simple_cache
+
+        common_constructor(:owner)
+
+        def non_failed_units
+          units.reject(&:failed?)
+        end
+
+        def failed_units
+          units.select(&:failed?)
+        end
+
+        # @return [Boolean]
+        def successful?
+          failed_units.none?
+        end
+
+        protected
+
+        def units_uncached
+          owner.selected_units
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/tests/result.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    module Tests
+      class Result < ::EacCli::Enum
+        enum :failed, :red
+        enum :nonexistent, :white
+        enum :sucessful, :green
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/tests/single.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    module Tests
+      class Single
+        MAIN_SOURCE_ID = '#main'
+
+        compare_by :order_group, :id
+        enable_simple_cache
+        enable_speaker
+
+        common_constructor :builder, :source, :test_name, :test_command
+
+        delegate :to_s, to: :id
+
+        def failed?
+          result == ::Avm::Sources::Tests::Result::FAILED
+        end
+
+        # @return [String]
+        def id
+          "#{main? ? MAIN_SOURCE_ID : relative_path_from_main_source}##{test_name}"
+        end
+
+        def main?
+          relative_path_from_main_source.to_s == '.'
+        end
+
+        def order_group
+          main? ? 1 : 0
+        end
+
+        # @return [Pathname]
+        def relative_path_from_main_source
+          source.path.relative_path_from(builder.main_source.path)
+        end
+
+        private
+
+        # @return [EacFs::Logs]
+        def logs_uncached
+          ::EacFs::Logs.new.add(:stdout).add(:stderr)
+        end
+
+        # @return [Avm::Sources::Tests::Result]
+        def result_uncached
+          if test_command.blank?
+            ::Avm::Sources::Tests::Result::NONEXISTENT
+          elsif run_test_command
+            ::Avm::Sources::Tests::Result::SUCESSFUL
+          else
+            ::Avm::Sources::Tests::Result::FAILED
+          end
+        end
+
+        def run_test_command
+          execute_command_and_log(test_command)
+        end
+
+        # @return [true, false]
+        def execute_command_and_log(command) # rubocop:disable Naming/PredicateMethod
+          r = command.execute
+          logs[:stdout].write(r[:stdout])
+          logs[:stderr].write(r[:stderr])
+          r[:exit_code].zero?
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/sources/update_error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class UpdateError < ::RuntimeError
+    end
+  end
+end

data/sub/avm/lib/avm/sync.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Avm
+  class Sync
+    attr_reader :excludes, :includes
+
+    common_constructor :source_path, :target_path do
+      self.source_path = source_path.to_pathname
+      self.target_path = target_path.to_pathname
+      @excludes = []
+      @includes = []
+    end
+
+    def run
+      clear_target
+      copy
+    end
+
+    def add_exclude(exclude)
+      excludes << exclude
+
+      self
+    end
+
+    def add_excludes(*excludes)
+      excludes.each { |exclude| add_exclude(exclude) }
+
+      self
+    end
+
+    def add_include(include)
+      includes << include
+
+      self
+    end
+
+    def add_includes(*includes)
+      includes.each { |include| add_include(include) }
+
+      self
+    end
+
+    def move_mode(value)
+      @move_mode = value
+
+      self
+    end
+
+    def move_mode?
+      @move_mode ? true : false
+    end
+
+    private
+
+    def clear_target
+      target_remove(target_path)
+      target_path.children.each { |tchild| target_remove(tchild) }
+    end
+
+    def copy
+      source_path.children.each do |schild|
+        ::FileUtils.cp_r(schild.to_path, target_path.to_path)
+        schild.rmtree if move_mode?
+      end
+    end
+
+    def source_to_target_path(source_path)
+      source_path.relative_path_from(self.source_path).expand_path(target_path)
+    end
+
+    def target_remove(tpath)
+      if tpath.directory?
+        tpath.children.each { |tchild| target_remove(tchild) }
+        tpath.rmdir if tpath.children.empty?
+      elsif tpath.file? && !skip_target_path?(tpath)
+        tpath.unlink
+      end
+    end
+
+    def skip_target_path?(tpath)
+      skip_path?(tpath.relative_path_from(target_path))
+    end
+
+    def skip_path?(relpath)
+      relpath = relpath.expand_path('/')
+      excludes.any? { |exclude| relpath.fnmatch?(exclude) } &&
+        includes.none? { |include| relpath.fnmatch?(include) }
+    end
+  end
+end

data/sub/avm/lib/avm/version.rb

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

data/sub/avm/lib/avm/version_number.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Avm
+  # A sequence of segments of integer versions (Ex.: 2, 1.0.1, 3.0.0.0.0).
+  class VersionNumber
+    include ::Comparable
+
+    SEGMENT_SEPARATOR = '.'
+
+    class << self
+      def segments_from_mixed(segments)
+        (segments.is_a?(::Enumerable) ? segments.to_a : segments.to_s.split(SEGMENT_SEPARATOR))
+          .map(&:to_i)
+      end
+    end
+
+    attr_reader :segments
+
+    def initialize(segments)
+      @segments = self.class.segments_from_mixed(segments).freeze
+    end
+
+    delegate :[], to: :segments
+
+    def <=>(other)
+      segments <=> other.segments
+    end
+
+    def to_s
+      segments.join(SEGMENT_SEPARATOR)
+    end
+
+    # @return [Avm::Version]
+    def increment_segment(segment_index)
+      x = [segments.count, segment_index + 1].max.times.map do |index|
+        value = index < segments.count ? segments[index] : 0
+        next value if index < segment_index
+        next value + 1 if index == segment_index
+
+        0
+      end
+      self.class.new x
+    end
+  end
+end

data/sub/avm/lib/avm/with/application_stereotype.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Avm
+  module With
+    module ApplicationStereotype
+      common_concern
+
+      module ClassMethods
+        # @return [Avm::ApplicationStereotype::Base]
+        def application_stereotype
+          @application_stereotype ||=
+            ::Avm::Registry.application_stereotypes.detect(application_stereotype_name)
+        end
+
+        # @return [String]
+        def application_stereotype_name
+          stereotype_namespace_module.name.demodulize
+        end
+
+        # @return [Module]
+        def stereotype_namespace_module
+          module_parent.module_parent
+        end
+      end
+
+      delegate :stereotype_namespace_module, to: :class
+    end
+  end
+end

data/sub/avm/lib/avm/with/extra_subcommands.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Avm
+  module With
+    module ExtraSubcommands
+      # @return [Hash<String, EacCli::Runner>]
+      def extra_available_subcommands
+        extra_available_subcommands_from_runners_module
+      end
+
+      # @return [Hash<String, EacCli::Runner>]
+      def extra_available_subcommands_from_runners_module
+        self.class.ancestors.reverse.inject({}) do |a, e|
+          a.merge(RunnersFromModule.new(e).result)
+        end
+      end
+
+      class RunnersFromModule
+        enable_simple_cache
+        common_constructor :the_module
+
+        # @return [Hash<String, EacCli::Runner>]
+        def result
+          return {} if runners_module.blank?
+
+          ::EacCli::RunnerWith::Subcommands.subcommands_from_module(runners_module)
+        end
+
+        def runners_module_uncached
+          return nil if the_module.module_parent.blank?
+
+          begin
+            the_module.module_parent.const_get('Runners')
+          rescue ::NameError
+            nil
+          end
+        end
+      end
+    end
+  end
+end