eac_tools 0.86.13 → 0.87.0

data/sub/avm/lib/avm/rspec/shared_examples/avm_source_generated.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'eac_fs/comparator'
+require 'eac_ruby_utils/core_ext'
+
+RSpec.shared_examples 'avm_source_generated' do |spec_file, stereotype, options = {}|
+  fixtures_dir = Pathname.new('base_spec_files').expand_path(File.dirname(spec_file))
+
+  fixtures_dir.children.select(&:directory?).each do |target_dir|
+    context "when target is \"#{target_dir.basename}\"" do
+      let(:source) { avm_source(stereotype, options.merge(target_basename: target_dir.basename)) }
+
+      it do
+        expect(fs_comparator.build(source.path)).to eq(fs_comparator.build(target_dir))
+      end
+    end
+  end
+
+  # @return [EacFs::Comparato]
+  def fs_comparator
+    EacFs::Comparator.new.rename_file('.gitignore', '_gitignore')
+  end
+end

data/sub/avm/lib/avm/rspec/shared_examples/entries_values.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+RSpec.shared_examples 'entries_values' do |spec_file, expected_values|
+  describe '#read_entry' do
+    config_path = spec_file.to_pathname
+    config_path = config_path.dirname.join("#{config_path.basename_noext}_files", 'config.yml')
+    EacRubyUtils::Rspec.default_setup.stub_eac_config_node(self, config_path)
+
+    expected_values.each do |instance_id, values|
+      values.each do |input, expected|
+        context "when a auto value is requested for \"#{instance_id}.#{input}\"" do
+          let(:instance) { described_class.by_id(instance_id) }
+
+          it ".entry('#{input}').value should return \"#{expected}\"" do
+            expect(instance.entry(input).value).to eq(expected)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/rspec/shared_examples/in_avm_registry.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'avm/registry'
+
+RSpec.shared_examples 'in_avm_registry' do |registry_method|
+  let(:avm_registry) { Avm::Registry.send(registry_method) }
+
+  it 'is in the avm registry' do
+    expect(avm_registry.registered_modules).to include(described_class)
+  end
+end

