Module: Treequel::HashUtilities

Included in:

Branch, Directory, Model::Errors, Model::ObjectClass

Defined in:

lib/treequel/mixins.rb

Overview

A collection of utilities for working with Hashes.

Class Method Summary

• .merge_recursively(key, oldval, newval) ⇒ Object

  Recursive hash-merge function.

• .normalize_attributes(hash) ⇒ Object

  Normalize the attributes in hash to be of the form expected by the LDAP library (i.e., keys as Strings, values as Arrays of Strings).

• .stringify_keys(hash) ⇒ Object

  Return a version of the given hash with its keys transformed into Strings from whatever they were before.

• .symbolify_keys(hash) ⇒ Object (also: internify_keys)

  Return a duplicate of the given hash with its identifier-like keys transformed into symbols from whatever they were before.

Class Method Details

.merge_recursively(key, oldval, newval) ⇒ Object

Recursive hash-merge function

# File 'lib/treequel/mixins.rb', line 207

def merge_recursively( key, oldval, newval )
	case oldval
	when Hash
		case newval
		when Hash
			oldval.merge( newval, &method(:merge_recursively) )
		else
			newval
		end

	when Array
		case newval
		when Array
			oldval | newval
		else
			newval
		end

	else
		newval
	end
end

.normalize_attributes(hash) ⇒ Object

Normalize the attributes in hash to be of the form expected by the LDAP library (i.e., keys as Strings, values as Arrays of Strings)

# File 'lib/treequel/mixins.rb', line 232

def normalize_attributes( hash )
	normhash = {}
	hash.each do |key,val|
		val = [ val ] unless val.is_a?( Array )
		val.collect! {|obj| obj.to_s }

		normhash[ key.to_s ] = val
	end

	normhash.delete( 'dn' )

	return normhash
end

.stringify_keys(hash) ⇒ Object

Return a version of the given hash with its keys transformed into Strings from whatever they were before.

# File 'lib/treequel/mixins.rb', line 171

def stringify_keys( hash )
	newhash = {}

	hash.each do |key,val|
		if val.is_a?( Hash )
			newhash[ key.to_s ] = stringify_keys( val )
		else
			newhash[ key.to_s ] = val
		end
	end

	return newhash
end

.symbolify_keys(hash) ⇒ Object Also known as: internify_keys

Return a duplicate of the given hash with its identifier-like keys transformed into symbols from whatever they were before.

# File 'lib/treequel/mixins.rb', line 188

def symbolify_keys( hash )
	newhash = {}

	hash.each do |key,val|
		keysym = key.to_s.dup.untaint.to_sym

		if val.is_a?( Hash )
			newhash[ keysym ] = symbolify_keys( val )
		else
			newhash[ keysym ] = val
		end
	end

	return newhash
end