avm 0.4.0 → 0.7.0

data/lib/avm/instances/base/auto_values/mailer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entry'
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Mailer
+          ::Avm::Instances::EntryKeys.all.select { |c| c.to_s.start_with?('mailer.') }
+                                     .reject { |c| c == ::Avm::Instances::EntryKeys::MAILER_ID }
+                                     .each do |mailer_key|
+            define_method ::Avm::Instances::Entry.auto_value_method_name(mailer_key) do
+              mailer_auto_common(mailer_key)
+            end
+          end
+
+          def auto_mailer_id
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID,
+                                  ::Avm::Instances::EntryKeys::MAILER_ID) ||
+              read_entry_optional(::Avm::Instances::EntryKeys::HOST_ID)
+          end
+
+          private
+
+          def mailer_auto_common(mailer_key)
+            inherited_entry_value(::Avm::Instances::EntryKeys::MAILER_ID, mailer_key)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/ruby.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Ruby
+          def auto_ruby_version
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ruby.version')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/source.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Source
+          def auto_source_instance_id
+            "#{application.id}_dev"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/system.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'addressable'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module System
+          def auto_system_username
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'system.username') ||
+              read_entry_optional('ssh.username')
+          end
+
+          def auto_system_groupname
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'system.groupname') ||
+              read_entry_optional('system.username')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/web.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'addressable'
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Web
+          def auto_web_authority
+            web_url_as_uri(&:authority)
+          end
+
+          def auto_web_hostname
+            web_url_as_uri(&:host)
+          end
+
+          def auto_web_path
+            web_url_as_uri(&:path)
+          end
+
+          def auto_web_port
+            web_url_as_uri(&:port)
+          end
+
+          def auto_web_scheme
+            web_url_as_uri(&:scheme)
+          end
+
+          def auto_web_userinfo
+            web_url_as_uri(&:userinfo)
+          end
+
+          private
+
+          def web_url_as_uri
+            read_entry_optional(::Avm::Instances::EntryKeys::WEB_URL).if_present do |v|
+              yield(::Addressable::URI.parse(v))
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub(__FILE__)
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        extend ::ActiveSupport::Concern
+
+        included do
+          %w[Access Admin Data Database Filesystem Mailer Ruby Source System Web]
+            .each do |class_name|
+            include const_get(class_name)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/dockerizable.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'eac_docker/executables'
+require 'eac_ruby_utils/core_ext'
+require 'avm/docker/container'
+
+module Avm
+  module Instances
+    class Base
+      module Dockerizable
+        enable_simple_cache
+        attr_reader :docker_image_options
+
+        def docker_image_options=(options)
+          @docker_image_options = ::ActiveSupport::HashWithIndifferentAccess.new(options)
+          reset_cache
+        end
+
+        def docker_container_exist?
+          ::EacDocker::Executables.docker.command.append(
+            ['ps', '-qaf', "name=#{docker_container_name}"]
+          ).execute!.present?
+        end
+
+        def docker_container_name
+          id
+        end
+
+        private
+
+        def docker_container_uncached
+          ::Avm::Docker::Container.new(self)
+        end
+
+        def docker_image_uncached
+          r = docker_image_class.new(docker_image_options.fetch(:registry))
+          r.instance = self if r.respond_to?(:instance)
+          r.version = docker_image_options[:version] if docker_image_options.key?(:version)
+          r.snapshot = docker_image_options[:snapshot] if docker_image_options.key?(:snapshot)
+          r
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/entry_keys.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module EntryKeys
+        ::Avm::Instances::EntryKeys.all.each do |key|
+          method_name = key.to_s.variableize
+          define_method method_name do
+            read_entry(key)
+          end
+
+          define_method "#{method_name}_optional" do
+            read_entry(key, required: false)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+require 'eac_ruby_utils/simple_cache'
+require 'avm/instances/entries'
+
+module Avm
+  module Instances
+    class Base
+      enable_listable
+      enable_simple_cache
+      require_sub __FILE__, include_modules: true
+      include ::Avm::Instances::Entries
+
+      lists.add_string :access, :local, :ssh
+
+      ID_PATTERN = /\A([a-z0-9]+(?:\-[a-z0-9]+)*)_(.+)\z/.freeze
+
+      class << self
+        def by_id(id)
+          application_id, suffix = parse_id(id)
+          require 'avm/instances/application'
+          new(::Avm::Instances::Application.new(application_id), suffix)
+        end
+
+        private
+
+        def parse_id(id)
+          m = ID_PATTERN.match(id)
+          return [m[1], m[2]] if m
+
+          raise "ID Pattern no matched: \"#{id}\""
+        end
+      end
+
+      common_constructor :application, :suffix do
+        self.suffix = suffix.to_s
+      end
+
+      def id
+        "#{application.id}_#{suffix}"
+      end
+
+      def to_s
+        id
+      end
+
+      def host_env_uncached
+        access = read_entry(:access, list: ::Avm::Instances::Base.lists.access.values)
+        case access
+        when 'local' then ::EacRubyUtils::Envs.local
+        when 'ssh' then ::EacRubyUtils::Envs.ssh(read_entry('ssh.url'))
+        else raise("Unmapped access value: \"#{access}\"")
+        end
+      end
+
+      private
+
+      def source_instance_uncached
+        ::Avm::Instances::Base.by_id(source_instance_id)
+      end
+    end
+  end
+end

