ehbrs-tools 0.21.0 → 0.22.0

data/vendor/eac_config/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/vendor/eac_config/eac_config.gemspec

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'eac_config/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'eac_config'
+  s.version     = EacConfig::VERSION
+  s.authors     = ['Put here the authors']
+  s.summary     = 'Put here de description.'
+
+  s.files = Dir['{lib}/**/*']
+
+  s.add_dependency 'addressable'
+  s.add_dependency 'eac_ruby_utils', '~> 0.64'
+
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.2'
+end

data/vendor/eac_config/lib/eac_config.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  require_sub __FILE__
+end

data/vendor/eac_config/lib/eac_config/entry.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'eac_config/entry_path'
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  class Entry
+    enable_simple_cache
+    common_constructor :root_node, :path do
+      self.path = ::EacConfig::EntryPath.assert(path)
+    end
+
+    def found?
+      node_entry.if_present(false, &:found?)
+    end
+
+    def found_node
+      node_entry.if_present(&:node)
+    end
+
+    def value
+      node_entry.if_present(&:value)
+    end
+
+    def value=(a_value)
+      write_node.self_entry(path).value = a_value
+    end
+
+    def write_node
+      root_node.write_node || root_node
+    end
+
+    private
+
+    def node_entry_uncached
+      node_entry_from_root || node_entry_from_load_path
+    end
+
+    def node_entry_from_load_path_uncached
+      root_node.recursive_loaded_nodes.lazy.map { |loaded_node| loaded_node.self_entry(path) }
+               .find(&:found?)
+    end
+
+    def node_entry_from_root_uncached
+      e = root_node.self_entry(path)
+      e.found? ? e : nil
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/entry_path.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  class EntryPath
+    PART_SEPARATOR = '.'
+
+    class << self
+      def assert(source)
+        source.is_a?(self) ? source : new(build_parts(source))
+      end
+
+      def build_parts(source)
+        return validate_parts!(source.split(PART_SEPARATOR)) if source.is_a?(::String)
+        return validate_parts!(source.flat_map { |part| build_parts(part) }) if
+        source.is_a?(::Enumerable)
+
+        build_parts(source.to_s)
+      end
+
+      def validate_parts!(parts)
+        parts.assert_argument(::Enumerable, 'parts')
+        parts.each_with_index do |part, index|
+          raise ::ArgumentError, "Part #{index} of #{parts} is blank" if part.blank?
+          raise ::ArgumentError, "Part #{index} is not a string" unless part.is_a?(::String)
+        end
+      end
+    end
+
+    attr_reader :parts
+
+    def initialize(parts)
+      @parts = parts.to_a.freeze
+    end
+
+    def to_s
+      "#{self.class}[#{parts.join(PART_SEPARATOR)}]"
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/envvars_node.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'addressable'
+require 'eac_config/node'
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  # A node that read/write entries from environment variables.
+  class EnvvarsNode
+    require_sub __FILE__
+    include ::EacConfig::Node
+
+    URI = ::Addressable::URI.parse('self://envvars')
+
+    class << self
+      def from_uri(uri)
+        return new if uri == URI
+      end
+    end
+
+    def url
+      URI
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/envvars_node/entry.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'eac_config/entry_path'
+require 'eac_config/node_entry'
+require 'eac_ruby_utils/blank_not_blank'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/yaml'
+
+module EacConfig
+  class EnvvarsNode
+    class Entry < ::EacConfig::NodeEntry
+      class << self
+        def entry_path_to_envvar_name(path)
+          ::EacConfig::EntryPath.assert(path).parts.join('_').gsub(/[^a-z0-9_]/i, '')
+                                .gsub(/\A_+/, '').gsub(/_+\z/, '').gsub(/_{2,}/, '_').upcase
+        end
+
+        def from_value(string)
+          return nil if string.nil?
+          return ::EacRubyUtils::Yaml.load(string) if string.start_with?('---')
+
+          string
+        end
+
+        def to_value(object)
+          return nil if object.nil?
+          return object if object.is_a?(String)
+
+          ::EacRubyUtils::Yaml.dump(object)
+        end
+      end
+
+      enable_simple_cache
+
+      def found?
+        ENV.key?(envvar_name)
+      end
+
+      def value
+        self.class.from_value(ENV[envvar_name])
+      end
+
+      def value=(a_value)
+        ENV[envvar_name] = self.class.to_value(a_value)
+      end
+
+      private
+
+      def envvar_name_uncached
+        self.class.entry_path_to_envvar_name(path)
+      end
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/load_nodes_search.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  class LoadNodesSearch
+    common_constructor :root_node do
+      add_next_pending until pending.empty?
+    end
+
+    def result
+      added
+    end
+
+    private
+
+    def added
+      @added ||= []
+    end
+
+    def add_next_pending
+      current = pending.pop
+      current.self_loaded_nodes.each do |loaded_node|
+        next if added.include?(loaded_node)
+
+        added << loaded_node
+        pending.push(loaded_node)
+      end
+    end
+
+    def pending
+      @pending ||= begin
+        r = Queue.new
+        r.push(root_node)
+        r
+      end
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/load_path.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'eac_config/entry_path'
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  class LoadPath
+    ENTRY_PATH = ::EacConfig::EntryPath.assert(%w[load_path])
+
+    common_constructor :node
+
+    def entry
+      node.self_entry(ENTRY_PATH)
+    end
+
+    # @return [Array<String>]
+    def paths
+      r = entry.value
+      r.is_a?(::Array) ? r : []
+    end
+
+    def push(new_path)
+      entry.value = paths + [new_path]
+    end
+
+    delegate :to_s, to: :paths
+  end
+end

