eac_tools 0.97.2 → 0.98.0

data/sub/eac_config/lib/eac_config/entries.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_config/entry_path'
-require 'eac_ruby_utils/core_ext'
-
-module EacConfig
-  class Entries
-    require_sub __FILE__
-    enable_simple_cache
-    common_constructor :root_node, :path do
-      self.path = ::EacConfig::EntryPath.assert(path)
-    end
-
-    def to_s
-      "#{self.class}[RootNode: #{root_node}, Path: #{path}]"
-    end
-
-    private
-
-    # @return [Array<EacConfig::Entries>]
-    def node_entries_uncached
-      node_entries_from_root + node_entries_from_load_path
-    end
-
-    # @return [Array<EacConfig::Entries>]
-    def node_entries_from_load_path_uncached
-      root_node.recursive_loaded_nodes.flat_map { |loaded_node| loaded_node.self_entries(path) }
-    end
-
-    # @return [Array<EacConfig::Entries>]
-    def node_entries_from_root_uncached
-      root_node.self_entries(path)
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/entry/not_found_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/core_ext'
-
-module EacConfig
-  class Entry
-    class NotFoundError < ::RuntimeError
-      def initialize(entry)
-        super("Entry #{entry} not found")
-      end
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/entry.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_config/entry_path'
-require 'eac_ruby_utils/core_ext'
-
-module EacConfig
-  class Entry
-    require_sub __FILE__
-    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 secret_value
-      node_entry.if_present(&:secret_value)
-    end
-
-    def to_s
-      "#{self.class}[RootNode: #{root_node}, Path: #{path}]"
-    end
-
-    def value
-      node_entry.if_present(&:value)
-    end
-
-    def value!
-      return value if found?
-
-      raise ::EacConfig::Entry::NotFoundError, self
-    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/sub/eac_config/lib/eac_config/entry_path.rb

@@ -1,89 +0,0 @@
-# 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
-
-    common_constructor :parts, default: [[]] do
-      self.parts = ::Array.new(parts).freeze
-    end
-
-    compare_by :parts
-    delegate :any?, :count, :each, :each_value, :each_with_index, :empty?, :fetch, :first, :index,
-             :inject, :last, :map, :size, to: :parts
-
-    # @return [EacConfig::EntryPath]
-    def +(other)
-      self.class.new(parts + self.class.assert(other).parts)
-    end
-
-    def [](*args)
-      slice(*args)
-    end
-
-    def slice(*args)
-      r = parts.slice(*args)
-      r.is_a?(::Enumerable) ? self.class.new(r) : r
-    end
-
-    def to_s
-      "#{self.class}[#{to_string}]"
-    end
-
-    # @return [String]
-    def to_string
-      parts.join(PART_SEPARATOR)
-    end
-
-    # @param part [String]
-    # @return [EacConfig::EntryPath]
-    def with_first(part)
-      new_parts = parts.dup
-      new_parts.unshift(part)
-      self.class.new(new_parts)
-    end
-
-    # @return [EacConfig::EntryPath]
-    def without_first
-      new_parts = parts.dup
-      new_parts.shift
-      self.class.new(new_parts)
-    end
-
-    # @return [EacConfig::EntryPath]
-    def with_last(part)
-      self.class.new(parts + [part])
-    end
-
-    # @return [EacConfig::EntryPath]
-    def without_last
-      new_parts = parts.dup
-      new_parts.pop
-      self.class.new(new_parts)
-    end
-  end
-end

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

@@ -1,54 +0,0 @@
-# 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.fetch(envvar_name, nil))
-      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/sub/eac_config/lib/eac_config/envvars_node.rb

@@ -1,35 +0,0 @@
-# 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)
-        new if uri == URI
-      end
-    end
-
-    # @param path [EacConfig::EntryPath]
-    # @return [Array<EacConfig::Entries>]
-    def self_entries(_path)
-      []
-    end
-
-    def url
-      URI
-    end
-
-    def to_s
-      "#{self.class}[ObjectId: #{object_id}]}"
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/load_nodes_search.rb

@@ -1,39 +0,0 @@
-# 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/sub/eac_config/lib/eac_config/load_path.rb

@@ -1,28 +0,0 @@
-# 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/sub/eac_config/lib/eac_config/node.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_config/entries'
-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
-      acts_as_abstract :self_entries
-      include ::Comparable
-    end
-
-    # @return [Array<EacConfig::Entries>]
-    def entries(path)
-      ::EacConfig::Entries.new(self, path)
-    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.flat_map { |node_path| load_nodes(node_path) }
-    end
-
-    # @return [Array<EacConfig::Node>]
-    def recursive_loaded_nodes
-      ::EacConfig::LoadNodesSearch.new(self).result
-    end
-
-    # @return [EacConfig::PrefixedPathNode]
-    def with_prefix(path_prefix)
-      require 'eac_config/prefixed_path_node'
-      ::EacConfig::PrefixedPathNode.new(self, path_prefix)
-    end
-
-    private
-
-    # @param node_path [String]
-    # @return [Array<EacConfig::Node>]
-    def load_nodes(node_path)
-      ::EacConfig::NodeUri.new(node_path, url).instanciate
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/node_entry.rb

@@ -1,28 +0,0 @@
-# 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
-    compare_by :node, :path
-
-    abstract_methods :found?, :value, :value=
-
-    def secret_value
-      value
-    end
-
-    # @return [String]
-    def to_s
-      "#{self.class}[Node: #{node}, Path: #{path}]"
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/node_uri/instanciate_single.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module EacConfig
-  class NodeUri
-    class InstanciateSingle
-      acts_as_instance_method
-      enable_simple_cache
-      common_constructor :node_uri, :instance_uri
-
-      # @return [Array<Class>]
-      def available_node_classes
-        require 'eac_config/envvars_node'
-        require 'eac_config/yaml_file_node'
-        [::EacConfig::EnvvarsNode, ::EacConfig::YamlFileNode]
-      end
-
-      # @return [EacConfig::Node]
-      def result
-        available_node_classes.lazy.map { |k| k.from_uri(self) }.find(&:present?) ||
-          raise("No class mapped for \"#{to_addressable}\"")
-      end
-
-      # @return [Addressable::URI]
-      def to_addressable
-        instance_uri.to_uri
-      end
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/node_uri.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-module EacConfig
-  class NodeUri
-    enable_simple_cache
-    common_constructor :source, :loader_uri, default: [nil]
-
-    # @return [Array<EacConfig::Node>]
-    def instanciate
-      instance_uris.map { |uri| instanciate_single(uri) }
-    end
-
-    delegate :to_s, to: :to_addressable
-
-    private
-
-    # @return [Array<Addressable::URI>]
-    def instance_uris
-      if to_addressable.scheme == 'file'
-        ::Pathname.glob(to_addressable.path).map do |found_path|
-          ::Addressable::URI.new(scheme: 'file', path: found_path.to_path)
-        end
-      else
-        [to_addressable]
-      end
-    end
-
-    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
-
-    require_sub __FILE__, require_mode: :kernel
-  end
-end

data/sub/eac_config/lib/eac_config/old_configs/base.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_ruby_utils/blank_not_blank'
-require 'eac_ruby_utils/core_ext'
-require 'eac_config/paths_hash'
-
-module EacConfig
-  class OldConfigs
-    class Base
-      enable_simple_cache
-
-      common_constructor :data, default: [{}] do
-        self.data = ::EacConfig::PathsHash.new(data)
-      end
-
-      def []=(entry_key, entry_value)
-        write(entry_key, entry_value)
-      end
-
-      def [](entry_key)
-        read(entry_key)
-      end
-
-      def clear
-        replace({})
-      end
-
-      def read(entry_key)
-        return nil unless data.key?(entry_key)
-
-        data.fetch(entry_key).if_present(::EacRubyUtils::BlankNotBlank.instance)
-      end
-
-      def replace(new_data)
-        self.data = ::EacConfig::PathsHash.new(new_data)
-      end
-
-      def write(entry_key, entry_value)
-        data[entry_key] = entry_value
-      end
-    end
-  end
-end

data/sub/eac_config/lib/eac_config/old_configs/file.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require 'eac_config/old_configs/base'
-require 'yaml'
-
-module EacConfig
-  class OldConfigs
-    class File < ::EacConfig::OldConfigs::Base
-      attr_reader :path, :options
-
-      # Valid options: [:autosave]
-      def initialize(path, options = {})
-        @path = path
-        @options = options.to_sym_keys_hash.freeze
-        super(raw_data_from_file)
-      end
-
-      def save
-        ::FileUtils.mkdir_p(::File.dirname(path))
-        ::File.write(path, data.to_h.to_yaml)
-      end
-
-      def load
-        replace(raw_data_from_file)
-      end
-
-      def write(entry_key, entry_value)
-        super
-        save if autosave?
-      end
-
-      def autosave?
-        options[:autosave] ? true : false
-      end
-
-      private
-
-      def raw_data_from_file
-        if ::File.exist?(path) && ::File.size(path).positive?
-          ::YAML.load_file(path)
-        else
-          {}
-        end
-      end
-    end
-  end
-end