Sha256: 2c2c6a229f28149401ea179a558679f4dd75f25018cde18389899c7cf50f9541

Contents?: true

Size: 1.85 KB

Versions: 50

Compression:

Stored size: 1.85 KB

Contents

module ActiveSupport #:nodoc:
  module CoreExtensions #:nodoc:
    module Hash #:nodoc:
      module Keys
        # Return a new hash with all keys converted to strings.
        def stringify_keys
          inject({}) do |options, (key, value)|
            options[key.to_s] = value
            options
          end
        end

        # Destructively convert all keys to strings.
        def stringify_keys!
          keys.each do |key|
            self[key.to_s] = delete(key)
          end
          self
        end

        # Return a new hash with all keys converted to symbols.
        def symbolize_keys
          inject({}) do |options, (key, value)|
            options[(key.to_sym rescue key) || key] = value
            options
          end
        end

        # Destructively convert all keys to symbols.
        def symbolize_keys!
          self.replace(self.symbolize_keys)
        end

        alias_method :to_options,  :symbolize_keys
        alias_method :to_options!, :symbolize_keys!

        # Validate all keys in a hash match *valid keys, raising ArgumentError on a mismatch.
        # Note that keys are NOT treated indifferently, meaning if you use strings for keys but assert symbols
        # as keys, this will fail.
        #
        # ==== Examples:
        #   { :name => "Rob", :years => "28" }.assert_valid_keys(:name, :age) # => raises "ArgumentError: Unknown key(s): years"
        #   { :name => "Rob", :age => "28" }.assert_valid_keys("name", "age") # => raises "ArgumentError: Unknown key(s): name, age"
        #   { :name => "Rob", :age => "28" }.assert_valid_keys(:name, :age) # => passes, raises nothing
        def assert_valid_keys(*valid_keys)
          unknown_keys = keys - [valid_keys].flatten
          raise(ArgumentError, "Unknown key(s): #{unknown_keys.join(", ")}") unless unknown_keys.empty?
        end
      end
    end
  end
end

Version data entries

50 entries across 49 versions & 16 rubygems

Version Path
activesupport-2.0.5 lib/active_support/core_ext/hash/keys.rb
activesupport-2.0.4 lib/active_support/core_ext/hash/keys.rb
activesupport-2.1.1 lib/active_support/core_ext/hash/keys.rb
antfarm-0.3.0 rails/vendor/rails/activesupport/lib/active_support/core_ext/hash/keys.rb
antfarm-0.4.0 rails/vendor/rails/activesupport/lib/active_support/core_ext/hash/keys.rb
mack-active_record-0.8.2 lib/gems/activesupport-2.2.2/lib/active_support/core_ext/hash/keys.rb
mack-facets-0.8.3.1 lib/gems/activesupport-2.2.2/lib/active_support/core_ext/hash/keys.rb
mack-facets-0.8.3 lib/gems/activesupport-2.2.2/lib/active_support/core_ext/hash/keys.rb
radiant-0.7.0 vendor/rails/activesupport/lib/active_support/core_ext/hash/keys.rb
radiant-0.7.1 vendor/rails/activesupport/lib/active_support/core_ext/hash/keys.rb