data/sub/avm/lib/avm/rspec/shared_examples/not_in_avm_registry.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'avm/registry'
+
+RSpec.shared_examples 'not_in_avm_registry' do |registry_method = nil|
+  registry_method.if_present(Avm::Registry.registries) { |v| [Avm::Registry.send(v)] }
+    .each do |registry|
+    context "when registry is #{registry}" do
+      it 'is not in the avm registry' do
+        expect(registry.available).not_to include(described_class)
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/rspec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Rspec
+    require_sub __FILE__
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Runners
+    class Base
+      enable_abstract_methods
+
+      class << self
+        def command_argument
+          stereotype_name.underscore.dasherize
+        end
+
+        def stereotype_name
+          name.split('::')[-3]
+        end
+      end
+
+      delegate :command_argument, :stereotype_name, to: :class
+
+      def to_s
+        stereotype_name
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/file_resource_name.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    module AutoCommit
+      class FileResourceName
+        require_sub __FILE__, include_modules: true
+        enable_simple_cache
+        common_constructor :source_root, :path do
+          self.source_root = source_root.to_pathname
+          self.path = path.to_pathname
+        end
+
+        def class_name
+          file_format.file_resource_name(relative_path)
+        end
+
+        def commit_message
+          r = class_name
+          r += ': remove' unless path.file?
+          "#{r}."
+        end
+
+        def relative_path
+          path.expand_path.relative_path_from(source_root.expand_path)
+        end
+
+        private
+
+        # @return [Avm::FileFormats::Base]
+        def file_format_uncached
+          ::Avm::Registry.file_formats.detect(path)
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/for_file.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require 'avm/scms/commit_info'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    module AutoCommit
+      class ForFile
+        enable_speaker
+        enable_simple_cache
+        enable_listable
+
+        common_constructor :scm, :path, :rules do
+          self.path = path.to_pathname.expand_path(scm.path)
+        end
+
+        COMMITS_SEARCH_INTERVAL = 'origin/master..HEAD'
+
+        def scm_relative_path
+          path.to_pathname.relative_path_from(scm.path)
+        end
+
+        def run
+          start_banner
+          run_commit || warn("No rule returned commit information for \"#{path}\"")
+        end
+
+        private
+
+        # @return [Boolean]
+        def changed?
+          scm.changed_files.any? { |cf| cf.path == scm_relative_path }
+        end
+
+        def commit_info_uncached
+          rules.lazy.map { |rule| rule.with_file(self).commit_info }.find(&:present?)
+            .if_present { |v| v.path(path) }
+        end
+
+        def start_banner
+          infov 'Path', path
+          infov '  Commits found', commits.count
+        end
+
+        def run_commit
+          return false if commit_info.blank?
+
+          infov '  Commit info', commit_info
+          if changed?
+            scm.run_commit(commit_info)
+            success '  Commited'
+          else
+            warn "  File \"#{path}\" unchanged"
+          end
+
+          true
+        end
+
+        def commits_uncached
+          scm.current_milestone_interval.commits
+            .select { |c| c.changed_files.include?(path.relative_path_from(scm.path)) }
+            .reject(&:fixup?).each_with_index
+            .map { |commit, index| CommitDelegator.new(commit, index) }
+        end
+
+        class CommitDelegator < ::SimpleDelegator
+          attr_reader :index
+
+          def initialize(commit, index)
+            super(commit)
+            @index = index
+          end
+
+          def position
+            index + 1
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/base.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'avm/scms/commit_info'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class Base
+          class << self
+            def keys
+              [long_key, short_key]
+            end
+
+            def long_key
+              name.demodulize.variableize
+            end
+
+            def short_key
+              long_key[0, 1]
+            end
+          end
+
+          def with_file(file)
+            self.class.const_get('WithFile').new(self, file)
+          end
+
+          class WithFile
+            common_constructor :rule, :file
+
+            def new_commit_info
+              ::Avm::Scms::CommitInfo.new
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/last.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'avm/scms/auto_commit/rules/base'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class Last < ::Avm::Scms::AutoCommit::Rules::Base
+          class WithFile < ::Avm::Scms::AutoCommit::Rules::Base::WithFile
+            def commit_info
+              file.commits.last.if_present { |v| new_commit_info.fixup(v) }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/manual.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'avm/scms/auto_commit/rules/base'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class Manual < ::Avm::Scms::AutoCommit::Rules::Base
+          class WithFile < ::Avm::Scms::AutoCommit::Rules::Base::WithFile
+            enable_speaker
+
+            SKIP_OPTION = 's'
+
+            def commit_info
+              return nil unless file.commits.any?
+
+              commits_banner
+              input('Which commit?', list: commits_by_position).if_present do |v|
+                new_commit_info.fixup(v)
+              end
+            end
+
+            def commits_banner
+              file.commits.each_with_index do |commit, _index|
+                infov "    #{commit.position}", commit
+              end
+              infov "    #{SKIP_OPTION}", 'skip'
+            end
+
+            def commits_by_position
+              (file.commits.map { |commit| [commit.position.to_s, commit] } + [[SKIP_OPTION, nil]])
+                .to_h
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/new.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'avm/scms/auto_commit/rules/base'
+require 'avm/scms/auto_commit/file_resource_name'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class New < ::Avm::Scms::AutoCommit::Rules::Base
+          class WithFile < ::Avm::Scms::AutoCommit::Rules::Base::WithFile
+            def auto_commit_path
+              ::Avm::Scms::AutoCommit::FileResourceName.new(file.scm.path, file.path)
+            end
+
+            def commit_info
+              new_commit_info.message(auto_commit_path.commit_message)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/nth.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'avm/scms/auto_commit/rules/base'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class Nth < ::Avm::Scms::AutoCommit::Rules::Base
+          SHORT_KEY = 't'
+
+          class << self
+            def short_key
+              SHORT_KEY
+            end
+          end
+
+          common_constructor :number do
+            self.number = number.to_i
+          end
+
+          class WithFile < ::Avm::Scms::AutoCommit::Rules::Base::WithFile
+            def commit_info
+              file.commits(number - 1).if_present { |v| new_commit_info.fixup(v) }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules/unique.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'avm/scms/auto_commit/rules/base'
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        class Unique < ::Avm::Scms::AutoCommit::Rules::Base
+          class WithFile < ::Avm::Scms::AutoCommit::Rules::Base::WithFile
+            def commit_info
+              return nil unless file.commits.count == 1
+
+              new_commit_info.fixup(file.commits.first)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit/rules.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+EacRubyUtils.require_sub __FILE__
+
+module Avm
+  module Scms
+    module AutoCommit
+      module Rules
+        RULES_CLASSES = %w[last manual new nth unique]
+                          .map { |key| ::Avm::Scms::AutoCommit::Rules.const_get(key.camelcase) }
+
+        class << self
+          # @return [Array<Avm::Scms::AutoCommit::Rules>]
+          def all
+            RULES_CLASSES
+          end
+
+          def parse(string)
+            parts = string.split(':')
+
+            klass = rule_class_by_key(parts.shift)
+            klass.new(*parts)
+          end
+
+          def rule_class_by_key(key)
+            RULES_CLASSES.find { |klass| klass.keys.include?(key) } ||
+              raise("Rule not find with key \"#{key}\" (Available: " \
+                    "#{RULES_CLASSES.flat_map(&:keys).join(', ')})")
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/auto_commit.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    module AutoCommit
+      require_sub __FILE__
+    end
+  end
+end

