eac_tools 0.91.1 → 0.92.0

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

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Commit
+      enable_abstract_methods
+
+      # @return [Array<Pathname>]
+      def changed_files
+        raise_abstract_method __method__
+      end
+
+      def deploy_to_env_path(_target_env, _target_path)
+        raise_abstract_method __method__
+      end
+
+      # @return [Boolean]
+      def fixup?
+        raise_abstract_method __method__
+      end
+
+      def id
+        raise_abstract_method __method__
+      end
+
+      # @param other [Avm::Scms::Commit]
+      # @return [Avm::Scms::Commit]
+      def merge_with(_other)
+        raise_abstract_method __method__
+      end
+
+      # @return [Array<Pathname>]
+      def no_scm_changed_files
+        changed_files.reject { |path| scm_file?(path) }
+      end
+
+      # @param new_message [String]
+      def reword(_new_message)
+        raise_abstract_method __method__
+      end
+
+      # @return [Array<Pathname>]
+      def scm_changed_files
+        changed_files.select { |path| scm_file?(path) }
+      end
+
+      # @param path [Pathname]
+      # @return [TrueClass,FalseClass]
+      def scm_file?(_path)
+        raise_abstract_method __method__
+      end
+
+      # @return [String]
+      def subject
+        raise_abstract_method __method__
+      end
+
+      # @return [String]
+      def to_s
+        "#{subject} [#{id}]"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class CommitInfo
+      class << self
+        # @param source [Avm::Scms::CommitInfo, String]
+        # @return [Avm::Scms::CommitInfo]
+        def assert(source)
+          return source if source.is_a?(self)
+          return new if source.nil?
+          return new.message(source) if source.is_a?(::String)
+          return assert(source.call) if source.is_a?(::Proc)
+
+          raise "Unmapped assertion for #{source.to_debug}"
+        end
+      end
+
+      enable_immutable
+
+      immutable_accessor :fixup, :message
+      immutable_accessor :path, type: :array
+
+      def to_s
+        "#{self.class.name.demodulize}[#{attributes_to_s}]"
+      end
+
+      private
+
+      # @return [String]
+      def attributes_to_s
+        %w[fixup message].map { |m| [m, send(m)] }.reject { |m| m[1].blank? }
+          .map { |m| m.join(': ') }.join(',')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avm
+  module Scms
+    class Inflector
+      class << self
+        def default_instance
+          @default_instance ||= new
+        end
+      end
+
+      ISSUE_POINTER_NAME_PREFIX = 'issue_'
+      POINTER_NAME_TO_ISSUE_PATTERN = /\A#{Regexp.quote(ISSUE_POINTER_NAME_PREFIX)}(\d+)\z/.freeze
+      POINTER_NAME_TO_ISSUE_PARSER = POINTER_NAME_TO_ISSUE_PATTERN.to_parser { |m| m[1] }
+
+      # @return [String, nil]
+      def pointer_name_to_issue_id(pointer_name)
+        POINTER_NAME_TO_ISSUE_PARSER.parse(pointer_name)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Interval
+      enable_abstract_methods
+
+      common_constructor :scm, :from, :to
+
+      # @return [Array<Avm::Scms::Commit>]
+      def commits
+        raise_abstract_method __method__
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/scms/null/commit.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'avm/scms/base'
+require 'avm/scms/commit'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Null < ::Avm::Scms::Base
+      class Commit < ::Avm::Scms::Commit
+        common_constructor :scm
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'avm/scms/base'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Null < ::Avm::Scms::Base
+      require_sub __FILE__
+
+      # @return [Avm::Scms::Null::Commit]
+      def head_commit
+        @head_commit ||= Avm::Scms::Null::Commit.new(self)
+      end
+
+      def update
+        # Do nothing
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Scms
+    class Remote
+      enable_abstract_methods
+    end
+  end
+end

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

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

