ehbrs-tools 0.3.0

data/vendor/eac_ruby_utils/MIT-LICENCE

@@ -0,0 +1,16 @@
+Copyright 2018 Eduardo Henrique Bogoni <eduardobogoni@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/eac_ruby_utils/README.rdoc

@@ -0,0 +1,3 @@
+= E.A.C. Ruby Utilities
+
+Utilities for E.A.C.'s Ruby projects.

data/vendor/eac_ruby_utils/eac_ruby_utils.gemspec

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+# Maintain your gem's version:
+require 'eac_ruby_utils/version'
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = 'eac_ruby_utils'
+  s.version     = ::EacRubyUtils::VERSION
+  s.authors     = ['Esquilo Azul Company']
+  s.summary     = 'Utilities for E.A.C.\'s Ruby projects.'
+  s.license     = 'MIT'
+
+  s.files = Dir['{lib}/**/*', 'MIT-LICENSE', 'README.rdoc']
+
+  s.add_dependency 'activesupport', '~> 4.0'
+  s.add_dependency 'addressable', '~> 2.6'
+  s.add_dependency 'colorize', '~> 0.8.1'
+  s.add_dependency 'docopt', '~> 0.6.1'
+  s.add_dependency 'net-ssh', '~> 4.2'
+  s.add_development_dependency 'rspec', '~> 3.8'
+  s.add_development_dependency 'rubocop', '~> 0.80.1'
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module EacRubyUtils
+  require 'eac_ruby_utils/arguments_consumer'
+  require 'eac_ruby_utils/configs'
+  require 'eac_ruby_utils/console'
+  require 'eac_ruby_utils/contextualizable'
+  require 'eac_ruby_utils/core_ext'
+  require 'eac_ruby_utils/envs'
+  require 'eac_ruby_utils/filesystem_cache'
+  require 'eac_ruby_utils/filesystem_traverser'
+  require 'eac_ruby_utils/fs_cache'
+  require 'eac_ruby_utils/listable'
+  require 'eac_ruby_utils/options_consumer'
+  require 'eac_ruby_utils/settings_provider'
+  require 'eac_ruby_utils/patch'
+  require 'eac_ruby_utils/patches'
+  require 'eac_ruby_utils/paths_hash'
+  require 'eac_ruby_utils/require_sub'
+  require 'eac_ruby_utils/rspec'
+  require 'eac_ruby_utils/simple_cache'
+  require 'eac_ruby_utils/yaml'
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/arguments_consumer.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'active_support/hash_with_indifferent_access'
+require 'ostruct'
+
+module EacRubyUtils
+  class ArgumentsConsumer
+    class << self
+      def parse(args, positional = [], options = {})
+        new(args, positional, options).data
+      end
+    end
+
+    attr_reader :positional, :default_options
+
+    def initialize(positional, default_options)
+      @positional = positional.dup.freeze
+      @default_options = default_options.dup.freeze
+    end
+
+    def parse(args)
+      Parser.new(self, args).data
+    end
+
+    class Parser
+      attr_reader :data, :arguments_consumer
+
+      def initialize(arguments_consumer, args)
+        @arguments_consumer = arguments_consumer
+        @data = ::ActiveSupport::HashWithIndifferentAccess.new
+        @options_found = false
+        arguments_consumer.positional.each { |key| data[key] = nil }
+        data.merge!(arguments_consumer.default_options)
+        args.each_with_index { |value, index| add_arg(value, index) }
+        data.freeze
+      end
+
+      private
+
+      def add_arg(value, index)
+        arg = ::OpenStruct.new(value: value, index: index)
+        if arg.value.is_a?(::Hash)
+          add_hash_arg(arg)
+        else
+          add_positional_arg(arg)
+        end
+      end
+
+      def add_hash_arg(arg)
+        check_no_more_arguments(arg)
+        data.merge!(arg.value)
+        @options_found = true
+      end
+
+      def add_positional_arg(arg)
+        check_no_more_arguments(arg)
+        invalid_argument arg, 'No more valid positional' if
+          arg.index >= arguments_consumer.positional.count
+        data[arguments_consumer.positional[arg.index]] = arg.value
+      end
+
+      def check_no_more_arguments(arg)
+        return unless @options_found
+
+        invalid_argument arg, 'Hash already found - no more positional allowed'
+      end
+
+      def invalid_argument(arg, message)
+        raise InvalidArgumentError.new(self, arg, message)
+      end
+    end
+
+    class InvalidArgumentError < StandardError
+      def initialize(args_consumer, arg, message)
+        @args_consumer = args_consumer
+        @arg = arg
+        super "#{message} (Arg: #{arg}, Args Consumer: #{args_consumer})"
+      end
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/common_constructor.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'active_support/callbacks'
+require 'eac_ruby_utils/arguments_consumer'
+require 'ostruct'
+
+module EacRubyUtils
+  class CommonConstructor
+    attr_reader :args, :options, :after_set_block
+
+    class << self
+      def parse_args_options(args)
+        result = ::OpenStruct.new(args: [], options: {})
+        options_reached = false
+        args.each do |arg|
+          raise "Options reached and there is more arguments (Arguments: #{args})" if
+          options_reached
+
+          options_reached = parse_arg_options_process_arg(result, arg)
+        end
+        result
+      end
+
+      private
+
+      def parse_arg_options_process_arg(result, arg)
+        if arg.is_a?(::Hash)
+          result.options = arg
+          true
+        else
+          result.args << arg
+          false
+        end
+      end
+    end
+
+    def initialize(*args, &after_set_block)
+      args_processed = self.class.parse_args_options(args)
+      @args = args_processed.args
+      @options = args_processed.options
+      @after_set_block = after_set_block
+    end
+
+    def args_count
+      (args_count_min..args_count_max)
+    end
+
+    def args_count_min
+      args.count - default_values.count
+    end
+
+    def args_count_max
+      args.count
+    end
+
+    def default_values
+      options[:default] || []
+    end
+
+    def setup_class(klass)
+      setup_class_attr_readers(klass)
+      setup_class_attr_writers(klass)
+      setup_class_initialize(klass)
+    end
+
+    def setup_class_attr_readers(klass)
+      klass.send(:attr_reader, *args)
+      klass.send(:public, *args)
+    end
+
+    def setup_class_attr_writers(klass)
+      klass.send(:attr_writer, *args)
+      klass.send(:private, *args.map { |a| "#{a}=" })
+    end
+
+    def setup_class_initialize(klass)
+      common_constructor = self
+      klass.include(::ActiveSupport::Callbacks)
+      klass.define_callbacks :initialize
+      klass.send(:define_method, :initialize) do |*args|
+        Initialize.new(common_constructor, args, self).run
+      end
+    end
+
+    class Initialize
+      attr_reader :common_constructor, :args, :object
+
+      def initialize(common_constructor, args, object)
+        @common_constructor = common_constructor
+        @args = args
+        @object = object
+      end
+
+      def run
+        validate_args_count
+        object.run_callbacks :initialize do
+          object_attributes_set
+          object_after_callback
+        end
+      end
+
+      private
+
+      def arg_value(arg_name)
+        arg_index = common_constructor.args.index(arg_name)
+        if arg_index < args.count
+          args[arg_index]
+        else
+          common_constructor.default_values[arg_index - common_constructor.args_count_min]
+        end
+      end
+
+      def object_after_callback
+        return unless common_constructor.after_set_block
+
+        object.instance_eval(&common_constructor.after_set_block)
+      end
+
+      def object_attributes_set
+        common_constructor.args.each do |arg_name|
+          object.send("#{arg_name}=", arg_value(arg_name))
+        end
+      end
+
+      def validate_args_count
+        return if common_constructor.args_count.include?(args.count)
+
+        raise ArgumentError, "#{object.class}.initialize: wrong number of arguments" \
+          " (given #{args.count}, expected #{common_constructor.args_count})"
+      end
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/configs.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'yaml'
+require 'eac_ruby_utils/configs/file'
+require 'eac_ruby_utils/patches/hash/sym_keys_hash'
+require 'eac_ruby_utils/paths_hash'
+require 'eac_ruby_utils/simple_cache'
+
+module EacRubyUtils
+  class Configs
+    include ::EacRubyUtils::SimpleCache
+
+    attr_reader :configs_key, :options
+
+    # Valid options: [:storage_path]
+    def initialize(configs_key, options = {})
+      @configs_key = configs_key
+      @options = options.to_sym_keys_hash.freeze
+      load
+    end
+
+    def clear
+      file.clear
+    end
+
+    def save
+      file.save
+    end
+
+    def load
+      file.load
+    end
+
+    def []=(entry_key, entry_value)
+      write_entry(entry_key, entry_value)
+    end
+
+    def write_entry(entry_key, entry_value)
+      file.write(entry_key, entry_value)
+    end
+
+    def [](entry_key)
+      read_entry(entry_key)
+    end
+
+    def read_entry(entry_key)
+      file.read(entry_key)
+    end
+
+    def autosave?
+      file.autosave?
+    end
+
+    private
+
+    attr_accessor :data
+
+    def file_uncached
+      ::EacRubyUtils::Configs::File.new(
+        storage_path, options
+      )
+    end
+
+    def storage_path_uncached
+      path = options_storage_path || default_storage_path
+      return path if ::File.exist?(path) && ::File.size(path).positive?
+
+      ::FileUtils.mkdir_p(::File.dirname(path))
+      ::File.write(path, {}.to_yaml)
+      path
+    end
+
+    def options_storage_path
+      options[:storage_path]
+    end
+
+    def default_storage_path
+      ::File.join(ENV['HOME'], '.config', configs_key, 'settings.yml')
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/configs/file.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'yaml'
+require 'eac_ruby_utils/patches/hash/sym_keys_hash'
+require 'eac_ruby_utils/paths_hash'
+require 'eac_ruby_utils/simple_cache'
+
+module EacRubyUtils
+  class Configs
+    class File
+      include ::EacRubyUtils::SimpleCache
+
+      attr_reader :path, :options
+
+      # Valid options: [:autosave]
+      def initialize(path, options = {})
+        @path = path
+        @options = options.to_sym_keys_hash.freeze
+        load
+      end
+
+      def clear
+        self.data = ::EacRubyUtils::PathsHash.new({})
+      end
+
+      def save
+        ::FileUtils.mkdir_p(::File.dirname(path))
+        ::File.write(path, data.to_h.to_yaml)
+      end
+
+      def load
+        self.data = if ::File.exist?(path) && ::File.size(path).positive?
+                      ::EacRubyUtils::PathsHash.new(YAML.load_file(path))
+                    else
+                      {}
+                    end
+      end
+
+      def []=(entry_key, entry_value)
+        write(entry_key, entry_value)
+      end
+
+      def write(entry_key, entry_value)
+        data[entry_key] = entry_value
+        save if autosave?
+      end
+
+      def [](entry_key)
+        read(entry_key)
+      end
+
+      def read(entry_key)
+        data[entry_key]
+      end
+
+      def autosave?
+        options[:autosave] ? true : false
+      end
+
+      private
+
+      attr_accessor :data
+    end
+  end
+end

data/vendor/eac_ruby_utils/lib/eac_ruby_utils/console.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/console/configs'
+require 'eac_ruby_utils/console/docopt_runner'
+require 'eac_ruby_utils/console/speaker'