Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

libyaml

stephank3050.2.5

Bindings to libYAML

readme

YAML.node Build Status

A simple binding for LibYAML.

Installing

$ npm install libyaml

Usage

var YAML = require('libyaml');

There's a basic JSON-like API:

var documents = YAML.parse('Hello world!');
var data = YAML.stringify({ fancy: ['object', 'structure'] });

And also a fs-like API:

YAML.readFile('myfile.yml', function(error, documents) {
  /* ... */
});

var doc1 = { first: 'document' };
var doc2 = { another: 'doc' };
YAML.writeFile('myfile.yml', doc1, doc2, function(error) {
  /* ... */
});

Including synchronous variants:

var documents = YAML.readFileSync('myfile.yml');
YAML.writeFileSync('myfile.yml', doc1, doc2);

Hacking the code

git clone https://github.com/stephank/yaml.node.git
cd yaml.node
npm install
npm test

Upgrading from pre-0.1.0

As of 0.1.0, the API immitates the JavaScript built-in JSON parser for string handling, and the Node.js built-in fs-module for file I/O. Function names have changed as follows:

YAML.loadYAML.parse
YAML.dumpYAML.stringify

YAML.loadFileYAML.readFile
YAML.dumpFileYAML.writeFile

YAML.loadFileSyncYAML.readFileSync
YAML.dumpFileSyncYAML.writeFileSync

YAML.parseYAML.stream.parse