config_hash 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 73f82976e9390c9a3415a6eb9184d8b198a4593f
+  data.tar.gz: 3802b8e1088be490850e06034d5e8ffa7a8de439
+SHA512:
+  metadata.gz: b3012332aeb6d10baf6d1f8183337dce40815a9428cf91b69c0eb25902a0cff794eaac1e9a2e11d01d60cb7bb66c16bca065f74db8b25b0c167e7ed42555a960
+  data.tar.gz: 17c079178938569abf148d7292b6a91e1f2d85719e30b7f90a0d68cdcdb70abc28d09dc2b1bfe5b3a4e006d2937dfaf604be0fdff1b8ccda7399b2b2b536cbe3

data/lib/config_hash/processors.rb

@@ -0,0 +1,19 @@
+class ConfigHash < Hash
+  class Processors
+    class << self
+      def constantize(v)
+        case v
+          when Symbol then v.to_s.start_with?(':') ? const_fetch(":#{v}", v) : v
+          when String then v.start_with?('::')     ? const_fetch(v, v)       : v
+          else v
+        end
+      end
+
+      private
+
+      def const_fetch(value, default)
+        Object.const_defined?(value) ? Object.const_get(value) : default
+      end
+    end
+  end
+end

data/lib/config_hash.rb

@@ -0,0 +1,87 @@
+require 'config_hash/processors'
+
+class ConfigHash < Hash
+  def initialize(hash, default=nil, **options, &default_block)
+    unless hash.kind_of?(Hash)
+      raise ArgumentError.new("first argument must be a hash!")
+    end
+
+    @freeze     = options.fetch(:freeze, true)
+    @processors = options.fetch(:processors, [])
+    if !(@processors.is_a?(Array) && @processors.all? { |p| p.is_a?(Proc) || p.is_a?(Method) })
+      raise ArgumentError.new("processors must be a list of callables!")
+    end
+    # allow default processors to be assigned by those method names specially.
+    ConfigHash::Processors.methods(false).each do |proc|
+      @processors << ConfigHash::Processors.method(proc) if options[proc]
+    end
+
+    super(default, &default_block)
+
+    # recursively construct this hash from the passed in hash.
+    hash.each do |key, value|
+      key = key.is_a?(String) ? key.to_sym : key # force strings to symbols
+      self[construct(key)] = construct(value)
+
+      if key.is_a? Symbol # allow '.' notation for symbol keys.
+        self.instance_eval("def #{key}; process(self[:#{key}]); end")
+      end
+    end
+
+    self.freeze if @freeze
+  end
+
+  def [](key, in_process=false)
+    key = key.is_a?(String) ? key.to_sym : key
+    return super(key) if in_process
+
+    process(self.send(:[], key, true)) # make sure to process reutrn values
+  end
+
+  def method_missing(method, *args)
+    return super(method, *args) if @freeze
+
+    # if we're not freezing, we can allow assignment and expect nil results.
+    if method =~ /^(.*)=$/ && args.length == 1
+      key = method.to_s.tr('=', '').to_sym
+      self[key] = args[0]
+      self.instance_eval("def #{key}; process(self[:#{key}]); end")
+    else
+      nil # it's a non-defined value.
+    end
+  end
+
+  def delete(key, &blk)
+    return super(key, &blk) if @freeze
+
+    key = key.is_a?(String) ? key.to_sym : key
+    instance_eval("undef #{key}") if respond_to?(key)
+    super(key, &blk)
+  end
+
+  private
+
+  def process(value)
+    @processors.reduce(value) { |modified, proc| proc.call(modified) }
+  end
+
+  def construct(value)
+    case value
+      when ConfigHash then value
+      when Hash       then ConfigHash.new(
+        value,
+        value.default,
+        freeze: @freeze, processors: @processors,
+        &value.default_proc
+      )
+      when Array      then dup_if_appropriate(value).map { |sv| construct(sv) }
+      else                 dup_if_appropriate(value)
+    end.tap { |calced| calced.freeze if @freeze }
+  end
+
+  def dup_if_appropriate(v)
+    # if it is a class, module, or proc, DO NOT DUP
+    return v if [Class, Module, Proc].any? { |kls| v.instance_of?(kls) }
+    v.dup rescue v # on symbol, integer just return value
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: config_hash
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Zach Lome
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description: A safe hash that can process values and use dot notation.
+email:
+- zslome@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/config_hash.rb
+- lib/config_hash/processors.rb
+homepage: https://github.com/kuraiou/config_hash
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: a hash built for configurations.
+test_files: []
+has_rdoc: