facets 2.4.2 → 2.4.3

data/doc/rdoc/more/classes/Fileable.html

@@ -90,9 +90,9 @@ NOTE: This is an expiremental library, and is still
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000636">included</a></li>
-  <li><a href="#M000637">new</a></li>
-  <li><a href="#M000638">read</a></li>
+  <li><a href="#M000664">included</a></li>
+  <li><a href="#M000665">new</a></li>
+  <li><a href="#M000666">read</a></li>
   </ul>
 
 
@@ -106,17 +106,17 @@ NOTE: This is an expiremental library, and is still
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000636"></a><b>included</b>(base)
+    <a name="M000664"></a><b>included</b>(base)
   </div>
   <div class="description">
   <p>
-When <a href="Fileable.html#M000636">included</a> extend <a
+When <a href="Fileable.html#M000664">included</a> extend <a
 href="Fileable/DSL.html">DSL</a> too.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000636_source')" id="l_M000636_source">show source</a> ]</p>
-  <div id="M000636_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000664_source')" id="l_M000664_source">show source</a> ]</p>
+  <div id="M000664_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 50</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">included</span>(<span class="ruby-identifier">base</span>)
@@ -128,18 +128,18 @@ href="Fileable/DSL.html">DSL</a> too.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000637"></a><b>new</b>(content)
+    <a name="M000665"></a><b>new</b>(content)
   </div>
   <div class="description">
   <p>
 New fileable object. By default this is called by <a
-href="Fileable.html#M000638">read</a> passing the file contents. Override
+href="Fileable.html#M000666">read</a> passing the file contents. Override
 it if need is differnt.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000637_source')" id="l_M000637_source">show source</a> ]</p>
-  <div id="M000637_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000665_source')" id="l_M000665_source">show source</a> ]</p>
+  <div id="M000665_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 62</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">content</span>)
@@ -152,7 +152,7 @@ it if need is differnt.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000638"></a><b>read</b>(file)
+    <a name="M000666"></a><b>read</b>(file)
   </div>
   <div class="description">
   <p>
@@ -160,8 +160,8 @@ Override this if reading is differnt.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000638_source')" id="l_M000638_source">show source</a> ]</p>
-  <div id="M000638_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000666_source')" id="l_M000666_source">show source</a> ]</p>
+  <div id="M000666_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 68</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">file</span>)

data/doc/rdoc/more/classes/Fileable/DSL.html

@@ -74,14 +74,14 @@
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000645">file</a></li>
-  <li><a href="#M000640">filename</a></li>
-  <li><a href="#M000639">included</a></li>
-  <li><a href="#M000642">load</a></li>
-  <li><a href="#M000646">load_cache</a></li>
-  <li><a href="#M000644">locate</a></li>
-  <li><a href="#M000643">lookup</a></li>
-  <li><a href="#M000641">open</a></li>
+  <li><a href="#M000673">file</a></li>
+  <li><a href="#M000668">filename</a></li>
+  <li><a href="#M000667">included</a></li>
+  <li><a href="#M000670">load</a></li>
+  <li><a href="#M000674">load_cache</a></li>
+  <li><a href="#M000672">locate</a></li>
+  <li><a href="#M000671">lookup</a></li>
+  <li><a href="#M000669">open</a></li>
   </ul>
 
 
@@ -92,18 +92,18 @@
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000645"></a><b>file</b>(path=nil)
+    <a name="M000673"></a><b>file</b>(path=nil)
   </div>
   <div class="description">
   <p>
-Find <a href="DSL.html#M000645">file</a>. The <tt>path</tt> has to be
+Find <a href="DSL.html#M000673">file</a>. The <tt>path</tt> has to be
 either the exact path or the directory where a standard-named <a
-href="DSL.html#M000645">file</a> resides.
+href="DSL.html#M000673">file</a> resides.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000645_source')" id="l_M000645_source">show source</a> ]</p>
-  <div id="M000645_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000673_source')" id="l_M000673_source">show source</a> ]</p>
+  <div id="M000673_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 140</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">file</span>(<span class="ruby-identifier">path</span>=<span class="ruby-keyword kw">nil</span>)
@@ -126,17 +126,17 @@ href="DSL.html#M000645">file</a> resides.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000640"></a><b>filename</b>()
+    <a name="M000668"></a><b>filename</b>()
   </div>
   <div class="description">
   <p>
 Override this with the name or name-glob of the default <a
