yaxml 0.0.7

data/CHANGELOG

@@ -0,0 +1,8 @@
+= 1.0
+=== 25th March, 2009
+* First stable version
+* Conversion YAML -> YAXML
+* Conversion JSON -> YAXML
+* Conversion YAXML -> YAML
+* Conversion YAXML -> JSON
+* Module accepts strings and file names as sources.

data/LICENSE

@@ -0,0 +1,165 @@
+		   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions. 
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version. 
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README

@@ -0,0 +1,49 @@
+= YAXML Module
+ 
+This code is released under LGPL. YAXML module make the next conversions:
+
+ * YAML -> YAXML
+ * JSON -> YAXML
+ * YAXML -> YAML
+ * YAXML -> JSON
+
+All conversions can use a file or a string as source.
+
+You can use this module in two ways:
+
+1) Creating a Yaxml object
+   xml = Yaxml.new 'file.yml'
+   xml.write( $stdout, 2)
+   xml.to_json
+   xml.to_yaml
+
+2) Using static methods of Yaxml module
+   xml = Yaxml::yaml2yaxml( 'file.yml' )
+   xml.write( $stdout, 2)
+
+   Also, you can use:
+   xml  = Yaxml::json2yaxml( { numbers: [ 1, 2, 3 ]} )
+   yaml = Yaxml::yaxml2yaml( 'file.yaxml' )
+   json = Yaxml::yaxml2json( 'file.yaxml' )
+
+YAXML is <b>standalone library</b>.  It requires no other libraries.  Just Ruby!
+
+Author:: Diego Moreno (dmoreno@dit.upm.es)
+License:: GNU Lesser General Public License (aka LGPL)
+
+== Installing YAXML
+
+You may get the latest stable version from Rubyforge.
+
+  $ gem install yaxml
+
+== Loading YAXML
+
+You have probably got the gem, right?  To load YAXML:
+
+ require 'rubygems'
+ require 'yaxml'
+
+If you've installed the plain source distribution, go ahead and just:
+
+ require 'yaxml'

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'fileutils'
+include FileUtils
+
+NAME = "yaxml"
+REV = `svn info`[/Revision: (\d+)/, 1] rescue nil
+VERS = ENV['VERSION'] || "0.0.7" + (REV ? ".#{REV}" : "")
+PKG = "#{NAME}-#{VERS}"
+RDOC_OPTS = ['--quiet', '--title', 'The YAXML Module Reference', '--main', 'README', '--inline-source']
+PKG_FILES = %w(CHANGELOG LICENSE README Rakefile) + Dir.glob("{doc,test,lib}/**/*") 
+
+SPEC =
+  Gem::Specification.new do |s|
+    s.name = NAME
+    s.version = VERS
+    s.platform = Gem::Platform::RUBY
+    s.has_rdoc = true
+    s.rdoc_options += RDOC_OPTS
+    s.extra_rdoc_files = ["README", "CHANGELOG", "LICENSE"]
+    s.summary = "Library to manage YAXML files"
+    s.description = s.summary
+    s.author = "Diego Moreno"
+    s.email = 'dmoreno@dit.upm.es'
+    s.homepage = 'http://yaxml.rubyforge.com/'
+    s.files = PKG_FILES
+    s.require_paths = ["lib"]
+#    s.bindir = "bin"
+  end
+
+desc "Does a test run"
+task :default => [:test]
+
+Rake::GemPackageTask.new(SPEC) do |pkg| 
+  pkg.need_tar = true 
+end
+
+desc "Run all the tests"
+Rake::TestTask.new do |t|
+    t.libs << "test"
+    t.test_files = FileList['test/test_*.rb']
+    t.verbose = true
+end
+
+Rake::RDocTask.new do |rdoc|
+    rdoc.rdoc_dir = 'doc/rdoc'
+    rdoc.options += RDOC_OPTS
+    rdoc.main = "README"
+    rdoc.rdoc_files.add ['README', 'CHANGELOG', 'LICENSE', 'lib/*.rb']
+end

data/doc/rdoc/classes/YAXML.html