data/sub/avm/lib/avm/scms/base/branches.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Base
+      module Branches
+        # @param id [String]
+        # @return [Avm::Scms::Branch, nil]
+        def branch(id) # rubocop:disable Lint/UnusedMethodArgument
+          raise_abstract_method __method__
+        end
+
+        # @return [Avm::Scms::Branch]
+        def head_branch
+          raise_abstract_method __method__
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/base/commits.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Base
+      module Commits
+        # @return [Avm::Scms::Commit,NilClass]
+        def commit_if_change(_message = nil)
+          raise_abstract_method __method__
+        end
+
+        # @return [Avm::Scms::Commit]
+        def head_commit
+          raise_abstract_method __method__
+        end
+
+        # @param commit_to_reset [Avm::Scms::Commit]
+        # @param commit_info [Avm::Scms::CommitInfo]
+        # @return [Avm::Scms::Commit]
+        def reset_and_commit(_commit_to_reset, _commit_info)
+          raise_abstract_method __method__
+        end
+
+        # @param commit_info [Avm::Scms::CommitInfo]
+        # @return [Avm::Scms::Commit]
+        def run_commit(_commit_info)
+          raise_abstract_method __method__
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/base/milestones.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Base
+      module Milestones
+        # @return [Avm::Scms::Interval]
+        def current_milestone_interval
+          interval(current_milestone_base_commit, head_commit)
+        end
+
+        # @return [Avm::Scms::Commit]
+        def current_milestone_base_commit
+          raise_abstract_method __method__
+        end
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/base/remotes.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Base
+      module Branches
+        # @return [Avm::Scms::Remote]
+        def default_remote
+          raise_abstract_method __method__
+        end
+
+        # @param id [String]
+        # @return [Avm::Scms::Remote, nil]
+        def remote(id) # rubocop:disable Lint/UnusedMethodArgument
+          raise_abstract_method __method__
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'avm/with/application_stereotype'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Base
+      require_sub __FILE__, include_modules: true
+      enable_abstract_methods
+      enable_simple_cache
+      include ::Avm::With::ApplicationStereotype
+      abstract_methods :update, :valid?
+      common_constructor :path do
+        self.path = path.to_pathname
+      end
+
+      # @return [Avm::Scms::ChangedFile]
+      def changed_files
+        raise_abstract_method __method__
+      end
+
+      # @param options [Hash<Symbol, Object>]
+      def completer(options = {}) # rubocop:disable Lint/UnusedMethodArgument
+        raise_abstract_method __method__
+      end
+
+      # @return [Avm::Scms::Interval]
+      def interval(_from, _to)
+        raise_abstract_method __method__
+      end
+
+      def name
+        self.class.name.demodulize
+      end
+
+      # @return [Pathname]
+      def relative_path_from_parent_scm
+        parent_scm.if_present(nil) do |v|
+          path.relative_path_from(v.path)
+        end
+      end
+
+      # @return [Enumerable<Avm::Scms::Base>]
+      def subs
+        raise_abstract_method __method__
+      end
+
+      def to_s
+        name
+      end
+
+      private
+
+      # @return [Avm::Scms::Base]
+      def parent_scm_uncached
+        ::Avm::Registry.scms.detect_by_path_optional(path.parent)
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/branch.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Branch
+      acts_as_abstract
+
+      # @return [Avm::Scms::Commit]
+      def head_commit
+        raise_abstract_method __method__
+      end
+
+      # @return [String]
+      def id
+        raise_abstract_method __method__
+      end
+
+      # @param remote [Avm::Scms::Remote]
+      def push(remote) # rubocop:disable Lint/UnusedMethodArgument
+        raise_abstract_method __method__
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/changed_file.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class ChangedFile
+      enable_abstract_methods
+
+      # @return [Pathname]
+      def absolute_path
+        path.expand_path(scm.path)
+      end
+
+      # @return [Pathname]
+      def path
+        raise_abstract_method __method__
+      end
+
+      # @return [Avm::Scms::Base]
+      def scm
+        raise_abstract_method __method__
+      end
+    end
+  end
+end