-href="DSL.html#M000645">file</a>. If no default, return nil.
+href="DSL.html#M000673">file</a>. If no default, return nil.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000640_source')" id="l_M000640_source">show source</a> ]</p>
-  <div id="M000640_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000668_source')" id="l_M000668_source">show source</a> ]</p>
+  <div id="M000668_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 86</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">filename</span>; <span class="ruby-keyword kw">nil</span>; <span class="ruby-keyword kw">end</span>
@@ -146,7 +146,7 @@ href="DSL.html#M000645">file</a>. If no default, return nil.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000639"></a><b>included</b>(base)
+    <a name="M000667"></a><b>included</b>(base)
   </div>
   <div class="description">
   <p>
@@ -155,8 +155,8 @@ the <a href="DSL.html">DSL</a> inheritance going.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000639_source')" id="l_M000639_source">show source</a> ]</p>
-  <div id="M000639_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000667_source')" id="l_M000667_source">show source</a> ]</p>
+  <div id="M000667_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 79</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">included</span>(<span class="ruby-identifier">base</span>)
@@ -168,19 +168,19 @@ the <a href="DSL.html">DSL</a> inheritance going.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000642"></a><b>load</b>(path_or_data)
+    <a name="M000670"></a><b>load</b>(path_or_data)
   </div>
   <div class="description">
   <p>
 An initializer that can take either a File, Pathname or raw data. This
 works much like YAML::load does. Unlike <tt><a
-href="DSL.html#M000641">open</a></tt>, <tt><a
-href="DSL.html#M000642">load</a></tt> requires an exact path parameter.
+href="DSL.html#M000669">open</a></tt>, <tt><a
+href="DSL.html#M000670">load</a></tt> requires an exact path parameter.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000642_source')" id="l_M000642_source">show source</a> ]</p>
-  <div id="M000642_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000670_source')" id="l_M000670_source">show source</a> ]</p>
+  <div id="M000670_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 103</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load</span>(<span class="ruby-identifier">path_or_data</span>)
@@ -199,17 +199,17 @@ href="DSL.html#M000642">load</a></tt> requires an exact path parameter.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000646"></a><b>load_cache</b>()
+    <a name="M000674"></a><b>load_cache</b>()
   </div>
   <div class="description">
   <p>
 Load cache. PackageInfo is multiton when loaded by <a
-href="DSL.html#M000645">file</a>.
+href="DSL.html#M000673">file</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000646_source')" id="l_M000646_source">show source</a> ]</p>
-  <div id="M000646_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000674_source')" id="l_M000674_source">show source</a> ]</p>
+  <div id="M000674_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 157</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load_cache</span>
@@ -221,16 +221,16 @@ href="DSL.html#M000645">file</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000644"></a><b>locate</b>(name=nil)
+    <a name="M000672"></a><b>locate</b>(name=nil)
   </div>
   <div class="description">
   <p>
-Locate <a href="DSL.html#M000645">file</a> (case insensitive).
+Locate <a href="DSL.html#M000673">file</a> (case insensitive).
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000644_source')" id="l_M000644_source">show source</a> ]</p>
-  <div id="M000644_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000672_source')" id="l_M000672_source">show source</a> ]</p>
+  <div id="M000672_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 123</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">locate</span>(<span class="ruby-identifier">name</span>=<span class="ruby-keyword kw">nil</span>)
@@ -251,16 +251,16 @@ Locate <a href="DSL.html#M000645">file</a> (case insensitive).
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000643"></a><b>lookup</b>(name=nil)
+    <a name="M000671"></a><b>lookup</b>(name=nil)
   </div>
   <div class="description">
   <p>