@@ -0,0 +1,465 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: YAXML</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">YAXML</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/yaxml_rb.html">
+                lib/yaxml.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000002">json2yaxml</a>&nbsp;&nbsp;
+      <a href="#M000001">yaml2yaxml</a>&nbsp;&nbsp;
+      <a href="#M000004">yaxml2json</a>&nbsp;&nbsp;
+      <a href="#M000003">yaxml2yaml</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Class <a href="YAXML/Yaxml.html" class="link">YAXML::Yaxml</a><br />
+
+    </div>
+
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_ROOT_NAME</td>
+          <td>=</td>
+          <td class="context-item-value">&quot;root&quot;</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Default root name
+
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE</td>
+          <td>=</td>
+          <td class="context-item-value">&quot;http://yaml.org/xml&quot;</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Namespace for <a href="YAXML.html">YAXML</a>
+
+</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000002" class="method-detail">
+        <a name="M000002"></a>
+
+        <div class="method-heading">
+          <a href="#M000002" class="method-signature">
+          <span class="method-name">json2yaxml</span><span class="method-args">( json_to_encode, options={} )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Conversion JSON -&gt; <a href="YAXML.html">YAXML</a>
+</p>
+<table>
+<tr><td valign="top">source:</td><td>It can be a Array or Hash object or a file name.
+
+</td></tr>
+</table>
+<p>
+options::
+</p>
+<ul>
+<li><tt>:root_name</tt> It is the name of the root tag in the <a
+href="YAXML.html">YAXML</a> document. Defaults to
+<tt>DEFAULT_ROOT_NAME</tt>
+
+</li>
+</ul>
+<p>
+Example of use:
+</p>
+<pre>
+  json = {&quot;one&quot; =&gt; 1, &quot;two&quot; =&gt; 2.0, &quot;three&quot; =&gt; [ &quot;apple&quot;, &quot;pear&quot;], &quot;four&quot; =&gt; {&quot;aa&quot; =&gt; 11, &quot;bb&quot; =&gt; 22}}
+  doc = YAXML.json2yaxml json
+  doc.write( $stdout, 2 )
+  #-&gt; &lt;root xmlns:yaml='http://yaml.org/xml'&gt;
+        &lt;three&gt;
+          &lt;_&gt;apple&lt;/_&gt;
+          &lt;_&gt;pear&lt;/_&gt;
+        &lt;/three&gt;
+        &lt;two&gt;2.0&lt;/two&gt;
+        &lt;one&gt;1&lt;/one&gt;
+        &lt;four&gt;
+          &lt;bb&gt;22&lt;/bb&gt;
+          &lt;aa&gt;11&lt;/aa&gt;
+        &lt;/four&gt;
+      &lt;/root&gt;
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000002-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/yaxml.rb, line 190</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">json2yaxml</span>( <span class="ruby-identifier">json_to_encode</span>, <span class="ruby-identifier">options</span>={} )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">json_to_encode</span>
+    
+    <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:root_name</span>] <span class="ruby-operator">||=</span> <span class="ruby-constant">DEFAULT_ROOT_NAME</span>
+    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:parent</span>]
+      <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:parent</span>] = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Element</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:root_name</span>]
+      <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:parent</span>].<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;xmlns:yaml&quot;</span>] = <span class="ruby-constant">NAMESPACE</span>
+    <span class="ruby-keyword kw">end</span>
+    
+    <span class="ruby-identifier">parent</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:parent</span>]
+    
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span><span class="ruby-constant">Hash</span>
+      <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span> <span class="ruby-operator">|</span>
+        <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">is_a?</span><span class="ruby-constant">Symbol</span>
+        <span class="ruby-identifier">el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Element</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>
+        <span class="ruby-identifier">result</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">json2yaxml</span>( <span class="ruby-identifier">value</span>, {<span class="ruby-identifier">:parent</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">el</span>} )
+        <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add</span> <span class="ruby-identifier">result</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>
+      <span class="ruby-keyword kw">end</span>
+     
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span><span class="ruby-constant">Array</span>
+      <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">x</span> <span class="ruby-operator">|</span>
+        <span class="ruby-identifier">el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Element</span>.<span class="ruby-identifier">new</span> <span class="ruby-value str">&quot;_&quot;</span>
+        <span class="ruby-identifier">result</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">json2yaxml</span>( <span class="ruby-identifier">x</span>, {<span class="ruby-identifier">:parent</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">el</span>})
+        <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add</span> <span class="ruby-identifier">result</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>
+      <span class="ruby-keyword kw">end</span>
+      
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span><span class="ruby-constant">String</span>
+      <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">text</span> = <span class="ruby-identifier">json_to_encode</span>
+
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Integer</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Float</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Date</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Symbol</span>)
+      <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">text</span> = <span class="ruby-identifier">json_to_encode</span>.<span class="ruby-identifier">to_s</span>
+     
+    <span class="ruby-keyword kw">end</span>
+     
+    <span class="ruby-identifier">parent</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000001" class="method-detail">
+        <a name="M000001"></a>
+
+        <div class="method-heading">
+          <a href="#M000001" class="method-signature">
+          <span class="method-name">yaml2yaxml</span><span class="method-args">( source, options={} )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Conversion YAML -&gt; <a href="YAXML.html">YAXML</a>
+</p>
+<table>
+<tr><td valign="top">source:</td><td>It can be a YAML file in a String or a file name.
+
+</td></tr>
+</table>
+<p>
+options::
+</p>
+<ul>
+<li><tt>:root_name</tt> It is the name of the root tag in the <a
+href="YAXML.html">YAXML</a> document. Defaults to
+<tt>DEFAULT_ROOT_NAME</tt>
+
+</li>
+</ul>
+<p>
+Example of use:
+</p>
+<pre>
+  test.yml content
+     one: 1
+     two: 2.0
+     three:
+       - apple
+       - pear
+     four:
+       aa: 11
+       bb: 22
+
+  doc = YAXML.yaml2yaxml &quot;test.yml&quot;
+  doc.write( $stdout, 2 )
+  #-&gt; &lt;root xmlns:yaml='http://yaml.org/xml'&gt;
+        &lt;three&gt;
+          &lt;_&gt;apple&lt;/_&gt;
+          &lt;_&gt;pear&lt;/_&gt;
+        &lt;/three&gt;
+        &lt;two&gt;2.0&lt;/two&gt;
+        &lt;one&gt;1&lt;/one&gt;
+        &lt;four&gt;
+          &lt;bb&gt;22&lt;/bb&gt;
+          &lt;aa&gt;11&lt;/aa&gt;
+        &lt;/four&gt;
+      &lt;/root&gt;
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000001-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/yaxml.rb, line 145</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaml2yaxml</span>( <span class="ruby-identifier">source</span>, <span class="ruby-identifier">options</span>={} )
+
+    <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:root_name</span>] <span class="ruby-operator">||=</span> <span class="ruby-constant">DEFAULT_ROOT_NAME</span>
+
+    <span class="ruby-identifier">json</span> = <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">is_a?</span><span class="ruby-constant">String</span>
+             <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span><span class="ruby-identifier">source</span>
+               <span class="ruby-constant">YAML</span><span class="ruby-operator">::</span><span class="ruby-identifier">load_file</span>( <span class="ruby-identifier">source</span> ) <span class="ruby-comment cmt"># is a file</span>
+             <span class="ruby-keyword kw">else</span>
+               <span class="ruby-constant">YAML</span><span class="ruby-operator">::</span><span class="ruby-identifier">load</span>( <span class="ruby-identifier">source</span> ) <span class="ruby-comment cmt"># is a string</span>
+             <span class="ruby-keyword kw">end</span>
+           <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
+             <span class="ruby-identifier">source</span>
+           <span class="ruby-keyword kw">end</span>
+
+    <span class="ruby-identifier">el</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">json2yaxml</span>( <span class="ruby-identifier">json</span>, <span class="ruby-identifier">options</span> )
+    <span class="ruby-identifier">doc</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Document</span>.<span class="ruby-identifier">new</span>
+    <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">add_element</span> <span class="ruby-identifier">el</span>
+    <span class="ruby-identifier">doc</span>
+
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
+
+        <div class="method-heading">
+          <a href="#M000004" class="method-signature">
+          <span class="method-name">yaxml2json</span><span class="method-args">( source )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Conversion <a href="YAXML.html">YAXML</a> -&gt; JSON
+</p>
+<table>
+<tr><td valign="top">source:</td><td>It can be a <a href="YAXML.html">YAXML</a> file in a String or a file name.
+
+</td></tr>
+</table>
+<p>
+Example of use:
+</p>
+<pre>
+  test.xml content
+      &lt;root xmlns:yaml='http://yaml.org/xml'&gt;
+        &lt;three&gt;
+          &lt;_&gt;apple&lt;/_&gt;
+          &lt;_&gt;pear&lt;/_&gt;
+        &lt;/three&gt;
+        &lt;two&gt;2.0&lt;/two&gt;
+        &lt;one&gt;1&lt;/one&gt;
+        &lt;four&gt;
+          &lt;bb&gt;22&lt;/bb&gt;
+          &lt;aa&gt;11&lt;/aa&gt;
+        &lt;/four&gt;
+      &lt;/root&gt;
+
+  json = YAXML.yaxml2json &quot;test.xml&quot;
+  puts json.inspect
+  #-&gt; {&quot;one&quot; =&gt; 1, &quot;two&quot; =&gt; 2.0, &quot;three&quot; =&gt; [ &quot;apple&quot;, &quot;pear&quot;], &quot;four&quot; =&gt; {&quot;aa&quot; =&gt; 11, &quot;bb&quot; =&gt; 22}}
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000004-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/yaxml.rb, line 289</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaxml2json</span>( <span class="ruby-identifier">source</span> )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">source</span>
+
+    <span class="ruby-identifier">xml_node</span> = <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">String</span>
+                 <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span><span class="ruby-identifier">source</span>
+                   <span class="ruby-identifier">yaxml_string</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-identifier">source</span>, <span class="ruby-value str">&quot;r&quot;</span> ).<span class="ruby-identifier">read</span>
+                 <span class="ruby-keyword kw">else</span>
+                   <span class="ruby-identifier">yaxml_string</span> = <span class="ruby-identifier">source</span>
+                 <span class="ruby-keyword kw">end</span>        
+                 <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Document</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">yaxml_string</span>
+
+               <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Element</span>
+                 <span class="ruby-identifier">source</span>.<span class="ruby-identifier">elements</span>[<span class="ruby-value">1</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">elements</span>[<span class="ruby-value">1</span>]
+                 
+               <span class="ruby-keyword kw">else</span>
+                 <span class="ruby-keyword kw">nil</span>
+               <span class="ruby-keyword kw">end</span>
+     
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaxmlnode2json</span> <span class="ruby-identifier">xml_node</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000003" class="method-detail">
+        <a name="M000003"></a>
+
+        <div class="method-heading">
+          <a href="#M000003" class="method-signature">
+          <span class="method-name">yaxml2yaml</span><span class="method-args">( source )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Conversion <a href="YAXML.html">YAXML</a> -&gt; YAML
+</p>
+<table>
+<tr><td valign="top">source:</td><td>It can be a <a href="YAXML.html">YAXML</a> file in a String or a file name.
+
+</td></tr>
+</table>
+<p>
+Example of use:
+</p>
+<pre>
+  test.xml content
+      &lt;root xmlns:yaml='http://yaml.org/xml'&gt;
+        &lt;three&gt;
+          &lt;_&gt;apple&lt;/_&gt;
+          &lt;_&gt;pear&lt;/_&gt;
+        &lt;/three&gt;
+        &lt;two&gt;2.0&lt;/two&gt;
+        &lt;one&gt;1&lt;/one&gt;
+        &lt;four&gt;
+          &lt;bb&gt;22&lt;/bb&gt;
+          &lt;aa&gt;11&lt;/aa&gt;
+        &lt;/four&gt;
+      &lt;/root&gt;
+
+  yaml = YAXML.yaxml2yaml &quot;test.xml&quot;
+  puts yaml
+  #-&gt; one: 1
+      two: 2.0
+      three:
+        - apple
+        - pear
+      four:
+        aa: 11
+        bb: 22
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000003-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/yaxml.rb, line 262</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaxml2yaml</span>( <span class="ruby-identifier">source</span> )
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaxml2json</span>( <span class="ruby-identifier">source</span> ).<span class="ruby-identifier">to_yaml</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>