avm 0.100.0 → 0.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 071671b3172d72c37010555f7b88c4df4969064292aac64626f2ee37feca5b6a
-  data.tar.gz: ec13d8885f0c503ae7a7a2663629145c9bb8504e1946aee11f78141f5a7e5b28
+  metadata.gz: 99407bebdd63f7fd32b138edfbf95863e96981e71869347f131d0f2c9606e97c
+  data.tar.gz: d64bb5cc8c2ff3f71e59d780857b6b2caf6489de5d10d079db317c4e72177679
 SHA512:
-  metadata.gz: 5a9872da111a879b1cc808da267ac5c446c3d67adab21a5b0ef497f6d8f9ada5b783b3d6c0896e288cfd93a51cc6df0227f6d36d9f83a50957c00887fecdbef1
-  data.tar.gz: b81a15f8fb665c9176cda13618169620b56db25a507b531788b950269f60df4b8d47d5c922ce03de5024b18de6136f25d607246c329f406d65fa7cc51c6f25d8
+  metadata.gz: 30374386114f387940c698961897a1e2e365331786b94b072afc8fe16d7b8ac729aed5be8213dc163d9449729b3bd11049b9f361c54414517d62bccf7051f4de
+  data.tar.gz: c94c7b7953feadc9b9c86968eb6db2e4d3aeae4183351309c33bf54ba0bf43907a57a0ee9498b5f16bb58861003663bc6b14ff93d920e9f8c24245896042a75c

data/lib/avm/entries/base/uri_components_entries_values/generic_component.rb

@@ -31,8 +31,8 @@ module Avm
             end
           end
 
-          def define_inherited_value_proc_method(&block)
-            entries_provider_class.define_method(inherited_value_proc_name, &block)
+          def define_inherited_value_proc_method(&)
+            entries_provider_class.define_method(inherited_value_proc_name, &)
           end
 
           def entry_key_path

data/lib/avm/instances/base.rb

@@ -14,7 +14,7 @@ module Avm
 
       lists.add_string :access, :local, :ssh
 
-      ID_PATTERN = /\A([a-z0-9]+(?:-[a-z0-9]+)*)_(.+)\z/.freeze
+      ID_PATTERN = /\A([a-z0-9]+(?:-[a-z0-9]+)*)_(.+)\z/
 
       class << self
         def by_id(id)

data/lib/avm/instances/ids.rb

@@ -4,7 +4,7 @@ module Avm
   module Instances
     module Ids
       ID_PARTS_SEPARATOR = '_'
-      ID_PATTERN = /\A([a-z0-9]+(?:-[a-z0-9]+)*)_(.+)\z/.freeze
+      ID_PATTERN = /\A([a-z0-9]+(?:-[a-z0-9]+)*)_(.+)\z/
       ID_PARSER = ID_PATTERN.to_parser do |m|
         ::Struct.new(:application_id, :instance_suffix).new(m[1], m[2])
       end