data/vendor/eac_config/lib/eac_config/node.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'eac_config/entry'
+require 'eac_config/entry_path'
+require 'eac_config/load_path'
+require 'eac_config/load_nodes_search'
+require 'eac_config/node_entry'
+require 'eac_config/node_uri'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/context'
+
+module EacConfig
+  module Node
+    class << self
+      def context
+        @context ||= ::EacRubyUtils::Context.new
+      end
+    end
+
+    attr_accessor :write_node
+
+    common_concern do
+      enable_abstract_methods
+      include ::Comparable
+    end
+
+    def entry(path)
+      ::EacConfig::Entry.new(self, path)
+    end
+
+    # @return [[EacConfig::IncludePath]]
+    def load_path
+      @load_path ||= ::EacConfig::LoadPath.new(self)
+    end
+
+    # @return [Addressable::URI]
+    def url
+      raise_abstract_method(__method__)
+    end
+
+    # Return a entry which search values only in the self node.
+    # @return [EacConfig::NodeEntry]
+    def self_entry(path)
+      self_entry_class.new(self, path)
+    end
+
+    def self_entry_class
+      self.class.const_get('Entry')
+    end
+
+    # @return [Array<EacConfig::Node>]
+    def self_loaded_nodes
+      load_path.paths.map { |node_path| load_node(node_path) }
+    end
+
+    # @return [Array<EacConfig::Node>]
+    def recursive_loaded_nodes
+      ::EacConfig::LoadNodesSearch.new(self).result
+    end
+
+    private
+
+    def load_node(node_path)
+      ::EacConfig::NodeUri.new(node_path, url).instanciate
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/node_entry.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'eac_config/entry_path'
+require 'eac_config/paths_hash'
+require 'eac_ruby_utils/core_ext'
+
+module EacConfig
+  # A entry which search values only in the source node.
+  class NodeEntry
+    enable_abstract_methods
+    enable_simple_cache
+    common_constructor :node, :path do
+      self.path = ::EacConfig::EntryPath.assert(path)
+    end
+
+    abstract_methods :found?, :value, :value=
+  end
+end

data/vendor/eac_config/lib/eac_config/node_uri.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module EacConfig
+  class NodeUri
+    enable_simple_cache
+    common_constructor :source, :loader_uri, default: [nil]
+
+    def available_node_classes
+      require 'eac_config/envvars_node'
+      require 'eac_config/yaml_file_node'
+      [::EacConfig::EnvvarsNode, ::EacConfig::YamlFileNode]
+    end
+
+    def instanciate
+      available_node_classes.lazy.map { |k| k.from_uri(self) }.find(&:present?) ||
+        raise("No class mapped for \"#{to_addressable}\"")
+    end
+
+    delegate :to_s, to: :to_addressable
+
+    private
+
+    def to_addressable_uncached
+      r = ::Addressable::URI.parse(source)
+      path = r.path.to_pathname
+      r.path = path.expand_path(loader_uri_path_directory).to_path if path.relative?
+      r.scheme = 'file' if r.scheme.blank?
+      r
+    end
+
+    def loader_uri_path_directory
+      r = loader_uri.path
+      raise ".loader_uri \"#{loader_uri}\" has no path (Source: \"#{source}\")" if r.blank?
+
+      r.to_pathname.parent
+    end
+  end
+end

data/vendor/eac_config/lib/eac_config/old_configs.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'yaml'
+require 'eac_config/old_configs/file'
+require 'eac_ruby_utils/patches/hash/sym_keys_hash'
+require 'eac_config/paths_hash'
+require 'eac_ruby_utils/simple_cache'
+
+module EacConfig
+  # @deprecated Use {EacConfig::YamlFileNode} instead.
+  class OldConfigs
+    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
+
+    delegate :clear, to: :file
+
+    delegate :save, to: :file
+
+    delegate :load, to: :file
+
+    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
+
+    delegate :autosave?, to: :file
+
+    private
+
+    attr_accessor :data
+
+    def file_uncached
+      ::EacConfig::OldConfigs::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