eac_tools 0.111.1 → 0.112.0

data/sub/avm-eac_webapp_base0/spec/lib/avm/eac_webapp_base0/file_formats/xml_spec_files/xml_code.xml.target

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+To change this license header, choose License Headers in Project Properties.
+To change this template file, choose Tools | Templates
+and open the template in the editor.
+-->
+<root>
+  <a_tag>a Content</a_tag>
+</root>

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'avm/eac_webapp_base0/instances/base'
+
+RSpec.describe Avm::EacWebappBase0::Instances::Base do
+  let(:instance) { described_class.by_id('the-app_0') }
+
+  describe '#install_apache_resource_name' do
+    it { expect(instance.install_apache_resource_name).to eq(instance.id) }
+  end
+end

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

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'avm/eac_webapp_base0/sources/base'
+
+RSpec.describe Avm::EacWebappBase0::Sources::Base do
+  include_examples 'in_avm_registry', 'sources'
+end

data/sub/avm-eac_webapp_base0/spec/meta/rubocop_spec.rb

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

data/sub/avm-eac_webapp_base0/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'avm/eac_webapp_base0'
+require 'eac_ruby_gem_support'
+EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__)).stub_avm_contexts

data/sub/avm-eac_webapp_base0/template/avm/eac_webapp_base0/instances/apache_host/no_ssl.conf

@@ -0,0 +1,11 @@
+<VirtualHost *:80>
+  ServerName "%%WEB.HOSTNAME%%"
+  DocumentRoot "%%DOCUMENT_ROOT%%"
+  %%EXTRA_CONTENT%%
+
+  <Directory "%%DOCUMENT_ROOT%%">
+    Allow from all
+    Options -MultiViews
+    Require all granted
+%%DIRECTORY_EXTRA_CONFIG%%  </Directory>
+</VirtualHost>

data/sub/avm-eac_webapp_base0/template/avm/eac_webapp_base0/instances/apache_path/default.conf

@@ -0,0 +1,7 @@
+Alias "%%WEB.PATH%%" "%%DOCUMENT_ROOT%%"
+%%EXTRA_CONTENT%%
+<Directory "%%DOCUMENT_ROOT%%">
+  Allow from all
+  Options -MultiViews
+  Require all granted
+</Directory>

data/sub/avm-tools/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+local_gemfile = File.join(File.dirname(__FILE__), 'Gemfile.local')
+eval_gemfile local_gemfile if File.exist?(local_gemfile)

data/sub/avm-tools/README.textile

@@ -0,0 +1,28 @@
+h1. AVM Tools
+
+h2. Instance's entries suffixes
+
+|_. Name |_. Description |_. Default value |
+| admin.email | Admin's e-mail address | @host_id->admin.email@ |
+| admin.name | Admin's name | @host_id->admin.name@ |
+| access | *@local@* or *@ssh@* | @self->ssh.url ? 'ssh' : 'local'@ |
+| data_fs_path | path to instance's data root directory | @host_id->data_fs_path + '/' + self->id@ |
+| database.id | ID of instance to fetch database parameters | @nil@ |
+| database.limit | Limit of open database connections | @database.id->database.limit or 5 |
+| database.system | *@postgres@* or *@mysql@* or *@oracle@* | @nil@ |
+| database.hostname | hostname of database server | @database.id->database.hostname or host_id->database.hostname or '127.0.0.1'@ |
+| database.name | name of database | @database.id->database.name or self->id@ |
+| database.password | password to login in database | @database.id->database.password or host_id->database.password@ |
+| database.port | port of database server | @database.system->default_port@ |
+| database.timeout | Database connection timeout (In miliseconds) | @database.id->database.timeout or 5000 |
+| database.username | username to login in database | @database.id->database.username or host_id->database.username@ |
+| fs_path | path to instance's installation  | @host_id->fs_path + '/' + self->id@ |
+| host_id | ID of instace to fetch host parameters | @nil@ |
+| ssh.url | SSH URL to access instance's host | @host_id->ssh.url or self->ssh.username + '@' self->ssh.hostname@ |
+| ssh.hostname | SSH hostname to access instance's host | @host_id->ssh.hostname@ |
+| ssh.port | SSH port to access instance's host | '22' |
+| ssh.username | SSH username to access instance's host | @host_id->ssh.username@ |
+| system.group | Group of user that runs instance | @host_id->system.groupname or self->system.username@ |
+| system.username | Name of user that runs instance | @host_id->system.username or self->ssh.username@ |
+| web.url | Root URL to web interface | @nil@ |
+| web.hostname | Hostname of web interface | @web.url->hostname@ |

