eac_tools 0.83.0 → 0.84.1

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

@@ -2,8 +2,8 @@
 
 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)] }
+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

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

@@ -20,7 +20,7 @@ module Avm
         def commit_message
           r = class_name
           r += ': remove' unless path.file?
-          r + '.'
+          "#{r}."
         end
 
         def relative_path

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

@@ -2,7 +2,7 @@
 
 require 'eac_ruby_utils/core_ext'
 
-::EacRubyUtils.require_sub __FILE__
+EacRubyUtils.require_sub __FILE__
 
 module Avm
   module Scms
@@ -26,8 +26,8 @@ module Avm
 
           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(', ') + ')')
+              raise("Rule not find with key \"#{key}\" (Available: " \
+                    "#{RULES_CLASSES.flat_map(&:keys).join(', ')})")
           end
         end
       end

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

@@ -24,9 +24,15 @@ module Avm
       immutable_accessor :path, type: :array
 
       def to_s
-        self.class.name.demodulize + '[' +
-          %w[fixup message].map { |m| [m, send(m)] }.reject { |m| m[1].blank? }
-            .map { |m| m.join(': ') }.join(',') + ']'
+        "#{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

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

@@ -47,7 +47,7 @@ module Avm
 
       # @return [Hash<String, String>]
       def options
-        parsed.option.map { |v| v.split(OPTION_NAME_VALUE_SEPARATOR) }.to_h
+        parsed.option.to_h { |v| v.split(OPTION_NAME_VALUE_SEPARATOR) }
       end
 
       def target_path

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

@@ -28,7 +28,7 @@ module Avm
         def subs
           subs_paths_to_search
             .map { |sub_path| ::Avm::Registry.sources.detect_optional(sub_path, parent: self) }
-            .reject(&:blank?)
+            .compact_blank
             .sort_by { |sub| [sub.path] }
         end
 

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

@@ -57,12 +57,12 @@ module Avm
 
         def configured_enumerable_value_as_test_commands(value)
           configured_hash_value_as_test_commands(
-            value.each_with_index.map { |v, i| ["test_#{i}", v] }.to_h
+            value.each_with_index.to_h { |v, i| ["test_#{i}", v] }
           )
         end
 
         def configured_hash_value_as_test_commands(value)
-          value.map { |k, v| [k.to_s.strip, configuration_value_to_env_command(v)] }.to_h
+          value.to_h { |k, v| [k.to_s.strip, configuration_value_to_env_command(v)] }
         end
       end
     end

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

@@ -24,7 +24,7 @@ module Avm
 
         # @return [String]
         def id
-          "#{main? ? MAIN_SOURCE_ID : relative_path_from_main_source}\##{test_name}"
+          "#{main? ? MAIN_SOURCE_ID : relative_path_from_main_source}##{test_name}"
         end
 
         def main?

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

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

data/sub/avm/spec/lib/avm/applications/base/entries_spec.rb

@@ -2,7 +2,7 @@
 
 require 'avm/applications/base'
 