-Lookup <a href="DSL.html#M000645">file</a>.
+Lookup <a href="DSL.html#M000673">file</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000643_source')" id="l_M000643_source">show source</a> ]</p>
-  <div id="M000643_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000671_source')" id="l_M000671_source">show source</a> ]</p>
+  <div id="M000671_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 116</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lookup</span>(<span class="ruby-identifier">name</span>=<span class="ruby-keyword kw">nil</span>)
@@ -273,16 +273,16 @@ Lookup <a href="DSL.html#M000645">file</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000641"></a><b>open</b>(path=nil)
+    <a name="M000669"></a><b>open</b>(path=nil)
   </div>
   <div class="description">
   <p>
-Load from <a href="DSL.html#M000645">file</a>(s).
+Load from <a href="DSL.html#M000673">file</a>(s).
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000641_source')" id="l_M000641_source">show source</a> ]</p>
-  <div id="M000641_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000669_source')" id="l_M000669_source">show source</a> ]</p>
+  <div id="M000669_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/fileable.rb, line 90</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>=<span class="ruby-keyword kw">nil</span>)

data/doc/rdoc/more/classes/Hash.html

@@ -57,6 +57,8 @@
       <tr valign="top">
         <td>In:</td>
         <td>
+<a href="../files/lib/more/facets/hash/symbolize_keys_rb.html">lib/more/facets/hash/symbolize_keys.rb</a>
+<a href="../files/lib/more/facets/hash/symbolize_keys_rb.html">lib/more/facets/hash/symbolize_keys.rb</a>
 <a href="../files/lib/more/facets/xmlhash_rb.html">lib/more/facets/xmlhash.rb</a>
 <a href="../files/lib/more/facets/snapshot_rb.html">lib/more/facets/snapshot.rb</a>
 <a href="../files/lib/more/facets/openobject_rb.html">lib/more/facets/openobject.rb</a>
@@ -83,10 +85,18 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000271">restore_snapshot</a></li>
-  <li><a href="#M000270">take_snapshot</a></li>
-  <li><a href="#M000272">to_openobject</a></li>
-  <li><a href="#M000269">to_xml</a></li>
+  <li><a href="#M000280">restore_snapshot</a></li>
+  <li><a href="#M000276">stringify_keys</a></li>
+  <li><a href="#M000272">stringify_keys</a></li>
+  <li><a href="#M000273">stringify_keys!</a></li>
+  <li><a href="#M000277">stringify_keys!</a></li>
+  <li><a href="#M000270">symbolize_keys</a></li>
+  <li><a href="#M000274">symbolize_keys</a></li>
+  <li><a href="#M000275">symbolize_keys!</a></li>
+  <li><a href="#M000271">symbolize_keys!</a></li>
+  <li><a href="#M000279">take_snapshot</a></li>
+  <li><a href="#M000281">to_openobject</a></li>
+  <li><a href="#M000278">to_xml</a></li>
   </ul>
 
 <div class="sectiontitle">Included Modules</div>
@@ -101,11 +111,11 @@ Object
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000271"></a><b>restore_snapshot</b>(snap)
+    <a name="M000280"></a><b>restore_snapshot</b>(snap)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">show source</a> ]</p>
-  <div id="M000271_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000280_source')" id="l_M000280_source">show source</a> ]</p>
+  <div id="M000280_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/snapshot.rb, line 195</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">restore_snapshot</span>(<span class="ruby-identifier">snap</span>) <span class="ruby-identifier">replace</span>(<span class="ruby-identifier">snap</span>) <span class="ruby-keyword kw">end</span>
@@ -115,12 +125,294 @@ Object
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000270"></a><b>take_snapshot</b>()
+    <a name="M000276"></a><b>stringify_keys</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to Strings, returning
+a new <a href="Hash.html">Hash</a>. With a <tt>filter</tt> parameter,
+limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.stringify_keys    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect           #=&gt;  { :name =&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000276_source')" id="l_M000276_source">show source</a> ]</p>
+  <div id="M000276_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 59</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000272"></a><b>stringify_keys</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to Strings, returning
+a new <a href="Hash.html">Hash</a>. With a <tt>filter</tt> parameter,
+limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.stringify_keys    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect           #=&gt;  { :name =&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">show source</a> ]</p>
+  <div id="M000272_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 59</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000273"></a><b>stringify_keys!</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Synonym for <a href="Hash.html#M000272">Hash#stringify_keys</a>, but
+modifies the receiver in place and returns it. With a <tt>filter</tt>
+parameter, limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.stringify_keys!    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect            #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000273_source')" id="l_M000273_source">show source</a> ]</p>
+  <div id="M000273_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 78</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000277"></a><b>stringify_keys!</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Synonym for <a href="Hash.html#M000272">Hash#stringify_keys</a>, but
+modifies the receiver in place and returns it. With a <tt>filter</tt>
+parameter, limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.stringify_keys!    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect            #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000277_source')" id="l_M000277_source">show source</a> ]</p>
+  <div id="M000277_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 78</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000270"></a><b>symbolize_keys</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to Symbols, returning
+a new <a href="Hash.html">Hash</a>. With a <tt>filter</tt>, limits
+conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.symbolize_keys    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect           #=&gt;  { &quot;name&quot; =&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
   </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000270_source')" id="l_M000270_source">show source</a> ]</p>
   <div id="M000270_source" class="dyn-source">
 <pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 14</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000274"></a><b>symbolize_keys</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to Symbols, returning
