<pclass="module-desc"><p>This is the parent module of NimYAML, a package that provides facilities to generate and interpret <aclass="reference external"href="http://yaml.org">YAML</a> character streams. Importing this package will import everything from all subpackages.</p>
<p>There are three high-level APIs which are probably most useful:</p>
<ulclass="simple"><li>The serialization API in <aclass="reference external"href="yaml.serialization.html">serialization</a> enables you to load YAML data directly into native Nim types, and reversely dump native Nim types as YAML.</li>
<li>The DOM API in <aclass="reference external"href="yaml.dom.html">dom</a> parses YAML files in a tree structure which you can navigate.</li>
<li>The JSON API in <aclass="reference external"href="yaml.tojson.html">tojson</a> parses YAML files into the Nim stdlib's JSON structure, which may be useful if you have other modules which expect JSON input. Note that the serialization API is able to write and load JSON; you do not need the JSON API for that.</li>
</ul>
<p>Apart from those high-level APIs, NimYAML implements a low-level API which enables you to process YAML input as data stream which does not need to be loaded into RAM completely at once. It consists of the following modules:</p>
<ulclass="simple"><li>The stream API in <aclass="reference external"href="yaml.stream.html">stream</a> defines the central type for stream processing, <ttclass="docutils literal"><spanclass="pre">YamlStream</span></tt>. It also contains definitions and constructor procs for stream events.</li>
<li>The parser API in <aclass="reference external"href="yaml.parser.html">parser</a> gives you direct access to the YAML parser's output.</li>
<li>The presenter API in <aclass="reference external"href="yaml/presenter.html">presenter</a> gives you direct access to the presenter, i.e. the module that renders a YAML character stream.</li>
<li>The taglib API in <aclass="reference external"href="yaml.taglib.html">taglib</a> provides a data structure for keeping track of YAML tags that are generated by the parser or used in the presenter.</li>
<li>The hints API in <aclass="reference external"href="yaml.hints.html">hints</a> provides a simple proc for guessing the type of a scalar value.</li>