-RSpec.describe ::Avm::Applications::Base do
+RSpec.describe Avm::Applications::Base, '#entries' do
   include_examples 'entries_values', __FILE__, {
     'app0' => {
       'name' => 'Application 0',

data/sub/avm/spec/lib/avm/applications/base_spec.rb

@@ -2,12 +2,12 @@
 
 require 'avm/applications/base'
 
-RSpec.describe ::Avm::Applications::Base do
+RSpec.describe Avm::Applications::Base do
   let(:instance) { described_class.new('avm-tools') }
 
-  ::EacRubyUtils::Rspec
+  EacRubyUtils::Rspec
     .default_setup
-    .stub_eac_config_node(self, ::File.join(__dir__, 'base_spec_fixture.yml'))
+    .stub_eac_config_node(self, File.join(__dir__, 'base_spec_fixture.yml'))
 
   describe '#id' do
     it { expect(instance.id).to eq('avm-tools') }

data/sub/avm/spec/lib/avm/file_formats/base_spec.rb

@@ -2,7 +2,7 @@
 
 require 'avm/file_formats/base'
 
-::RSpec.describe ::Avm::FileFormats::Base do
+RSpec.describe Avm::FileFormats::Base do
   include_examples 'avm_file_format_file_resource_name', {
     'app/models/mynamespace/the_class.rb' => 'app/models/mynamespace/the_class.rb',
     'lib/ruby/lib/cliutils/eac_redmine_base0/activity.rb' =>

data/sub/avm/spec/lib/avm/instances/base_spec.rb

@@ -3,7 +3,7 @@
 require 'avm/instances/base'
 require 'avm/instances/entry_keys'
 
-RSpec.describe ::Avm::Instances::Base do
+RSpec.describe Avm::Instances::Base do
   it do
     expect(described_class.ancestors.map(&:name)).to(
       include('Avm::Instances::Base::Install')
@@ -12,76 +12,76 @@ RSpec.describe ::Avm::Instances::Base do
 
   include_examples 'entries_values', __FILE__, {
     'app_0' => {
-      ::Avm::Instances::EntryKeys::INSTALL_DATA_PATH => '/data_fs_root/app_0',
-      ::Avm::Instances::EntryKeys::INSTALL_PATH => '/fs_root/app_0',
-      ::Avm::Instances::EntryKeys::DATABASE_NAME => 'app_0',
-      ::Avm::Instances::EntryKeys::DATABASE_USERNAME => 'user1',
-      ::Avm::Instances::EntryKeys::DATABASE_PASSWORD => 'pass1',
-      ::Avm::Instances::EntryKeys::DATABASE_HOSTNAME => 'database.net',
-      ::Avm::Instances::EntryKeys::DATABASE_PORT => 5432,
-      ::Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'myhost.com',
-      ::Avm::Instances::EntryKeys::INSTALL_USERNAME => 'myuser',
-      ::Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'myuser',
-      ::Avm::Instances::EntryKeys::INSTALL_URL => 'ssh://otheruser@otherhost.com',
-      ::Avm::Instances::EntryKeys::WEB_URL => 'https://app0.net',
-      ::Avm::Instances::EntryKeys::WEB_PATH => ''
+      Avm::Instances::EntryKeys::INSTALL_DATA_PATH => '/data_fs_root/app_0',
+      Avm::Instances::EntryKeys::INSTALL_PATH => '/fs_root/app_0',
+      Avm::Instances::EntryKeys::DATABASE_NAME => 'app_0',
+      Avm::Instances::EntryKeys::DATABASE_USERNAME => 'user1',
+      Avm::Instances::EntryKeys::DATABASE_PASSWORD => 'pass1',
+      Avm::Instances::EntryKeys::DATABASE_HOSTNAME => 'database.net',
+      Avm::Instances::EntryKeys::DATABASE_PORT => 5432,
+      Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'myhost.com',
+      Avm::Instances::EntryKeys::INSTALL_USERNAME => 'myuser',
+      Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'myuser',
+      Avm::Instances::EntryKeys::INSTALL_URL => 'ssh://otheruser@otherhost.com',
+      Avm::Instances::EntryKeys::WEB_URL => 'https://app0.net',
+      Avm::Instances::EntryKeys::WEB_PATH => ''
     },
     'app_2' => {
-      ::Avm::Instances::EntryKeys::DATABASE_HOSTNAME => '127.0.0.1',
-      ::Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'myuser',
-      ::Avm::Instances::EntryKeys::SOURCE_INSTANCE_ID => 'app_dev'
+      Avm::Instances::EntryKeys::DATABASE_HOSTNAME => '127.0.0.1',
+      Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'myuser',
+      Avm::Instances::EntryKeys::SOURCE_INSTANCE_ID => 'app_dev'
     },
     'app_3' => {
-      ::Avm::Instances::EntryKeys::DATABASE_SYSTEM => 'postgresql',
-      ::Avm::Instances::EntryKeys::DATABASE_NAME => 'app_1_db',
-      ::Avm::Instances::EntryKeys::DATABASE_USERNAME => 'user1',
-      ::Avm::Instances::EntryKeys::DATABASE_PASSWORD => 'pass1',
-      ::Avm::Instances::EntryKeys::DATABASE_HOSTNAME => 'database.net',
-      ::Avm::Instances::EntryKeys::DATABASE_PORT => 5432,
-      ::Avm::Instances::EntryKeys::MAILER_ID => 'mailer_0',
-      ::Avm::Instances::EntryKeys::MAILER_FROM => 'noreply@example.net',
-      ::Avm::Instances::EntryKeys::MAILER_REPLY_TO => nil,
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_ADDRESS => 'smtp.example.net',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_PORT => '587',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_DOMAIN => 'example.net',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_USERNAME => 'a_user',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_PASSWORD => 'a_secret',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_AUTHENTICATION => 'plain',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_STARTTLS_AUTO => 'true'
+      Avm::Instances::EntryKeys::DATABASE_SYSTEM => 'postgresql',
+      Avm::Instances::EntryKeys::DATABASE_NAME => 'app_1_db',
+      Avm::Instances::EntryKeys::DATABASE_USERNAME => 'user1',
+      Avm::Instances::EntryKeys::DATABASE_PASSWORD => 'pass1',
+      Avm::Instances::EntryKeys::DATABASE_HOSTNAME => 'database.net',
+      Avm::Instances::EntryKeys::DATABASE_PORT => 5432,
+      Avm::Instances::EntryKeys::MAILER_ID => 'mailer_0',
+      Avm::Instances::EntryKeys::MAILER_FROM => 'noreply@example.net',
+      Avm::Instances::EntryKeys::MAILER_REPLY_TO => nil,
+      Avm::Instances::EntryKeys::MAILER_SMTP_ADDRESS => 'smtp.example.net',
+      Avm::Instances::EntryKeys::MAILER_SMTP_PORT => '587',
+      Avm::Instances::EntryKeys::MAILER_SMTP_DOMAIN => 'example.net',
+      Avm::Instances::EntryKeys::MAILER_SMTP_USERNAME => 'a_user',
+      Avm::Instances::EntryKeys::MAILER_SMTP_PASSWORD => 'a_secret',
+      Avm::Instances::EntryKeys::MAILER_SMTP_AUTHENTICATION => 'plain',
+      Avm::Instances::EntryKeys::MAILER_SMTP_STARTTLS_AUTO => 'true'
     },
     'app_4' => {
-      ::Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
-      ::Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host4.net',
-      ::Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user4',
-      ::Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'group4',
-      ::Avm::Instances::EntryKeys::INSTALL_URL => 'ssh://user4@host4.net'
+      Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
+      Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host4.net',
+      Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user4',
+      Avm::Instances::EntryKeys::INSTALL_GROUPNAME => 'group4',
+      Avm::Instances::EntryKeys::INSTALL_URL => 'ssh://user4@host4.net'
     },
     'app_5' => {
-      ::Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
-      ::Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host5.net',
-      ::Avm::Instances::EntryKeys::INSTALL_PORT => '2222',
-      ::Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user5',
-      ::Avm::Instances::EntryKeys::INSTALL_PASSWORD => 'passwd5',
-      ::Avm::Instances::EntryKeys::INSTALL_PATH => '/path/to/app5'
+      Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
+      Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host5.net',
+      Avm::Instances::EntryKeys::INSTALL_PORT => '2222',
+      Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user5',
+      Avm::Instances::EntryKeys::INSTALL_PASSWORD => 'passwd5',
+      Avm::Instances::EntryKeys::INSTALL_PATH => '/path/to/app5'
     },
     'app_6' => {
-      ::Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
-      ::Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host5.net',
-      ::Avm::Instances::EntryKeys::INSTALL_PORT => '2222',
-      ::Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user5',
-      ::Avm::Instances::EntryKeys::INSTALL_PASSWORD => 'passwd5',
-      ::Avm::Instances::EntryKeys::INSTALL_PATH => '/path/to/app5/app_6'
+      Avm::Instances::EntryKeys::INSTALL_SCHEME => 'ssh',
+      Avm::Instances::EntryKeys::INSTALL_HOSTNAME => 'host5.net',
+      Avm::Instances::EntryKeys::INSTALL_PORT => '2222',
+      Avm::Instances::EntryKeys::INSTALL_USERNAME => 'user5',
+      Avm::Instances::EntryKeys::INSTALL_PASSWORD => 'passwd5',
+      Avm::Instances::EntryKeys::INSTALL_PATH => '/path/to/app5/app_6'
     },
     'mailer_0' => {
-      ::Avm::Instances::EntryKeys::MAILER_FROM => 'noreply@example.net',
-      ::Avm::Instances::EntryKeys::MAILER_REPLY_TO => '',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_ADDRESS => 'smtp.example.net',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_PORT => '587',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_DOMAIN => 'example.net',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_USERNAME => 'a_user',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_PASSWORD => 'a_secret',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_AUTHENTICATION => 'plain',
-      ::Avm::Instances::EntryKeys::MAILER_SMTP_STARTTLS_AUTO => 'true'
+      Avm::Instances::EntryKeys::MAILER_FROM => 'noreply@example.net',
+      Avm::Instances::EntryKeys::MAILER_REPLY_TO => '',
+      Avm::Instances::EntryKeys::MAILER_SMTP_ADDRESS => 'smtp.example.net',
+      Avm::Instances::EntryKeys::MAILER_SMTP_PORT => '587',
+      Avm::Instances::EntryKeys::MAILER_SMTP_DOMAIN => 'example.net',
+      Avm::Instances::EntryKeys::MAILER_SMTP_USERNAME => 'a_user',
+      Avm::Instances::EntryKeys::MAILER_SMTP_PASSWORD => 'a_secret',
+      Avm::Instances::EntryKeys::MAILER_SMTP_AUTHENTICATION => 'plain',
+      Avm::Instances::EntryKeys::MAILER_SMTP_STARTTLS_AUTO => 'true'
     }
   }
 

data/sub/avm/spec/lib/avm/launcher/instances/base_spec.rb

@@ -3,33 +3,33 @@
 require 'avm/launcher/context'
 require 'avm/launcher/instances/base'
 
-RSpec.describe ::Avm::Launcher::Instances::Base do
+RSpec.describe Avm::Launcher::Instances::Base do
   let(:fixtures_dir) { __dir__.to_pathname.join('base_spec_files') }
   let(:launcher_context) do
-    ::Avm::Launcher::Context.current = ::Avm::Launcher::Context.new(
+    Avm::Launcher::Context.current = Avm::Launcher::Context.new(
       projects_root: fixtures_dir.join('projects').to_path,
       settings_file: fixtures_dir.join('settings.yaml').to_path,
-      cache_root: ::Dir.mktmpdir
+      cache_root: Dir.mktmpdir
     )
   end
 
   before do
-    allow(::ProgressBar).to receive(:create).and_return(double.as_null_object)
-    ::Avm::Launcher::Context.current = launcher_context
+    allow(ProgressBar).to receive(:create).and_return(double.as_null_object)
+    Avm::Launcher::Context.current = launcher_context
   end
 
   describe '#options' do
     context 'when instance is "avm-tools_stub"' do
-      let(:instance) { ::Avm::Launcher::Context.current.instance('/avm-tools_stub') }
+      let(:instance) { Avm::Launcher::Context.current.instance('/avm-tools_stub') }
 
       it { expect(instance).to be_a(described_class) }
       it { expect(instance.options.git_current_revision).to eq('origin/master') }
       it { expect(instance.options.git_publish_remote).to eq('publish') }
-      it { expect(instance.publishable?).to eq(true) }
+      it { expect(instance.publishable?).to be(true) }
     end
 
     context 'when instance is "ruby_gem_stub"' do
-      let(:instance) { ::Avm::Launcher::Context.current.instance('/ruby_gem_stub') }
+      let(:instance) { Avm::Launcher::Context.current.instance('/ruby_gem_stub') }
 
       before do
         instance.application.entry('publishable').write(false)
@@ -37,7 +37,7 @@ RSpec.describe ::Avm::Launcher::Instances::Base do
 
       it { expect(instance.options.git_current_revision).to eq('git_current_revision_setted') }
       it { expect(instance.options.git_publish_remote).to eq('git_publish_remote_setted') }
-      it { expect(instance.publishable?).to eq(false) }
+      it { expect(instance.publishable?).to be(false) }
     end
   end
 end

data/sub/avm/spec/lib/avm/launcher/instances/base_spec_files/projects/avm-tools_stub/avm-tools.gemspec

@@ -8,7 +8,7 @@ require 'avm/tools/version'
 # Describe your gem and declare its dependencies:
 Gem::Specification.new do |s|
   s.name        = 'avm/tools'
-  s.version     = ::Avm::Tools::VERSION
+  s.version     = Avm::Tools::VERSION
   s.authors     = ['Esquilo Azul Company']
   s.summary     = 'Utilities to deploy applications and libraries.'
   s.license     = 'MIT'

data/sub/avm/spec/lib/avm/launcher/instances/base_spec_files/projects/ruby_gem_stub/ruby_gem_stub.gemspec

@@ -8,7 +8,7 @@ require 'ruby_gem_stub/version'
 # Describe your gem and declare its dependencies:
 Gem::Specification.new do |s|
   s.name        = 'ruby_gem_stub'
-  s.version     = ::RubyGemStub::VERSION
+  s.version     = RubyGemStub::VERSION
   s.authors     = ['Esquilo Azul Company']
   s.summary     = 'Ruby gem stub for tests.'
   s.files = Dir['{lib}/**/*']

data/sub/avm/spec/lib/avm/patches/eac_config/entry_path_spec.rb

@@ -2,7 +2,7 @@
 
 require 'avm/patches/eac_config/entry_path'
 
-::RSpec.describe ::EacConfig::EntryPath do
+RSpec.describe EacConfig::EntryPath do
   {
     'install.path' => {
       auto: 'auto_install_path',

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

@@ -2,7 +2,7 @@
 
 require 'avm/scms/auto_commit/file_resource_name'
 
-RSpec.describe ::Avm::Scms::AutoCommit::FileResourceName, git: true do
+RSpec.describe Avm::Scms::AutoCommit::FileResourceName, :git do
   let(:git) { stubbed_git_local_repo }
 
   describe '#class_name' do

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

@@ -2,6 +2,6 @@
 
 require 'avm/scms/base'
 
-::RSpec.describe ::Avm::Scms::Base do
+RSpec.describe Avm::Scms::Base do
   include_examples 'not_in_avm_registry'
 end

data/sub/avm/spec/lib/avm/sources/base_spec.rb

@@ -2,6 +2,6 @@
 
 require 'avm/sources/base'
 
-::RSpec.describe ::Avm::Sources::Base do
+RSpec.describe Avm::Sources::Base do
   include_examples 'not_in_avm_registry'
 end

data/sub/avm/spec/lib/avm/sources/runner_spec.rb

@@ -2,7 +2,7 @@
 
 require 'avm/sources/runner'
 
-::RSpec.describe ::Avm::Sources::Runner do
+RSpec.describe Avm::Sources::Runner do
   it do
     expect { described_class.run(argv: %w[--help]) }.not_to raise_error
   end

data/sub/avm/spec/rubocop_spec.rb

@@ -1,3 +1,3 @@
 # frozen_string_literal: true
 
-::EacRubyUtils::Rspec.default_setup.describe_rubocop
+EacRubyUtils::Rspec.default_setup.describe_rubocop

data/sub/avm/spec/spec_helper.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 
 require 'eac_ruby_utils/rspec/default_setup'
-::EacRubyUtils::Rspec.default_setup_create(::File.expand_path('..', __dir__)).stub_avm_contexts
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__)).stub_avm_contexts

data/sub/avm-eac_asciidoctor_base0/avm-eac_asciidoctor_base0.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |s|
 
   s.add_dependency 'asciidoctor', '~> 2.0', '>= 2.0.20'
   s.add_dependency 'avm-eac_webapp_base0', '~> 0.18', '>= 0.18.2'
-  s.add_dependency 'eac_ruby_utils', '~> 0.119', '>= 0.119.2'
+  s.add_dependency 'eac_ruby_utils', '~> 0.120'
   s.add_dependency 'os', '~> 1.1', '>= 1.1.4'
   s.add_dependency 'rouge', '~> 3.30'
 

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/documents_owner.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/recursive_builder'
+
+module Avm
+  module EacAsciidoctorBase0
+    module DocumentsOwner
+      common_concern
+
+      # @param subpath [Pathname]
+      # @return [Avm::EacAsciidoctorBase0::Sources::Document]
+      # @raise [KeyError]
+      def document(subpath)
+        documents.find { |d| d.subpath.to_pathname == subpath.to_pathname } ||
+          raise(::KeyError, "Document not found with subáth = \"#{subpath}\"")
+      end
+
+      # @return [Enumerable<Avm::EacAsciidoctorBase0::Sources::Document>]
+      def documents
+        ::EacRubyUtils::RecursiveBuilder.new(root_document, &:children).result
+      end
+
+      # @return [Object]
+      def root_document
+        raise "Abstract method hit: #{__method__}"
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/build/document/body_target.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+require 'avm/eac_asciidoctor_base0/instances/macros'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Instances
+      class Build
+        class Document
+          module BodyTarget
+            common_concern
+
+            BODY_TARGET_BASENAME = 'index.html'
+
+            # Absolute path to the output of Asciidoctor's source file.
+            #
+            # @return [Pathname]
+            def body_target_path
+              build.target_directory.join(source_document.subpath).join(BODY_TARGET_BASENAME)
+            end
+
+            # @return [Asciidoctor::Document]
+            def body_target_write
+              ::Asciidoctor.convert(
+                pre_processed_body_source_content,
+                base_dir: convert_base_dir,
+                to_file: body_target_path.to_path, safe: :unsafe, mkdirs: true
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/build/document/media.rb

@@ -17,7 +17,7 @@ module Avm
             def media_target_path
               build.target_directory.join(
                 parent_document.present? ? source_document.subpath : '',
-                ::Avm::EacAsciidoctorBase0::Sources::Base::Document::Media::MEDIA_DIRECTORY_BASENAME
+                ::Avm::EacAsciidoctorBase0::Sources::Document::Media::MEDIA_DIRECTORY_BASENAME
               )
             end
           end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/build/document.rb

@@ -11,11 +11,10 @@ module Avm
         class Document
           require_sub __FILE__, include_modules: true
 
-          BODY_TARGET_BASENAME = 'index.html'
-
           enable_simple_cache
           enable_speaker
           common_constructor :build, :parent_document, :source_document
+          delegate :subpath, to: :source_document
 
           # @param other [Avm::EacAsciidoctorBase0::Instances::Build::Document]
           # @return [String]
@@ -32,22 +31,6 @@ module Avm
             end
           end
 
-          # Absolute path to the output of Asciidoctor's source file.
-          #
-          # @return [Pathname]
-          def body_target_path
-            build.target_directory.join(source_document.subpath).join(BODY_TARGET_BASENAME)
-          end
-
-          # @return [Asciidoctor::Document]
-          def build_body
-            ::Asciidoctor.convert(
-              pre_processed_body_source_content,
-              base_dir: convert_base_dir,
-              to_file: body_target_path.to_path, safe: :unsafe, mkdirs: true
-            )
-          end
-
           # @param basename [String]
           # @return [Avm::EacAsciidoctorBase0::Instances::Build::Document, nil]
           def child(basename)
@@ -85,7 +68,7 @@ module Avm
 
           def perform_self
             infov 'Building', source_document.subpath
-            build_body
+            body_target_write
             copy_media_directory
           end
 

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/build.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'avm/eac_asciidoctor_base0/documents_owner'
 require 'eac_ruby_utils/core_ext'
 require 'eac_ruby_utils/fs/clearable_directory'
 
@@ -8,6 +9,7 @@ module Avm
     module Instances
       class Build
         require_sub __FILE__
+        include ::Avm::EacAsciidoctorBase0::DocumentsOwner
         enable_speaker
         enable_simple_cache
         enable_listable

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

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 require 'avm/eac_webapp_base0/sources/base'
+require 'avm/eac_asciidoctor_base0/documents_owner'
+require 'avm/eac_asciidoctor_base0/instances/build'
+require 'avm/eac_asciidoctor_base0/sources/document'
 require 'avm/eac_asciidoctor_base0/sources/runners'
 require 'eac_ruby_utils/core_ext'
 
@@ -9,13 +12,20 @@ module Avm
     module Sources
       class Base < ::Avm::EacWebappBase0::Sources::Base
         require_sub __FILE__, include_modules: true
+        include ::Avm::EacAsciidoctorBase0::DocumentsOwner
 
         CONTENT_DIRECTORY_SUBPATH = ::Pathname.new('content')
         CONTENT_DOCUMENT_BASENAME = ::Pathname.new('body.adoc')
         MAIN_FILE_SUBPATH = CONTENT_DIRECTORY_SUBPATH.join(
-          ::Avm::EacAsciidoctorBase0::Sources::Base::Document::TITLE_BASENAME
+          ::Avm::EacAsciidoctorBase0::Sources::Document::TITLE_BASENAME
         )
 
+        # @param options [Hash]
+        # @return [Avm::EacAsciidoctorBase0::Instances::Build]
+        def build(options = {})
+          ::Avm::EacAsciidoctorBase0::Instances::Build.new(instance_to_build, options)
+        end
+
         def content_directory
           path.join(CONTENT_DIRECTORY_SUBPATH)
         end
@@ -25,9 +35,9 @@ module Avm
           ::Avm::EacAsciidoctorBase0::Sources::Base::InstanceToBuild.new(self)
         end
 
-        # @return [Avm::EacAsciidoctorBase0::Sources::Base::Document
+        # @return [Avm::EacAsciidoctorBase0::Sources::Document
         def root_document
-          ::Avm::EacAsciidoctorBase0::Sources::Base::Document.new(self, nil, nil)
+          ::Avm::EacAsciidoctorBase0::Sources::Document.new(self, nil, nil)
         end
 
         def valid?