+a new <a href="Hash.html">Hash</a>. With a <tt>filter</tt>, limits
+conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.symbolize_keys    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect           #=&gt;  { &quot;name&quot; =&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000274_source')" id="l_M000274_source">show source</a> ]</p>
+  <div id="M000274_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 14</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000275"></a><b>symbolize_keys!</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Synonym for <a href="Hash.html#M000270">Hash#symbolize_keys</a>, but
+modifies the receiver in place and returns it. With a <tt>filter</tt>
+parameter, limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { 'name'=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.symbolize_keys!    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect            #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000275_source')" id="l_M000275_source">show source</a> ]</p>
+  <div id="M000275_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 39</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> }
+    <span class="ruby-keyword kw">end</span>
+
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000271"></a><b>symbolize_keys!</b>(&amp;filter)
+  </div>
+  <div class="description">
+  <p>
+Synonym for <a href="Hash.html#M000270">Hash#symbolize_keys</a>, but
+modifies the receiver in place and returns it. With a <tt>filter</tt>
+parameter, limits conversion to only a certain selection of keys.
+</p>
+<pre>
+  foo = { 'name'=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.symbolize_keys!    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect            #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+<p>
+This method is considered archaic. Use rekey instead.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">show source</a> ]</p>
+  <div id="M000271_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/hash/symbolize_keys.rb, line 39</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filter</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">filter</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span> }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">rekey!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span> }
+    <span class="ruby-keyword kw">end</span>
+
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000279"></a><b>take_snapshot</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000279_source')" id="l_M000279_source">show source</a> ]</p>
+  <div id="M000279_source" class="dyn-source">
+<pre>
 <span class="ruby-comment cmt"># File lib/more/facets/snapshot.rb, line 194</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">take_snapshot</span>() <span class="ruby-identifier">dup</span> <span class="ruby-keyword kw">end</span>
 </pre>
@@ -129,7 +421,7 @@ Object
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000272"></a><b>to_openobject</b>()
+    <a name="M000281"></a><b>to_openobject</b>()
   </div>
   <div class="description">
   <p>
@@ -138,8 +430,8 @@ href="OpenObject.html">OpenObject</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">show source</a> ]</p>
-  <div id="M000272_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000281_source')" id="l_M000281_source">show source</a> ]</p>
+  <div id="M000281_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/openobject.rb, line 236</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_openobject</span>
@@ -151,11 +443,11 @@ href="OpenObject.html">OpenObject</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000269"></a><b>to_xml</b>(root='root')
+    <a name="M000278"></a><b>to_xml</b>(root='root')
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000269_source')" id="l_M000269_source">show source</a> ]</p>
-  <div id="M000269_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000278_source')" id="l_M000278_source">show source</a> ]</p>
+  <div id="M000278_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/xmlhash.rb, line 67</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_xml</span>(<span class="ruby-identifier">root</span>=<span class="ruby-value str">'root'</span>)