data/lib/avm/instances/entries.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'avm/instances/entry'
+
+module Avm
+  module Instances
+    module Entries
+      def entry(suffix, options = {})
+        ::Avm::Instances::Entry.new(self, suffix, options)
+      end
+
+      def path_prefix
+        @path_prefix ||= [id].freeze
+      end
+
+      def read_entry(entry_suffix, options = {})
+        entry(entry_suffix, options).value
+      end
+
+      def read_entry_optional(entry_suffix, options = {})
+        entry(entry_suffix, options).optional_value
+      end
+
+      def full_entry_path(entry_suffix)
+        unless entry_suffix.is_a?(::Array)
+          entry_suffix = ::EacConfig::PathsHash.parse_entry_key(entry_suffix.to_s)
+        end
+        (path_prefix + entry_suffix).join('.')
+      end
+
+      def inherited_entry_value(source_entry_suffix, target_entry_suffix, &block)
+        read_entry_optional(source_entry_suffix).if_present do |instance_id|
+          other_entry_value(instance_id, target_entry_suffix).if_present(&block)
+        end
+      end
+
+      def other_entry_value(instance_id, entry_suffix)
+        ::Avm::Instances::Base.by_id(instance_id).read_entry_optional(entry_suffix)
+      end
+    end
+  end
+end

data/lib/avm/instances/entry.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'eac_config/node'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Instances
+    class Entry
+      class << self
+        def auto_value_method_name(suffix)
+          "auto_#{suffix.to_s.gsub('.', '_')}"
+        end
+      end
+
+      common_constructor :parent, :suffix, :options
+
+      def auto_value
+        parent.respond_to?(auto_value_method, true) ? parent.send(auto_value_method) : nil
+      end
+
+      def auto_value_method
+        self.class.auto_value_method_name(suffix)
+      end
+
+      def full_path
+        (parent.path_prefix + suffix_as_array).join('.')
+      end
+
+      def optional_value
+        read(required: false, noinput: true) || auto_value
+      end
+
+      def read(extra_options = {})
+        ::EacConfig::Node.context.current.entry(full_path, options.merge(extra_options)).value
+      end
+
+      def suffix_as_array
+        if suffix.is_a?(::Array)
+          suffix.dup
+        else
+          ::EacConfig::PathsHash.parse_entry_key(suffix.to_s)
+        end
+      end
+
+      def value
+        optional_value || read
+      end
+
+      def write(value)
+        ::EacConfig::Node.context.current.entry(full_path).value = value
+      end
+    end
+  end
+end

data/lib/avm/instances/entry_keys.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Instances
+    module EntryKeys
+      class << self
+        def all
+          all_keys.to_a
+        end
+
+        def keys_consts_set(prefix, suffixes)
+          if suffixes.is_a?(::Hash)
+            keys_consts_set_from_hash(prefix, suffixes)
+          elsif suffixes.is_a?(::Enumerable)
+            keys_consts_set_from_enum(prefix, suffixes)
+          else
+            raise "Unmapped suffixes class: #{suffixes.class}"
+          end
+        end
+
+        def key_const_set(prefix, suffix)
+          key = [prefix, suffix].reject(&:blank?).join('.')
+          const_set(key.gsub('.', '_').upcase, key)
+          all_keys << key
+        end
+
+        private
+
+        def all_keys
+          @all_keys ||= ::Set.new
+        end
+
+        def keys_consts_set_from_enum(prefix, suffixes)
+          suffixes.each { |suffix| key_const_set(prefix, suffix) }
+        end
+
+        def keys_consts_set_from_hash(prefix, suffixes)
+          suffixes.each { |k, v| keys_consts_set(prefix.to_s + (k.blank? ? '' : ".#{k}"), v) }
+        end
+      end
+
+      {
+        '' => %w[fs_path host_id source_instance_id],
+        database: %w[id hostname limit name password port system timeout username],
+        docker: %w[registry],
+        mailer: {
+          '' => %w[id from reply_to],
+          smtp: %w[address port domain username password authentication starttls_auto]
+        },
+        ssh: %w[hostname port url username],
+        web: %w[authority hostname path port scheme url userinfo]
+      }.each { |prefix, suffixes| keys_consts_set(prefix, suffixes) }
+    end
+  end
+end

