eac_tools 0.117.2 → 0.117.4

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/macros/child_docs/document_builder.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Instances
+      module Macros
+        class ChildDocs < ::Avm::EacAsciidoctorBase0::Instances::Macros::Base
+          class DocumentBuilder
+            common_constructor :child_docs, :document, :depth, default: [0]
+            compare_by :title, :address
+
+            # @return [Pathname]
+            def address
+              root_document.href_to_other_body(document)
+            end
+
+            # @return [Array] Document's children mapped to document builders.
+            def children
+              document.children.map { |c| self.class.new(child_docs, c, depth + 1) }.sort
+            end
+
+            # @return [Boolean]
+            def lines_for_children?
+              child_docs.maximum_depth.negative? || child_docs.maximum_depth <= depth
+            end
+
+            # @return [String]
+            def link
+              "link:#{address}[#{title}]"
+            end
+
+            # @return [Array<String>]
+            def result
+              children.flat_map do |child|
+                r = [child.self_line]
+                r += child.result if lines_for_children?
+                r
+              end
+            end
+
+            # @return [Avm::EacAsciidoctorBase0::Instances::Build::Document]
+            def root_document
+              child_docs.document
+            end
+
+            # @return [String]
+            def self_line
+              "#{'*' * depth} #{link}"
+            end
+
+            # @return [String]
+            def title
+              document.source_document.title
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/macros/child_docs.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Instances
+      module Macros
+        class ChildDocs < ::Avm::EacAsciidoctorBase0::Instances::Macros::Base
+          DEFAULT_MAXIMUM_DEPTH = -1
+
+          # @return [Array<String>]
+          def result
+            document_builder_class.new(self, document).result
+          end
+
+          # @return [Integer]
+          def maximum_depth
+            arguments[0].if_present(DEFAULT_MAXIMUM_DEPTH, &:to_i)
+          end
+
+          private
+
+          # @return [Class]
+          def document_builder_class
+            ::Avm::EacAsciidoctorBase0::Instances::Macros::ChildDocs::DocumentBuilder
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/macros/default_body.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Instances
+      module Macros
+        class DefaultBody < ::Avm::EacAsciidoctorBase0::Instances::Macros::Base
+          RESULT_LINES = ['== Índice', '', '//#child_docs'].freeze
+
+          # @return [Array<String>]
+          def result
+            RESULT_LINES
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/instances/macros/todo.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Instances
+      module Macros
+        class Todo < ::Avm::EacAsciidoctorBase0::Instances::Macros::Base
+          RESULT_LINES = ['[.todo]#TODO#'].freeze
+
+          # @return [Array<String>]
+          def result
+            RESULT_LINES
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/logging/catcher.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Logging
+      class Catcher < ::SimpleDelegator
+        CATCH_LEVEL = ::Logger::ERROR
+        LOGGER_METHODS = %i[unknown fatal error warn info debug].freeze
+
+        class << self
+          # @param [String]
+          # @return [Integer]
+          def level_by_method(method_name)
+            ::Logger.const_get(method_name.to_s.underscore.upcase)
+          end
+
+          # @return [Hash<Symbol, Integer]
+          def methods_levels
+            LOGGER_METHODS.to_h { |method_name| [method_name, level_by_method(method_name)] }
+          end
+
+          def on
+            real_logger = ::Asciidoctor::LoggerManager.logger
+            begin
+              ::Asciidoctor::LoggerManager.logger = new(real_logger)
+              yield
+            ensure
+              ::Asciidoctor::LoggerManager.logger = real_logger
+            end
+          end
+        end
+
+        methods_levels.each do |method_name, level|
+          define_method method_name do |*args, &block|
+            __getobj__.send(method_name, *args, &block)
+            return unless level >= CATCH_LEVEL
+
+            raise ::Avm::EacAsciidoctorBase0::Logging::Error.new(level, *args, &block)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/logging/error.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Logging
+      class Error < ::RuntimeError
+        attr_reader :level
+
+        def initialize(level, *)
+          @level = level
+          super(*)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module SourceGenerators
+      class Base < ::Avm::SourceGenerators::Base
+        OPTIONS = {}.freeze
+
+        enable_speaker
+        enable_simple_cache
+
+        class << self
+          def option_list
+            OPTIONS.inject(super) { |a, e| a.option(*e) }
+          end
+        end
+
+        def perform
+          eac_template.apply(self, target_path)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      class Base
+        class InstanceToBuild
+          AUTHOR_EMAIL = 'author@local.net'
+          AUTHOR_NAME = 'Local Author'
+          AUTHOR_NAME_INITIALS = 'L.A.'
+
+          common_constructor :source
+
+          # @return [Struct]
+          def application
+            ::Struct.new(:local_source).new(source)
+          end
+
+          # @return [String]
+          def author_email
+            AUTHOR_EMAIL
+          end
+
+          # @return [String]
+          def author_name
+            AUTHOR_NAME
+          end
+
+          # @return [String]
+          def author_name_initials
+            AUTHOR_NAME_INITIALS
+          end
+
+          # @return [String]
+          def web_url
+            "file://#{source.path.expand_path.join('build', 'index.html')}"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      class Base
+        module Theme
+          CONFIGURATION_THEME_KEY = 'theme'
+          DEFAULT_THEME_DIRECTORY_SUBPATH = 'theme'
+          THEME_STYLESHEET_BASENAME = 'main.css'
+
+          # @param target_directory_path [Pathname]
+          def copy_theme_directory_to(target_directory_path)
+            target_directory_path.parent.mkpath
+            ::FileUtils.copy_entry(theme_directory, target_directory_path)
+          end
+
+          # @return [Pathname]
+          def default_theme_directory
+            path.join(DEFAULT_THEME_DIRECTORY_SUBPATH)
+          end
+
+          # @return [Pathname]
+          def theme_directory
+            theme_directory_by_configuration || default_theme_directory
+          end
+
+          # @return [Pathname]
+          def theme_directory_by_configuration
+            configuration_entry(CONFIGURATION_THEME_KEY).value.if_present do |v|
+              v.to_pathname.expand_path(path)
+            end
+          end
+
+          # @return [Pathname]
+          def theme_stylesheet_path
+            theme_directory.join(THEME_STYLESHEET_BASENAME)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    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::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
+
+        # @return [Avm::EacAsciidoctorBase0::Sources::Base::InstanceToBuild]
+        def instance_to_build
+          ::Avm::EacAsciidoctorBase0::Sources::Base::InstanceToBuild.new(self)
+        end
+
+        # @return [Avm::EacAsciidoctorBase0::Sources::Document
+        def root_document
+          ::Avm::EacAsciidoctorBase0::Sources::Document.new(self, nil, nil)
+        end
+
+        def valid?
+          path.join(MAIN_FILE_SUBPATH).file?
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/document/media.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      class Document
+        module Media
+          MEDIA_DIRECTORY_BASENAME = '_media'
+
+          def copy_media_directory_to(target_directory_path)
+            return unless media_directory.directory?
+
+            target_directory_path.parent.mkpath
+            ::FileUtils.copy_entry(media_directory, target_directory_path)
+          end
+
+          # @return [Pathname]
+          def media_directory
+            root_path.join(MEDIA_DIRECTORY_BASENAME)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/document/title.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      class Document
+        module Title
+          TITLE_BASENAME = 'title'
+
+          # @return [String]
+          def default_title
+            root_path.basename.to_s.humanize.split(/\s+/).map(&:upcase_first).join(' ')
+          end
+
+          # @return [String]
+          def title
+            title_path.exist? ? title_path.read.strip : default_title
+          end
+
+          # @return [Pathname]
+          def title_path
+            root_path.join(TITLE_BASENAME)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      class Document
+        enable_simple_cache
+        enable_speaker
+        require_sub __FILE__, include_modules: true
+        common_constructor :source, :parent_document, :basename
+
+        # Absolute path to the Asciidoctor file.
+        #
+        # @return [Pathname]
+        def body_path
+          root_path.join(
+            ::Avm::EacAsciidoctorBase0::Sources::Base::CONTENT_DOCUMENT_BASENAME
+          )
+        end
+
+        # @return [Avm::EacAsciidoctorBase0::Instances::Build::Document]
+        def build_document
+          source.build.document(subpath)
+        end
+
+        # Absolute path to the document's source root.
+        #
+        # @return [Pathname]
+        def root_path
+          source.content_directory.join(subpath)
+        end
+
+        # @return [Pathname]
+        def subpath
+          parent_document.if_present('.'.to_pathname) { |pd| pd.subpath.join(basename) }
+        end
+
+        # @return [String]
+        def to_s
+          subpath.to_path
+        end
+
+        private
+
+        def children_uncached
+          root_path.children.select(&:directory?)
+            .reject { |path| path.basename.to_path == MEDIA_DIRECTORY_BASENAME }
+            .map { |path| self.class.new(source, self, path.basename) }
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/runners/build.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'os'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        class Build
+          include ::Avm::EacAsciidoctorBase0::Sources::Runners::IgnoreErrorsOption
+
+          runner_with :help do
+            desc 'Build the project'
+            arg_opt '-d', '--target-dir', 'Directory to build'
+            bool_opt '--open', 'Show the result.'
+          end
+
+          private
+
+          # @return [Avm::EacAsciidoctorBase0::Instances::Build]
+          def build_uncached
+            source.build(target_directory: parsed.target_dir)
+          end
+
+          def default_target_directory
+            runner_context.call(:project).root.join('build')
+          end
+
+          def open
+            return unless parsed.open?
+
+            infom "Opening \"#{open_path}\"..."
+            ::EacRubyUtils::Envs.local.command(OS.open_file_command, open_path).system!
+          end
+
+          def open_path
+            build.root_document.body_target_path
+          end
+
+          # @return [void]
+          def run_without_rescue
+            start_banner
+            build.perform
+            open
+          end
+
+          def start_banner
+            runner_context.call(:source_banner)
+            infov 'Target directory', build.target_directory
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/runners/document/build.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'os'
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        class Document
+          class Build
+            include ::Avm::EacAsciidoctorBase0::Sources::Runners::IgnoreErrorsOption
+
+            runner_with :help do
+              bool_opt '-O', '--open'
+            end
+
+            protected
+
+            def run_without_rescue
+              %w[build open ending].each { |p| send("run_#{p}") }
+            end
+
+            private
+
+            def build_document_uncached
+              document.build_document
+            end
+
+            def run_build
+              build_document.perform_self
+            end
+
+            def run_ending
+              success 'Done'
+            end
+
+            def run_open
+              return unless parsed.open?
+
+              infov 'Opening', build_document.body_target_path
+              ::EacRubyUtils::Envs.local.command(OS.open_file_command,
+                                                 build_document.body_target_path).system!
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/runners/document.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        class Document
+          runner_with :help, :subcommands do
+            pos_arg :subpath
+            subcommands
+          end
+          delegate :subpath, to: :parsed
+          for_context :document, :subpath
+
+          private
+
+          # @return [Avm::EacAsciidoctorBase0::Sources::Document]
+          # @raise [KeyError]
+          def document_uncached
+            source.document(subpath)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/runners/documents.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        class Documents
+          runner_with :help
+
+          def run
+            infov 'Documents', documents.count
+            documents.each do |document|
+              infov '  * ', document
+            end
+          end
+
+          private
+
+          def documents_uncached
+            source.documents
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_asciidoctor_base0/lib/avm/eac_asciidoctor_base0/sources/runners/ignore_errors_option.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        module IgnoreErrorsOption
+          common_concern do
+            acts_as_abstract :run_without_rescue
+
+            include ::EacCli::Runner
+
+            runner_definition do
+              bool_opt '-g', '--ignore-errors'
+            end
+          end
+
+          # @return [Boolean]
+          delegate :ignore_errors?, to: :parsed
+
+          # @return [void]
+          def run
+            catcher_send { run_without_rescue }
+          rescue ::Avm::EacAsciidoctorBase0::Logging::Error => e
+            fatal_error e
+          end
+
+          protected
+
+          # @return [Proc]
+          def catcher_send(&block)
+            if ignore_errors?
+              block.call
+            else
+              ::Avm::EacAsciidoctorBase0::Logging::Catcher.on(&block)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    module Sources
+      module Runners
+        require_sub __FILE__
+      end
+    end
+  end
+end

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

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacAsciidoctorBase0
+    VERSION = '0.27.1'
+  end
+end