Why the &*#^@*^&$ isn‘t HashWithIndifferentAccess actually doing this?

[Source]

# File lib/rconfig/config_hash.rb, line 62
    def [](key)
      key = key.to_s if key.kind_of?(Symbol)
      super(key)
    end

Override WithIndifferentAccess#convert_value return instances of this class for Hash values.

[Source]

# File lib/rconfig/config_hash.rb, line 100
  def convert_value(value)
    # STDERR.puts "convert_value(#{value.inspect}:#{value.class})"
    value.class == Hash ? self.class.new(value).freeze : value
  end

[Source]

# File lib/rconfig/config_hash.rb, line 74
  def default(key = @@no_key)
    key = key.to_s if key.is_a?(Symbol)
    key == @@no_key ? self['default'] : default_Hash(key == @@no_key ? nil : key)
  end

HashWithIndifferentAccess#dup always returns HashWithIndifferentAccess!

[Source]

# File lib/rconfig/config_hash.rb, line 12
  def dup
    self.class.new(self)
  end

Dotted notation can be used with arguments (useful for creating mock objects) in the YAML file the method name is a key, argument(s) form a nested key, so that the correct value is retrieved and returned.

For example loading to variable foo a yaml file that looks like: customer:

  id: 12345678
  verified:
    phone: verified
    :address: info_not_available
    ? [name, employer]
    : not_verified

Allows the following calls: foo.customer.id => 12345678 foo.customer.verified.phone => verified foo.customer.verified("phone") => verified foo.customer.verified(:address) => info_not_available foo.customer.verified("name", "employer") => not_verified

Note that :address is specified as a symbol, where phone is just a string. Depending on what kind of parameter the method being mocked out is going to be called with, define in the YAML file either a string or a symbol. This also works inside the composite array keys.

[Source]

# File lib/rconfig/config_hash.rb, line 41
  def method_missing(method, *args)
    method = method.to_s
    # STDERR.puts "CHF#method_missing(#{method.inspect}, #{args.inspect}) on #{self.inspect}:#{self.class}" if method == 'dup'
    value = self[method]
      case args.size
        when 0
          # e.g.: RConfig.application.method
          ;
        when 1
          # e.g.: RConfig.application.method(one_arg)
          value = value.send(args[0])
        else
          # e.g.: RConfig.application.method(arg_one, args_two, ...)
          value = value[args]
      end
      # value =  convert_value(value)
      value
    end

HashWithIndifferentAccess#update is broken! Hash#update returns self, BUT, HashWithIndifferentAccess#update does not!

  { :a => 1 }.update({ :b => 2, :c => 3 })
  => { :a => 1, :b => 2, :c => 3 }

  HashWithIndifferentAccess.new({ :a => 1 }).update({ :b => 2, :c => 3 })
  => { :b => 2, :c => 3 } # WTF?

Subclasses should never override methods and break their protocols!!!!

[Source]

# File lib/rconfig/config_hash.rb, line 92
  def update(hash)
    super(hash)
    self
  end