runger_config 3.0.1 → 5.0.0

data/lib/generators/{anyway → runger}/install/templates/application_config.rb.tt

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Base class for application config classes
-class ApplicationConfig < Anyway::Config
+class ApplicationConfig < Runger::Config
   class << self
     # Make it possible to access a singleton config instance
     # via class methods (i.e., without explicitly calling `instance`)

data/lib/{anyway → runger}/auto_cast.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Anyway
+module Runger
   module AutoCast
     # Regexp to detect array values
     # Array value is a values that contains at least one comma
@@ -23,11 +23,11 @@ module Anyway
         when /\A(nil|null)\z/i
           nil
         when /\A\d+\z/
-          val.to_i
+          Integer(val, 10)
         when /\A\d*\.\d+\z/
-          val.to_f
+          Float(val)
         when /\A['"].*['"]\z/
-          val.gsub(/(\A['"]|['"]\z)/, "")
+          val.gsub(/(\A['"]|['"]\z)/, '')
         else
           val
         end

data/lib/{anyway → runger}/config.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-require "active_support/all"
-require "anyway/optparse_config"
-require "anyway/dynamic_config"
+require 'active_support/all'
+require 'runger/dynamic_config'
+require 'runger/optparse_config'
 
-module Anyway # :nodoc:
-  using Anyway::Ext::DeepDup
-  using Anyway::Ext::DeepFreeze
-  using Anyway::Ext::Hash
-  using Anyway::Ext::FlattenNames
+module Runger # :nodoc:
+  using Runger::Ext::DeepDup
+  using Runger::Ext::DeepFreeze
+  using Runger::Ext::Hash
+  using Runger::Ext::FlattenNames
 
   using(Module.new do
     refine Object do
@@ -20,6 +20,8 @@ module Anyway # :nodoc:
   # Provides `attr_config` method to describe
   # configuration parameters and set defaults
   class Config
+    include OptparseConfig
+    include DynamicConfig
     PARAM_NAME = /^[a-z_](\w+)?$/
 
     # List of names that couldn't be used as config names
@@ -53,9 +55,6 @@ module Anyway # :nodoc:
 
     class ValidationError < Error; end
 
-    include OptparseConfig
-    include DynamicConfig
-
     class BlockCallback
       attr_reader :block
 
@@ -83,17 +82,18 @@ module Anyway # :nodoc:
         new_defaults = hargs.deep_dup
         new_defaults.stringify_keys!
 
-        defaults.merge! new_defaults
+        defaults.merge!(new_defaults)
 
         new_keys = ((args + new_defaults.keys) - config_attributes)
 
-        validate_param_names! new_keys.map(&:to_s)
+        validate_param_names!(new_keys.map(&:to_s))
 
         new_keys.map!(&:to_sym)
 
         unless (reserved_names = (new_keys & RESERVED_NAMES)).empty?
-          raise ArgumentError, "Can not use the following reserved names as config attrubutes: " \
-            "#{reserved_names.sort.map(&:to_s).join(", ")}"
+          raise(ArgumentError,
+            'Can not use the following reserved names as config attrubutes: ' \
+            "#{reserved_names.sort.map(&:to_s).join(', ')}")
         end
 
         config_attributes.push(*new_keys)
@@ -104,33 +104,39 @@ module Anyway # :nodoc:
         # having `true` or `false` as default values
         new_defaults.each do |key, val|
           next unless val.is_a?(TrueClass) || val.is_a?(FalseClass)
-          alias_method :"#{key}?", :"#{key}"
+
+          alias_method(:"#{key}?", :"#{key}")
         end
       end
 
       def defaults
         return @defaults if instance_variable_defined?(:@defaults)
 
-        @defaults = if superclass < Anyway::Config
-          superclass.defaults.deep_dup
-        else
-          new_empty_config
-        end
+        @defaults =
+          if superclass < Runger::Config
+            superclass.defaults.deep_dup
+          else
+            new_empty_config
+          end
       end
 
       def config_attributes
         return @config_attributes if instance_variable_defined?(:@config_attributes)
 
-        @config_attributes = if superclass < Anyway::Config
-          superclass.config_attributes.dup
-        else
-          []
-        end
+        @config_attributes =
+          if superclass < Runger::Config
+            superclass.config_attributes.dup
+          else
+            []
+          end
       end
 
       def required(*names, env: nil, **nested)
         unknown_names = names + nested.keys - config_attributes
-        raise ArgumentError, "Unknown config param: #{unknown_names.join(",")}" if unknown_names.any?
+        if unknown_names.any?
+          raise(ArgumentError,
+            "Unknown config param: #{unknown_names.join(',')}")
+        end
 
         return unless Settings.matching_env?(env)
 
@@ -141,15 +147,19 @@ module Anyway # :nodoc:
       def required_attributes
         return @required_attributes if instance_variable_defined?(:@required_attributes)
 
-        @required_attributes = if superclass < Anyway::Config
-          superclass.required_attributes.dup
-        else
-          []
-        end
+        @required_attributes =
+          if superclass < Runger::Config
+            superclass.required_attributes.dup
+          else
+            []
+          end
       end
 
       def on_load(*names, &block)
-        raise ArgumentError, "Either methods or block should be specified, not both" if block && !names.empty?
+        if block && !names.empty?
+          raise(ArgumentError,
+            'Either methods or block should be specified, not both')
+        end
 
         if block
           load_callbacks << BlockCallback.new(block)
@@ -161,11 +171,12 @@ module Anyway # :nodoc:
       def load_callbacks
         return @load_callbacks if instance_variable_defined?(:@load_callbacks)
 
-        @load_callbacks = if superclass <= Anyway::Config
-          superclass.load_callbacks.dup
-        else
-          []
-        end
+        @load_callbacks =
+          if superclass <= Runger::Config
+            superclass.load_callbacks.dup
+          else
+            []
+          end
       end
 
       def config_name(val = nil)
@@ -192,11 +203,12 @@ module Anyway # :nodoc:
 
         return @env_prefix if instance_variable_defined?(:@env_prefix)
 
-        @env_prefix = if superclass < Anyway::Config && superclass.explicit_config_name?
-          superclass.env_prefix
-        else
-          config_name.upcase
-        end
+        @env_prefix =
+          if superclass < Runger::Config && superclass.explicit_config_name?
+            superclass.env_prefix
+          else
+            config_name.upcase
+          end
       end
 
       def loader_options(val = nil)
@@ -204,34 +216,36 @@ module Anyway # :nodoc:
 
         return @loader_options if instance_variable_defined?(:@loader_options)
 
-        @loader_options = if superclass < Anyway::Config
-          superclass.loader_options
-        else
-          {}
-        end
+        @loader_options =
+          if superclass < Runger::Config
+            superclass.loader_options
+          else
+            {}
+          end
       end
 
       def new_empty_config = {}
 
       def coerce_types(mapping)
-        Utils.deep_merge!(coercion_mapping, mapping)
+        ::Runger::Utils.deep_merge!(coercion_mapping, mapping)
 
         mapping.each do |key, val|
           type = val.is_a?(::Hash) ? val[:type] : val
           next if type != :boolean
 
-          alias_method :"#{key}?", :"#{key}"
+          alias_method(:"#{key}?", :"#{key}")
         end
       end
 
       def coercion_mapping
         return @coercion_mapping if instance_variable_defined?(:@coercion_mapping)
 
-        @coercion_mapping = if superclass < Anyway::Config
-          superclass.coercion_mapping.deep_dup
-        else
-          {}
-        end
+        @coercion_mapping =
+          if superclass < Runger::Config
+            superclass.coercion_mapping.deep_dup
+          else
+            {}
+          end
       end
 
       def type_caster(val = nil)
@@ -241,7 +255,7 @@ module Anyway # :nodoc:
           if coercion_mapping.empty?
             fallback_type_caster
           else
-            ::Anyway::TypeCaster.new(coercion_mapping, fallback: fallback_type_caster)
+            ::Runger::TypeCaster.new(coercion_mapping, fallback: fallback_type_caster)
           end
       end
 
@@ -250,22 +264,23 @@ module Anyway # :nodoc:
 
         return @fallback_type_caster if instance_variable_defined?(:@fallback_type_caster)
 
-        @fallback_type_caster = if superclass < Anyway::Config
-          superclass.fallback_type_caster.deep_dup
-        else
-          ::Anyway::AutoCast
-        end
+        @fallback_type_caster =
+          if superclass < Runger::Config
+            superclass.fallback_type_caster.deep_dup
+          else
+            ::Runger::AutoCast
+          end
       end
 
       def disable_auto_cast!
-        @fallback_type_caster = ::Anyway::NoCast
+        @fallback_type_caster = ::Runger::NoCast
       end
 
       private
 
       def define_config_accessor(*names)
         names.each do |name|
-          accessors_module.module_eval <<~RUBY, __FILE__, __LINE__ + 1
+          accessors_module.module_eval(<<~RUBY, __FILE__, __LINE__ + 1)
             def #{name}=(val)
               __trace__&.record_value(val, "#{name}", **Tracing.current_trace_source)
               values[:#{name}] = val
@@ -281,31 +296,33 @@ module Anyway # :nodoc:
       def accessors_module
         return @accessors_module if instance_variable_defined?(:@accessors_module)
 
-        @accessors_module = Module.new.tap do |mod|
-          include mod
-        end
+        @accessors_module =
+          Module.new.tap do |mod|
+            include mod
+          end
       end
 
       def build_config_name
         unless name
-          raise "Please, specify config name explicitly for anonymous class " \
-            "via `config_name :my_config`"
+          raise('Please, specify config name explicitly for anonymous class ' \
+                'via `config_name :my_config`')
         end
 
-        unless name.underscore.gsub("/", "_") =~ /(\w+)_config\z/
-          raise "Couldn't infer config name, please, specify it explicitly " \
-            "via `config_name :my_config`"
+        unless name.underscore.tr('/', '_') =~ /(\w+)_config\z/
+          raise("Couldn't infer config name, please, specify it explicitly " \
+                'via `config_name :my_config`')
         end
 
-        Regexp.last_match[1].delete_suffix("_config").tap(&:downcase!)
+        Regexp.last_match[1].delete_suffix('_config').tap(&:downcase!)
       end
 
       def validate_param_names!(names)
-        invalid_names = names.reject { |name| name =~ PARAM_NAME }
+        invalid_names = names.grep_v(PARAM_NAME)
         return if invalid_names.empty?
 
-        raise ArgumentError, "Invalid attr_config name: #{invalid_names.join(", ")}.\n" \
-          "Valid names must satisfy /#{PARAM_NAME.source}/."
+        raise(ArgumentError,
+          "Invalid attr_config name: #{invalid_names.join(', ')}.\n" \
+          "Valid names must satisfy /#{PARAM_NAME.source}/.")
       end
     end
 
@@ -317,15 +334,15 @@ module Anyway # :nodoc:
     #
     # Example:
     #
-    #   my_config = Anyway::Config.new()
+    #   my_config = Runger::Config.new()
     #
     #   # provide some values explicitly
-    #   my_config = Anyway::Config.new({some: :value})
+    #   my_config = Runger::Config.new({some: :value})
     #
     def initialize(overrides = nil)
       @config_name = self.class.config_name
 
-      raise ArgumentError, "Config name is missing" unless @config_name
+      raise(ArgumentError, 'Config name is missing') unless @config_name
 
       @env_prefix = self.class.env_prefix
       @values = {}
@@ -348,25 +365,26 @@ module Anyway # :nodoc:
     def load(overrides = nil)
       base_config = self.class.defaults.deep_dup
 
-      trace = Tracing.capture do
-        Tracing.trace!(:defaults) { base_config }
+      trace =
+        Tracing.capture do
+          Tracing.trace!(:defaults) { base_config }
 
-        config_path = resolve_config_path(config_name, env_prefix)
+          config_path = resolve_config_path(config_name, env_prefix)
 
-        load_from_sources(
-          base_config,
-          name: config_name,
-          env_prefix:,
-          config_path:,
-          **self.class.loader_options
-        )
+          load_from_sources(
+            base_config,
+            name: config_name,
+            env_prefix:,
+            config_path:,
+            **self.class.loader_options,
+          )
 
-        if overrides
-          Tracing.trace!(:load) { overrides }
+          if overrides
+            Tracing.trace!(:load) { overrides }
 
-          Utils.deep_merge!(base_config, overrides)
+            ::Runger::Utils.deep_merge!(base_config, overrides)
+          end
         end
-      end
 
       base_config.each do |key, val|
         write_config_attr(key.to_sym, val)
@@ -385,9 +403,9 @@ module Anyway # :nodoc:
       self
     end
 
-    def load_from_sources(base_config, **)
-      Anyway.loaders.each do |(_id, loader)|
-        Utils.deep_merge!(base_config, loader.call(**))
+    def load_from_sources(base_config, **options)
+      Runger.loaders.each do |(_id, loader)|
+        ::Runger::Utils.deep_merge!(base_config, loader.call(**options))
       end
       base_config
     end
@@ -406,7 +424,7 @@ module Anyway # :nodoc:
     end
 
     def resolve_config_path(name, env_prefix)
-      Anyway.env.fetch(env_prefix).delete("conf") || Settings.default_config_path.call(name)
+      Runger.env.fetch(env_prefix).delete('conf') || Settings.default_config_path.call(name)
     end
 
     def deconstruct_keys(keys) = values.deconstruct_keys(keys)
@@ -414,20 +432,21 @@ module Anyway # :nodoc:
     def to_source_trace = __trace__&.to_h
 
     def inspect
-      "#<#{self.class}:0x#{vm_object_id.rjust(16, "0")} config_name=\"#{config_name}\" env_prefix=\"#{env_prefix}\" " \
-      "values=#{values.inspect}>"
+      "#<#{self.class}:0x#{vm_object_id.rjust(16,
+        '0')} config_name=\"#{config_name}\" env_prefix=\"#{env_prefix}\" " \
+        "values=#{values.inspect}>"
     end
 
     def pretty_print(q)
-      q.object_group self do
+      q.object_group(self) do
         q.nest(1) do
           q.breakable
           q.text "config_name=#{config_name.inspect}"
           q.breakable
           q.text "env_prefix=#{env_prefix.inspect}"
           q.breakable
-          q.text "values:"
-          q.pp __trace__
+          q.text 'values:'
+          q.pp(__trace__)
         end
       end
     end
@@ -442,11 +461,12 @@ module Anyway # :nodoc:
 
     def validate_required_attributes!
       self.class.required_attributes.select do |name|
-        val = values.dig(*name.to_s.split(".").map(&:to_sym))
+        val = values.dig(*name.to_s.split('.').map(&:to_sym))
         val.nil? || (val.is_a?(String) && val.empty?)
       end.then do |missing|
         next if missing.empty?
-        raise_validation_error "The following config parameters for `#{self.class.name}(config_name: #{self.class.config_name})` are missing or empty: #{missing.join(", ")}"
+
+        raise_validation_error("The following config parameters for `#{self.class.name}(config_name: #{self.class.config_name})` are missing or empty: #{missing.join(', ')}")
       end
     end
 
@@ -459,7 +479,7 @@ module Anyway # :nodoc:
     end
 
     def raise_validation_error(msg)
-      raise ValidationError, msg
+      raise(ValidationError, msg)
     end
 
     def __type_caster__

data/lib/runger/dynamic_config.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Adds ability to generate anonymous (class-less) config dynamicly
+# (like Rails.application.config_for but using more data sources).
+module Runger::DynamicConfig
+  module ClassMethods
+    # Load config as Hash by any name
+    #
+    # Example:
+    #
+    #   my_config = Runger::Config.for(:my_app)
+    #   # will load data from config/my_app.yml, secrets.my_app, ENV["MY_APP_*"]
+    #
+    def for(name, auto_cast: true, **options)
+      config = allocate
+      options[:env_prefix] ||= name.to_s.upcase
+      options[:config_path] ||= config.resolve_config_path(name, options[:env_prefix])
+
+      raw_config = config.load_from_sources(new_empty_config, name:, **options)
+      return raw_config unless auto_cast
+
+      ::Runger::AutoCast.call(raw_config)
+    end
+  end
+
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+end

data/lib/runger/ejson_parser.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'runger/ext/hash'
+
+using Runger::Ext::Hash
+
+class Runger::EJSONParser
+  attr_reader :bin_path
+
+  def initialize(bin_path = 'ejson')
+    @bin_path = bin_path
+  end
+
+  def call(file_path)
+    return unless File.exist?(file_path)
+
+    raw_content = nil
+
+    stdout, stderr, status = Open3.capture3("#{bin_path} decrypt #{file_path}")
+
+    if status.success?
+      raw_content = JSON.parse(stdout.chomp)
+    else
+      Kernel.warn("Failed to decrypt #{file_path}: #{stderr}")
+    end
+
+    return unless raw_content
+
+    raw_content.deep_transform_keys do |key|
+      if key[0] == '_'
+        # rubocop:disable Performance/ArraySemiInfiniteRangeSlice
+        key[1..]
+        # rubocop:enable Performance/ArraySemiInfiniteRangeSlice
+      else
+        key
+      end
+    end
+  end
+end

data/lib/runger/env.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# Parses environment variables and provides
+# method-like access
+class Runger::Env
+  using Runger::Ext::DeepDup
+  using Runger::Ext::Hash
+
+  class << self
+    def from_hash(hash, prefix: nil, memo: {})
+      hash.each do |key, value|
+        prefix_with_key = (prefix && !prefix.empty?) ? "#{prefix}_#{key.to_s.upcase}" : key.to_s.upcase
+
+        if value.is_a?(Hash)
+          from_hash(value, prefix: "#{prefix_with_key}_", memo:)
+        else
+          memo[prefix_with_key] = value.to_s
+        end
+      end
+
+      memo
+    end
+  end
+
+  include ::Runger::Tracing
+
+  attr_reader :data, :traces, :type_cast, :env_container
+
+  def initialize(type_cast: ::Runger::AutoCast, env_container: ENV)
+    @type_cast = type_cast
+    @data = {}
+    @traces = {}
+    @env_container = env_container
+  end
+
+  def clear
+    data.clear
+    traces.clear
+  end
+
+  def fetch(prefix)
+    return data[prefix].deep_dup if data.key?(prefix)
+
+    ::Runger::Tracing.capture do
+      data[prefix] = parse_env(prefix)
+    end.then do |trace|
+      traces[prefix] = trace
+    end
+
+    data[prefix].deep_dup
+  end
+
+  def fetch_with_trace(prefix)
+    [fetch(prefix), traces[prefix]]
+  end
+
+  private
+
+  def parse_env(prefix)
+    match_prefix = prefix.empty? ? prefix : "#{prefix}_"
+    env_container.each_pair.with_object({}) do |(key, val), data|
+      next unless key.start_with?(match_prefix)
+
+      path = key.sub(/^#{match_prefix}/, '').downcase
+
+      paths = path.split('__')
+      trace!(:env, *paths, key:) { data.bury(type_cast.call(val), *paths) }
+    end
+  end
+end

data/lib/runger/ext/deep_dup.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Extend Object through refinements
+module Runger::Ext::DeepDup
+  refine ::Hash do
+    # Based on ActiveSupport http://api.rubyonrails.org/classes/Hash.html#method-i-deep_dup
+    def deep_dup
+      each_with_object(dup) do |(key, value), hash|
+        hash[key] =
+          if value.is_a?(::Hash) || value.is_a?(::Array)
+            value.deep_dup
+          else
+            value
+          end
+      end
+    end
+  end
+
+  refine ::Array do
+    # From ActiveSupport http://api.rubyonrails.org/classes/Array.html#method-i-deep_dup
+    def deep_dup
+      map do |value|
+        if value.is_a?(::Hash) || value.is_a?(::Array)
+          value.deep_dup
+        else
+          value
+        end
+      end
+    end
+  end
+
+  refine ::Object do
+    def deep_dup
+      dup
+    end
+  end
+
+  refine ::Module do
+    def deep_dup
+      self
+    end
+  end
+
+  using self
+end