data/sub/avm-tools/avm-tools.gemspec

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'avm/tools/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'avm-tools'
+  s.version     = Avm::Tools::VERSION
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Tools for AVM.'
+
+  s.files = Dir['{exe,lib}/**/*', 'Gemfile']
+  s.bindir = 'exe'
+  s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+
+  s.required_ruby_version = '>= 2.7.0'
+
+  s.add_dependency 'avm', '~> 0.98', '>= 0.98.5'
+  s.add_dependency 'eac_ruby_base0', '~> 0.19', '>= 0.19.3'
+
+  s.add_development_dependency 'avm-git', '~> 0.21', '>= 0.21.2'
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.12', '>= 0.12.2'
+end

data/sub/avm-tools/exe/avm

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift("#{__dir__}/../lib")
+require 'avm/tools'
+Avm::Tools::Runner.run

data/sub/avm-tools/lib/avm/tools/core_ext.rb

@@ -0,0 +1 @@
+# frozen_string_literal: true

data/sub/avm-tools/lib/avm/tools/rspec/helpers/runner.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    module Rspec
+      module Helpers
+        module Runner
+          def avm_tools_runner_args_prefix
+            []
+          end
+
+          def avm_tools_runner_run(*argv)
+            Avm::Tools::Runner.run(argv: avm_tools_runner_args_prefix + argv)
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/rspec/setup.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    module Rspec
+      module Setup
+        extend ::ActiveSupport::Concern
+
+        SETUPS = %w[helpers].freeze
+
+        def self.extended(setup_obj)
+          SETUPS.each { |s| setup_obj.send("setup_#{s}") }
+        end
+
+        def setup_helpers
+          rspec_config.include ::Avm::Tools::Rspec::Helpers::Runner
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/application/info.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Application
+        class Info
+          APPLICATION_PROPERTIES = {
+            id: 'ID',
+            name: 'Name',
+            organization: 'Organization',
+            scm: 'SCM',
+            stereotype: 'Stereotype'
+          }.freeze
+
+          runner_with :help, :output_item do
+            desc 'Show information about application.'
+          end
+
+          def run
+            run_output
+          end
+
+          # @return [Hash]
+          def item_hash
+            APPLICATION_PROPERTIES.inject({}) do |a, e|
+              a.merge(e.last => application.send(e.first).to_s)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/application.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Application
+        runner_with :help, :subcommands do
+          pos_arg :application_id
+          subcommands
+        end
+        for_context :application
+
+        private
+
+        def application_uncached
+          ::Avm::Registry.applications.detect(parsed.application_id)
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/application_stereotypes/list.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class ApplicationStereotypes
+        class List
+          runner_with :help, :output
+
+          def run
+            infov 'Found', stereotypes.count
+            run_output
+          end
+
+          def output_content
+            stereotypes.map { |s| "#{s}\n" }.join
+          end
+
+          private
+
+          def stereotypes
+            ::Avm::Registry.application_stereotypes.available
+              .sort_by { |s| [s.name, s.namespace_module] }
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/application_stereotypes.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class ApplicationStereotypes
+        runner_with :help, :subcommands do
+          subcommands
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/applications/list.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Applications
+        class List
+          runner_with :help, :output
+
+          def run
+            infov 'Found', applications.count
+            run_output
+          end
+
+          def output_content
+            applications.map { |s| "#{s}\n" }.join
+          end
+
+          private
+
+          def applications_uncached
+            ::Avm::Registry.applications.available
+              .sort_by { |s| [s.id] }
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/applications.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Applications
+        runner_with :help, :subcommands do
+          subcommands
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/config/load_path.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Config
+        class LoadPath
+          runner_with :help do
+            desc 'Manipulate include path.'
+            arg_opt '-p', '--push', 'Add a path.'
+          end
+
+          def run
+            config_nodes.each { |config_node| run_show(config_node) }
+            run_add
+          end
+
+          private
+
+          # @return [[EacCli::Config]]
+          def root_config_node
+            ::EacConfig::Node.context.current
+          end
+
+          def config_nodes
+            ::EacRubyUtils::RecursiveBuilder.new(root_config_node, &:self_loaded_nodes).result
+          end
+
+          def run_add
+            parsed.push.if_present do |v|
+              infov 'Path to add', v
+              root_config_node.write_node.load_path.push(v)
+              success 'Path included'
+            end
+          end
+
+          def run_show(config_node)
+            infov 'Configuration path', config_node.url
+            infov 'Paths included', config_node.self_loaded_nodes.count
+            config_node.self_loaded_nodes.each do |loaded_node|
+              infov '  * ', loaded_node.url
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/config.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Config
+        runner_with :help, :subcommands do
+          desc 'Configuration utilities.'
+          subcommands
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/files/format.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Files
+        class Format
+          runner_with :help do
+            desc 'Format files.'
+            bool_opt '-a', '--apply', 'Confirm changes.'
+            bool_opt '-n', '--no-recursive', 'No recursive.'
+            bool_opt '-q', '--quiet', 'Do not output messages.'
+            bool_opt '-d', '--dirty', 'Select modified files to format.'
+            pos_arg :paths, repeat: true, optional: true
+          end
+
+          def run
+            ::Avm::FileFormats::SearchFormatter.new(source_paths, formatter_options).run
+          end
+
+          def formatter_options
+            { ::Avm::FileFormats::SearchFormatter::OPTION_APPLY => parsed.apply?,
+              ::Avm::FileFormats::SearchFormatter::OPTION_RECURSIVE => !parsed.no_recursive?,
+              ::Avm::FileFormats::SearchFormatter::OPTION_VERBOSE => !parsed.quiet? }
+          end
+
+          def scm
+            @scm ||= ::Avm::Registry.scms.detect('.')
+          end
+
+          def dirty_files
+            scm.changed_files.map(&:absolute_path).select(&:exist?).map(&:to_path)
+          end
+
+          def source_paths
+            if parsed.dirty?
+              parsed.paths + dirty_files
+            else
+              parsed.paths.if_present(%w[.])
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/files/rotate.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Files
+        class Rotate
+          runner_with :help do
+            desc 'Rotates a file (Like a backup).'
+            arg_opt '-L', '--space-limit', 'Limit by <space> the space used by rotated files.'
+            pos_arg :path
+          end
+          def run
+            error_message = rotate.run
+            fatal_error(error_message) if error_message
+          end
+
+          def rotate
+            @rotate ||= ::Avm::Data::Rotate.new(
+              parsed.path,
+              space_limit: parsed.space_limit
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/files.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Files
+        runner_with :help, :subcommands do
+          desc 'Files utilities for AVM.'
+          subcommands
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/clear.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Clear
+            runner_with :help, :include_exclude, :instance_data_clear
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/dump.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Dump
+            runner_with :help, :include_exclude, :instance_data_dump do
+              desc 'Dump utility for instance.'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/load.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Load
+            runner_with :help, :include_exclude, :instance_data_load do
+              desc 'Load utility for instance.'
+            end
+
+            # @return [Avm::Instances::Data::Package]
+            def source_instance_data_owner
+              source_instance.data_package
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/unit/clear.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            class Clear
+              runner_with :help, :instance_data_clear
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/unit/dump.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            class Dump
+              runner_with :help, :instance_data_dump
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/unit/load.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            class Load
+              runner_with :help, :instance_data_load
+
+              # @return [Avm::Instances::Data::Unit]
+              def source_instance_data_owner
+                source_instance.data_package.unit(data_owner.identifier)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data/unit.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            runner_with :help, :subcommands do
+              pos_arg :identifier
+              subcommands
+            end
+
+            for_context :data_owner
+
+            # @return [Enumerable<String>]
+            def available_units_ids
+              data_package.units_ids
+            end
+
+            # @return [Avm::Instances::Data::Package]
+            def data_package
+              runner_context.call(:instance).data_package
+            end
+
+            # @return [Avm::Instances::Data::Unit]
+            def data_owner
+              data_package.unit(parsed.identifier)
+            end
+
+            # @return [String]
+            def help_extra_text
+              help_join_sections(super, list_section('Available units', available_units_ids))
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/sub/avm-tools/lib/avm/tools/runner/instance/data.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          runner_with :help, :subcommands do
+            desc 'Data utilities for EacRailsBase0 instances.'
+            subcommands
+          end
+
+          for_context :data_owner
+
+          # @return [Avm::Instances::Data::Package]
+          def data_owner
+            instance.data_package
+          end
+        end
+      end
+    end
+  end
+end