data/lib/avm/launcher/context/instance_discovery/root_source_wrappers.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'ruby-progressbar'
+
+module Avm
+  module Launcher
+    class Context
+      class InstanceDiscovery
+        class RootSourceWrappers
+          acts_as_instance_method
+          enable_speaker
+
+          common_constructor :owner
+
+          # @return [Enumerable<Avm::Launcher::Context::InstanceDiscovery::SourceWrapper>]
+          def result
+            owner.root_sources.map do |source|
+              ::Avm::Launcher::Context::InstanceDiscovery::SourceWrapper.new(
+                owner,
+                ::Avm::Launcher::Paths::Logical.new(
+                  owner.context, nil, source.to_path, "/#{source.basename}"
+                ),
+                nil
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/launcher/context/instance_discovery/{root_instance_paths.rb → root_sources.rb}

@@ -6,7 +6,7 @@ module Avm
   module Launcher
     class Context
       class InstanceDiscovery
-        class RootInstancePaths
+        class RootSources
           acts_as_instance_method
           enable_speaker
 
@@ -14,36 +14,33 @@ module Avm
 
           # @return [Array<Avm::Launcher::Paths::Logical>]
           def result
-            application_user_local_source_paths.map do |path|
-              ::Avm::Launcher::Paths::Logical.new(owner.context, nil, path.to_path,
-                                                  "/#{path.basename}")
-            end
+            ::Avm::Registry.applications.available.sort_by { |a| [a.id] }.map do |application|
+              application_source(application)
+            end.compact_blank.uniq.sort
           end
 
-          private
+          protected
 
           # @param application [Avm::Applications::Base]
           # @return [Pathname, nil]
-          def application_user_local_source_path(application) # rubocop:disable Metrics/MethodLength
+          def application_source(application) # rubocop:disable Metrics/MethodLength
             if application.user_local_source_path.blank?
               warn "Application \"#{application}\" does not have a user local source set"
               nil
             elsif application.user_local_source_path.directory?
               infov application,
-                    "user local source found in \"#{application.user_local_source_path}"
-              application.user_local_source_path
+                    "user local source found in \"#{application.user_local_source_path}\""
+              begin
+                application.user_local_source_path
+              rescue ::Avm::Registry::DetectionError => e
+                warn "Application \"#{application}\"'s detection raised the error #{e}"
+                nil
+              end
             else
               warn "Application \"#{application}\"'s local source path is not a directory"
               nil
             end
           end
-
-          # @return [Array<Pathname>]
-          def application_user_local_source_paths
-            ::Avm::Registry.applications.available.sort_by { |a| [a.id] }.map do |application|
-              application_user_local_source_path(application)
-            end.compact_blank.uniq.sort
-          end
         end
       end
     end

data/lib/avm/launcher/context/instance_discovery/source_wrapper.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'ruby-progressbar'
+
+module Avm
+  module Launcher
+    class Context
+      class InstanceDiscovery
+        class SourceWrapper
+          enable_memoized
+          enable_speaker
+
+          common_constructor :owner, :logical_path, :parent_project
+
+          # @return [Avm::Launcher::Instances::Base, nil]
+          def parent_project_for_sub
+            self_project.presence || parent_project
+          end
+
+          # @return [Enumerable<Avm::Launcher::Instances::Base>]
+          def projects
+            self_project.if_present([]) { |v| [v] } +
+              subs.flat_map(&:projects)
+          end
+
+          # @return [Avm::Launcher::Instances::Base, nil]
+          memoize def self_project
+            return nil unless logical_path.project?
+
+            infov logical_path, logical_path.real
+            ::Avm::Launcher::Instances::Base.instanciate(logical_path,
+                                                         parent_project)
+          end
+
+          # @param sub [Avm::Sources::base]
+          # @return [Avm::Launcher::Context::InstanceDiscovery::SourceWrapper]
+          def sub_wrapper(sub)
+            ::Avm::Launcher::Context::InstanceDiscovery::SourceWrapper.new(
+              owner,
+              logical_path.build_child(sub.relative_path),
+              parent_project_for_sub
+            )
+          end
+
+          # @return [Enumerable<Avm::Launcher::Instances::Base>]
+          def subs
+            warped_source.subs.map { |sub| sub_wrapper(sub) }
+          rescue StandardError => e
+            warn("#{logical_path}: #{e}")
+            []
+          end
+
+          # @return [Avm::Sources::Base]
+          memoize def warped_source
+            ::Avm::Registry.sources.detect(logical_path.warped)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/launcher/context/instance_discovery.rb

@@ -17,33 +17,7 @@ module Avm
 
         # @return [Array<Avm::Launcher::Instances::Base>]
         def instances_uncached
-          root_instance_paths.flat_map { |path| path_instances(path, nil) }
-        end
-
-        # @param path [Avm::Launcher::Paths::Logical]
-        # @param parent_instance [Avm::Launcher::Instances::Base]
-        # @return [Array<Avm::Launcher::Instances::Base>]
-        def path_instances(path, parent_instance)
-          on_rescued_path_instances(path) do |r|
-            if path.project?
-              parent_instance = ::Avm::Launcher::Instances::Base.instanciate(path, parent_instance)
-              r << path
-            end
-            children = path.children
-            r.concat(children.flat_map { |c| path_instances(c, parent_instance) })
-          end
-        end
-
-        # @param path [Avm::Launcher::Paths::Logical]
-        # @return [Array<Avm::Launcher::Instances::Base>]
-        def on_rescued_path_instances(path)
-          r = []
-          begin
-            yield(r) if path.included?
-          rescue StandardError => e
-            warn("#{path}: #{e}")
-          end
-          r
+          root_source_wrappers.flat_map(&:projects)
         end
 
         require_sub __FILE__, require_mode: :kernel

data/lib/avm/launcher/paths/logical.rb

@@ -31,6 +31,17 @@ module Avm
           stereotypes.any?
         end
 
+        # @param name [String]
+        # @return [Avm::Launcher::Paths::Logical]
+        def build_child(name)
+          ::Avm::Launcher::Paths::Logical.new(
+            context,
+            self,
+            ::File.join(warped, name),
+            ::File.join(logical, name)
+          )
+        end
+
         def children
           r = []
           Dir.entries(warped).each do |c|
@@ -53,15 +64,6 @@ module Avm
           ::Avm::Launcher::Stereotype.stereotypes.select { |s| s.match?(self) } # rubocop:disable Style/SelectByRegexp
         end
 
-        def build_child(name)
-          ::Avm::Launcher::Paths::Logical.new(
-            context,
-            self,
-            ::File.join(warped, name),
-            ::File.join(logical, name)
-          )
-        end
-
         def warped_uncached
           if is_a?(::Avm::Launcher::Instances::Base)
             stereotypes.each do |s|

data/lib/avm/registry/with_path.rb

@@ -23,8 +23,8 @@ module Avm
 
       attr_accessor :cache
 
-      def on_cache(&block)
-        cache.present? ? on_cache_with_cache(&block) : on_cache_with_no_cache(&block)
+      def on_cache(&)
+        cache.present? ? on_cache_with_cache(&) : on_cache_with_no_cache(&)
       end
 
       def on_cache_with_cache(&block)

data/lib/avm/rspec/launcher_controller.rb

@@ -17,6 +17,19 @@ module Avm
           path.to_pathname.to_path
       end
 
+      # @param repos [Avm::Git::Launcher::Base]
+      # @param subpath [String]
+      # @param content [String]
+      def commit_file(repos, subpath, content)
+        require 'fileutils'
+        repos.subpath(subpath).then do |file_path|
+          FileUtils.mkdir_p(File.dirname(file_path))
+          ::File.write(file_path, content)
+          repos.execute!('add', file_path)
+          repos.execute!('commit', '-m', subpath)
+        end
+      end
+
       # @param settings_path [Pathname]
       # @param projects_root [Pathname]
       def context_set(settings_path, projects_root)
@@ -79,12 +92,10 @@ module Avm
         '../../../template/avm/rspec/launcher_controller'.to_pathname.expand_path(__dir__)
       end
 
+      # @param repos [Avm::Git::Launcher::Base]
+      # @param subpath [String]
       def touch_commit(repos, subpath)
-        require 'fileutils'
-        FileUtils.mkdir_p(File.dirname(repos.subpath(subpath)))
-        FileUtils.touch(repos.subpath(subpath))
-        repos.execute!('add', repos.subpath(subpath))
-        repos.execute!('commit', '-m', subpath)
+        commit_file(repos, subpath, '')
       end
     end
   end

data/lib/avm/rspec/shared_examples/with_launcher.rb

@@ -5,9 +5,9 @@ RSpec.shared_context 'with_launcher' do
 
   before do
     Avm::Launcher::Context.current = launcher_controller.new_context
-    launcher_controller.remotes_dir = Dir.mktmpdir
+    launcher_controller.remotes_dir = temp_dir
   end
 
-  delegate :application_source_path, :context_set, :init_git, :init_remote, :temp_context,
-           :projects_root, :projects_root=, :touch_commit, to: :launcher_controller
+  delegate :application_source_path, :commit_file, :context_set, :init_git, :init_remote,
+           :temp_context, :projects_root, :projects_root=, :touch_commit, to: :launcher_controller
 end

data/lib/avm/scms/inflector.rb

@@ -10,7 +10,7 @@ module Avm
       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_PATTERN = /\A#{Regexp.quote(ISSUE_POINTER_NAME_PREFIX)}(\d+)\z/
       POINTER_NAME_TO_ISSUE_PARSER = POINTER_NAME_TO_ISSUE_PATTERN.to_parser { |m| m[1] }
 
       # @return [String, nil]

data/lib/avm/source_generators/option_list.rb

@@ -8,8 +8,8 @@ module Avm
 
       alias immutable_option option
 
-      def option(*args)
-        immutable_option(::Avm::SourceGenerators::Option.new(*args))
+      def option(*)
+        immutable_option(::Avm::SourceGenerators::Option.new(*))
       end
 
       # @return [Hash<Symbol, String>]

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

@@ -6,8 +6,8 @@ module Avm
       module Testing
         DEFAULT_TEST_COMMANDS = {}.freeze
         TEST_KEY = 'test'
-        TEST_COMMAND_KEY = "#{TEST_KEY}.command"
-        TEST_COMMANDS_KEY = "#{TEST_KEY}.commands"
+        TEST_COMMAND_KEY = "#{TEST_KEY}.command".freeze
+        TEST_COMMANDS_KEY = "#{TEST_KEY}.commands".freeze
 
         def configured_test_command
           read_configuration_as_env_command(TEST_COMMAND_KEY)

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

@@ -4,32 +4,60 @@ module Avm
   module Sources
     class Base
       module Update
+        common_concern do
+          enable_speaker
+        end
+
         # To override in subclasses.
         def on_sub_updated
           # Do nothing
         end
 
+        # @return [void]
         def update
-          update_self
+          update_self_before_subs
           update_subs
+          update_self_after_subs
         end
 
-        def update_self
-          scm.commit_if_change(-> { update_self_commit_message }) do
-            update_self_content
-            parent.if_present(&:on_sub_updated)
-          end
+        # @param changes [Enumerable<Avm::Sources::Change>]
+        # @return [void]
+        def update_self(changes)
+          changes.each { |change| update_self_with_change(change) }
         end
 
-        # Update source self content.
-        #
-        # To override in subclasses.
-        def update_self_content
-          # Do nothing
+        # @return [void]
+        def update_self_after_subs
+          infov __method__, self
+          update_self(update_self_changes_after_subs)
+        end
+
+        # @return [void]
+        def update_self_before_subs
+          infov __method__, self
+          update_self(update_self_changes_before_subs)
+        end
+
+        # Changes for update after subs' updating.
+        # @return [Enumerable<Avm::Sources::Change>]
+        def update_self_changes_after_subs
+          []
         end
 
-        def update_self_commit_message
-          i18n_translate(__method__)
+        # Changes for update before subs' updating.
+        # @return [Enumerable<Avm::Sources::Change>]
+        def update_self_changes_before_subs
+          []
+        end
+
+        # @param change [Avm::Sources::Change]
+        # @return [void]
+        def update_self_with_change(change)
+          infov 'Performing change', change
+          scm.commit_if_change(-> { change.commit_message }) do
+            change.perform
+            parent.if_present(&:on_sub_updated)
+          end
         end
       end
     end

data/lib/avm/sources/change.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avm
+  module Sources
+    class Change
+      acts_as_abstract
+      common_constructor :source
+
+      # Message for the commit.
+      # @return [String]
+      def commit_message
+        i18n_translate(__method__)
+      end
+
+      # Apply the changes to the source.
+      # @return [void]
+      def perform
+        raise_abstract_method __method__
+      end
+    end
+  end
+end

data/lib/avm/version.rb

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

data/template/avm/rspec/launcher_controller/dummy/avm-tools_stub/avm-tools.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |s|
   s.license     = 'MIT'
 
   s.files = Dir['{exe,lib}/**/*', 'Gemfile', 'MIT-LICENSE', 'README.rdoc']
-  s.required_ruby_version = '>= 2.7.0'
+  s.required_ruby_version = '>= 3.2'
   s.bindir = 'exe'
   s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
 

data/template/avm/rspec/launcher_controller/dummy/ruby_gem_stub/ruby_gem_stub.gemspec

@@ -12,5 +12,5 @@ Gem::Specification.new do |s|
   s.authors     = ['Esquilo Azul Company']
   s.summary     = 'Ruby gem stub for tests.'
   s.files = Dir['{lib}/**/*']
-  s.required_ruby_version = '>= 2.7.0'
+  s.required_ruby_version = '>= 3.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: avm
 version: !ruby/object:Gem::Version
-  version: 0.100.0
+  version: 0.102.0
 platform: ruby
 authors:
 - Eduardo H. Bogoni
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-30 00:00:00.000000000 Z
+date: 2026-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eac_cli
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.46'
+        version: '0.47'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.46'
+        version: '0.47'
 - !ruby/object:Gem::Dependency
   name: eac_config
   requirement: !ruby/object:Gem::Requirement
@@ -61,7 +61,7 @@ dependencies:
         version: '0.20'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.20.1
+        version: 0.20.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -71,21 +71,21 @@ dependencies:
         version: '0.20'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.20.1
+        version: 0.20.2
 - !ruby/object:Gem::Dependency
   name: eac_ruby_utils
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.130'
+        version: '0.131'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.130'
+        version: '0.131'
 - !ruby/object:Gem::Dependency
   name: eac_templates
   requirement: !ruby/object:Gem::Requirement
@@ -132,14 +132,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.40'
+        version: '0.41'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.41.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.40'
+        version: '0.41'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.41.1
 - !ruby/object:Gem::Dependency
   name: avm-git
   requirement: !ruby/object:Gem::Requirement
@@ -166,20 +172,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: '0.13'
 description:
 email:
 executables: []
@@ -277,7 +277,9 @@ files:
 - lib/avm/launcher/context.rb
 - lib/avm/launcher/context/instance_collector.rb
 - lib/avm/launcher/context/instance_discovery.rb
-- lib/avm/launcher/context/instance_discovery/root_instance_paths.rb
+- lib/avm/launcher/context/instance_discovery/root_source_wrappers.rb
+- lib/avm/launcher/context/instance_discovery/root_sources.rb
+- lib/avm/launcher/context/instance_discovery/source_wrapper.rb
 - lib/avm/launcher/context/instance_manager.rb
 - lib/avm/launcher/context/instance_manager/cached_instance.rb
 - lib/avm/launcher/context/instance_manager/cached_instances.rb
@@ -382,6 +384,7 @@ files:
 - lib/avm/sources/base/update_sub.rb
 - lib/avm/sources/base/update_subs.rb
 - lib/avm/sources/base/version_bump.rb
+- lib/avm/sources/change.rb
 - lib/avm/sources/configuration.rb
 - lib/avm/sources/configuration/rubocop.rb
 - lib/avm/sources/issues/deliver.rb
@@ -418,7 +421,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="