eac_tools 0.97.2 → 0.99.0

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,25 @@
+# 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.95'
+  s.add_dependency 'clipboard', '~> 1.4', '>= 1.4.1'
+  s.add_dependency 'eac_ruby_base0', '~> 0.19', '>= 0.19.1'
+
+  s.add_development_dependency 'avm-git', '~> 0.19'
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.8', '>= 0.8.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/runner'
+Avm::Tools::Runner.run

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

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_base0/core_ext'

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

@@ -0,0 +1,20 @@
+# 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)
+            require 'avm/tools/runner'
+            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/helpers.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils'
+
+module Avm
+  module Tools
+    module Rspec
+      module Helpers
+        require_sub __FILE__
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'avm/tools/rspec/helpers/runner'
+require 'eac_ruby_utils'
+
+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/rspec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils'
+
+module Avm
+  module Tools
+    module Rspec
+      require_sub __FILE__
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'avm/tools/core_ext'
+
+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,26 @@
+# frozen_string_literal: true
+
+require 'avm/registry'
+require 'eac_ruby_base0/core_ext'
+
+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
+
+        require_sub __FILE__
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'avm/tools/core_ext'
+
+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,16 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class ApplicationStereotypes
+        require_sub __FILE__
+        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,31 @@
+# frozen_string_literal: true
+
+require 'avm/tools/core_ext'
+
+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,16 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Applications
+        require_sub __FILE__
+        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,52 @@
+# frozen_string_literal: true
+
+require 'avm/tools/core_ext'
+require 'eac_config/node'
+require 'eac_ruby_utils'
+
+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,17 @@
+# frozen_string_literal: true
+
+require 'avm/tools/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Config
+        require_sub __FILE__
+        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,50 @@
+# frozen_string_literal: true
+
+require 'avm/file_formats/search_formatter'
+require 'avm/registry'
+require 'eac_cli/core_ext'
+
+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,31 @@
+# frozen_string_literal: true
+
+require 'avm/data/rotate'
+require 'eac_cli/core_ext'
+
+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,17 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Files
+        require_sub __FILE__
+        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,18 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,20 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,25 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,20 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,20 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,25 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+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,44 @@
+# frozen_string_literal: true
+
+require 'avm/instances/runner'
+require 'eac_cli/core_ext'
+
+module Avm
+  module Tools
+    class Runner
+      class Instance < ::Avm::Instances::Runner
+        class Data
+          class Unit
+            require_sub __FILE__
+            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