Problems?

If you find a bug, post an issue! If you have questions about how to use yaml-cpp, please post it on http://stackoverflow.com and tag it yaml-cpp.

Recent Release

yaml-cpp 0.3.0 has been released! This is a collection of minor bug fixing releases.

Experimental API!

I'm trying out a new API! The idea, as they say, is to make the easy things easier and the impossible things possible. Read the Tutorial for how to use the new API, and please help me iron out the kinks!

To build the new API, check out the latest version from the hg repository update to the new-api branch:

hg up new-api

How to Build

yaml-cpp uses CMake to support cross-platform building. The basic steps to build are:

1. Download and install CMake (Resources -> Download).

Note: If you don't use the provided installer for your platform, make sure that you add CMake's bin folder to your path.

2. Navigate into the source directory, and type:

mkdir build
cd build

3. Run CMake. The basic syntax is:

cmake [-G generator] [-DBUILD_SHARED_LIBS=ON|OFF] ..

The generator is whatever type of build system you'd like to use. To see a full list of generators on your platform, just run cmake (with no arguments). For example:

On Windows, you might use "Visual Studio 9 2008" to generate a Visual Studio 2008 solution
On OS X, you might use "Xcode" to generate an Xcode project
On a UNIX-y system, simply omit the option to generate a makefile

yaml-cpp defaults to building a static library, but you may build a shared library by specifying -DBUILD_SHARED_LIBS=ON.

For more options on customizing the build, see the CMakeLists.txt file.

4. Build it!

5. To clean up, just remove the build directory.