data/sub/avm/lib/avm/self/docker_image.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'avm/docker/image'
+
+module Avm
+  module Self
+    class DockerImage < ::Avm::Docker::Image
+      def stereotype_tag
+        nil
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/self/instance/entry_keys.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Avm
+  module Self
+    class Instance < ::Avm::Instances::Base
+      module EntryKeys
+        DATA_DEFAULT_PATH = 'data.default_path'
+        DOCKER_REGISTRY_NAME = 'docker.registry.name'
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/self/instance.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'avm/instances/base'
+require 'avm/self/docker_image'
+require 'avm/self/instance/entry_keys'
+
+module Avm
+  module Self
+    class Instance < ::Avm::Instances::Base
+      DEFAULT_INSTANCE_ID = 'avm_self'
+
+      class << self
+        def default
+          @default ||= by_id(DEFAULT_INSTANCE_ID)
+        end
+      end
+
+      def docker_image_class
+        ::Avm::Self::DockerImage
+      end
+
+      def docker_registry
+        read_entry(::Avm::Self::Instance::EntryKeys::DOCKER_REGISTRY_NAME)
+      end
+
+      def docker_run_arguments
+        ['-e', "LOCAL_USER_ID=#{::Process.uid}"]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'avm/source_generators/option_list'
+require 'avm/with/application_stereotype'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module SourceGenerators
+    class Base
+      acts_as_abstract
+      enable_settings_provider
+      enable_speaker
+      include ::Avm::With::ApplicationStereotype
+
+      class << self
+        # @return [Avm::SourceGenerators::OptionList]
+        def option_list
+          Avm::SourceGenerators::OptionList.new
+        end
+      end
+
+      OPTION_NAME = 'name'
+      JOBS = [].freeze
+
+      common_constructor :target_path, :options, default: [{}] do
+        self.target_path = target_path.to_pathname
+        self.options = option_list.validate(options)
+      end
+
+      # @return [String]
+      def name
+        options[OPTION_NAME].if_present(target_path.basename.to_path)
+      end
+
+      # @return [Avm::SourceGenerators::OptionList]
+      def option_list
+        self.class.option_list
+      end
+
+      def perform
+        start_banner
+        assert_clear_directory
+        apply_template
+        perform_jobs
+      end
+
+      def assert_clear_directory
+        target_path.mkpath
+        raise "\"#{target_path}\" is not empty" if target_path.children.any?
+      end
+
+      def apply_template
+        root_template.apply(self, target_path)
+      end
+
+      def perform_jobs
+        setting_value(:jobs).each do |job|
+          infom "Generating #{job.humanize}..."
+          send("generate_#{job}")
+        end
+      end
+
+      # @return [void]
+      def start_banner
+        infov 'Target path', target_path
+        infov 'Application name', name
+      end
+
+      # @return [EacTemlates::Modules::Base]
+      def root_template
+        template
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/source_generators/option.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Avm
+  module SourceGenerators
+    class Option
+      common_constructor :name, :description, default: [nil] do
+        self.name = name.to_sym
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/source_generators/option_list.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'avm/source_generators/option'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module SourceGenerators
+    class OptionList
+      enable_immutable
+      immutable_accessor :option, type: :array
+
+      alias immutable_option option
+
+      def option(*args)
+        immutable_option(::Avm::SourceGenerators::Option.new(*args))
+      end
+
+      # @return [Hash<Symbol, String>]
+      def validate(options_hash)
+        options_hash.transform_keys { |k| validate_option(k) }
+      end
+
+      def validate_option(option_name)
+        option_name = option_name.to_sym
+
+        return option_name if options.any? { |option| option.name == option_name }
+
+        raise "No option found with name \"#{option_name}\""
+      end
+    end
+  end
+end

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

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'avm/registry'
+require 'eac_cli/core_ext'
+
+module Avm
+  module SourceGenerators
+    class Runner
+      OPTION_NAME_VALUE_SEPARATOR = ':'
+
+      runner_with :help do
+        arg_opt '-o', '--option', 'Option for generator.', repeat: true, optional: true
+        pos_arg :stereotype_name
+        pos_arg :target_path
+      end
+
+      def run
+        start_banner
+        generate
+      end
+
+      def generate
+        infom 'Generating...'
+        generator.perform
+        success "Source generated in \"#{generator.target_path}\""
+      end
+
+      # @return [String]
+      def help_extra_text
+        help_list_section('Stereotypes', ::Avm::Registry.source_generators.available
+          .map(&:application_stereotype_name))
+      end
+
+      def start_banner
+        infov 'Stereotype', stereotype_name
+        infov 'Target path', target_path
+        infov 'Generator', generator.class
+      end
+
+      def generator_uncached
+        ::Avm::Registry.source_generators
+          .detect_optional(stereotype_name, target_path, options) ||
+          fatal_error("No generator found for stereotype \"#{stereotype_name}\"")
+      end
+
+      delegate :stereotype_name, to: :parsed
+
+      # @return [Hash<String, String>]
+      def options
+        parsed.option.to_h { |v| v.split(OPTION_NAME_VALUE_SEPARATOR) }
+      end
+
+      def target_path
+        parsed.target_path.to_pathname
+      end
+    end
+  end
+end

data/sub/avm/lib/avm/source_generators.rb

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

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Sources
+    module AutoCommit
+      class ForFile
+        common_constructor :source, :path, :rules
+
+        delegate :run, to: :scm_auto_commit
+
+        # @return [Pathname]
+        def path_for_auto_commit
+          path.relative_path_from(source_for_auto_commit.path)
+        end
+
+        # @return [Avm::Scms::AutoCommit::ForFile]
+        def scm_auto_commit
+          ::Avm::Scms::AutoCommit::ForFile.new(source_for_auto_commit.scm, path_for_auto_commit,
+                                               rules)
+        end
+
+        # @return [Avm::Sources::Base]
+        def source_for_auto_commit
+          source.sub_for_path(path) || source
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'avm/applications/base'
+require 'eac_config/entry_path'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Sources
+    class Base
+      module Application
+        APPLICATION_NAME_KEY = 'application'
+
+        # @return [Avm::Applications::Base]
+        def application
+          @application ||= ::Avm::Applications::Base.new(application_id)
+        end
+
+        # @return [String]
+        def application_id
+          application_id_by_configuration || application_id_by_directory
+        end
+
+        # @return [String, nil]
+        def application_id_by_configuration
+          configuration.entry(APPLICATION_NAME_KEY).value
+        end
+
+        # @return [String]
+        def application_id_by_directory
+          path.basename.to_path.gsub(::EacConfig::EntryPath::PART_SEPARATOR, '-')
+            .gsub(/\A-+/, '').gsub(/-+\z/, '')
+        end
+      end
+    end
+  end
+end