data/lib/avm/instances/runner.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Instances
+    class Runner
+      class << self
+        def instance_class
+          ::Avm.const_get(stereotype_name).const_get('Instance')
+        end
+
+        def stereotype_module
+          ::Avm.const_get(stereotype_name)
+        end
+
+        def stereotype_name
+          name.demodulize
+        end
+      end
+
+      description = "Utilities for #{stereotype_name} instances."
+      runner_with :help, :subcommands do
+        desc description
+        pos_arg 'instance-id'
+        subcommands
+      end
+
+      delegate :instance_class, :stereotype_module, :stereotype_name, to: :class
+
+      private
+
+      def instance_uncached
+        self.class.instance_class.by_id(parsed.instance_id)
+      end
+    end
+  end
+end

data/lib/avm/instances.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    require 'avm/instances/application'
+    require 'avm/instances/entries'
+  end
+end

data/lib/avm/jobs/base.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'avm/jobs/variables_source'
+require 'avm/result'
 require 'eac_cli/core_ext'
 
 module Avm

data/lib/avm/path_string.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/object/blank'
+
+module Avm
+  # String with paths like PATH variable.
+  # Note: the separator is not system dependent.
+  class PathString < String
+    SEPARATOR = ':'
+
+    class << self
+      # Shortcut for [Avm::Paths.new(string).paths].
+      def paths(string)
+        new(string).paths
+      end
+    end
+
+    def initialize(string = nil)
+      super(string.to_s)
+    end
+
+    # @return [Array] List of paths. Blank paths are rejected.
+    def paths
+      split(SEPARATOR).reject(&:blank?)
+    end
+  end
+end

data/lib/avm/registry/base.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/gems_registry'
+
+module Avm
+  module Registry
+    class Base
+      enable_simple_cache
+      common_constructor :module_suffix
+
+      def detect(*registered_initialize_args)
+        detect_optional(*registered_initialize_args) ||
+          raise("No registered module valid for #{registered_initialize_args}" \
+            " (Module suffix: #{module_suffix})")
+      end
+
+      def detect_optional(*registered_initialize_args)
+        registered_modules.lazy.map { |klass| klass.new(*registered_initialize_args) }
+                          .find(&:valid?)
+      end
+
+      def provider_module_suffix
+        "#{module_suffix}::Provider"
+      end
+
+      def single_module_suffix
+        "#{module_suffix}::Base"
+      end
+
+      def to_s
+        "#{self.class}[#{module_suffix}]"
+      end
+
+      def valid_registered_module?(a_module)
+        a_module.is_a?(::Class) && !a_module.abstract?
+      end
+
+      private
+
+      def registered_modules_uncached
+        (single_registered_modules + provider_registered_modules)
+          .select { |v| valid_registered_module?(v) }.uniq.sort_by { |s| [s.name] }
+      end
+
+      def single_registered_modules
+        single_instance_registry.registered.map(&:registered_module)
+      end
+
+      def provider_registered_modules
+        provider_registry.registered.map(&:registered_module).flat_map do |provider_class|
+          provider_class.new.all
+        end
+      end
+
+      def single_instance_registry_uncached
+        ::EacRubyUtils::GemsRegistry.new(single_module_suffix)
+      end
+
+      def provider_registry_uncached
+        ::EacRubyUtils::GemsRegistry.new(provider_module_suffix)
+      end
+    end
+  end
+end

data/lib/avm/registry.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/gems_registry'
+
+module Avm
+  module Registry
+    require_sub __FILE__
+    enable_listable
+    lists.add_symbol :category, :instance_stereotypes, :runners, :scms, :source_stereotypes
+
+    class << self
+      enable_simple_cache
+
+      # @return [Array<Avm::Registry::Base>]
+      def registries
+        lists.category.values.map { |c| send(c) }
+      end
+
+      private
+
+      ::Avm::Registry.lists.category.each_value do |category|
+        define_method "#{category}_uncached" do
+          ::Avm::Registry::Base.new(category.to_s.camelize)
+        end
+      end
+    end
+  end
+end

data/lib/avm/rspec/setup.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Rspec
+    module Setup
+      def self.extended(obj)
+        obj.setup_in_avm_registry_example
+        obj.setup_not_in_avm_registry_example
+      end
+
+      def setup_in_avm_registry_example
+        require 'avm/rspec/shared_examples/in_avm_registry'
+      end
+
+      def setup_not_in_avm_registry_example
+        require 'avm/rspec/shared_examples/not_in_avm_registry'
+      end
+    end
+  end
+end

data/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/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.registered_modules).not_to include(described_class)
+      end
+    end
+  end
+end

data/lib/avm/{app_src.rb → rspec.rb}

@@ -3,7 +3,7 @@
 require 'eac_ruby_utils/core_ext'
 
 module Avm
-  module AppSrc
+  module Rspec
     require_sub __FILE__
   end
 end