yajl 0.1.1

YAJL, Yet Another JSON library, binding for D.


To use this package, run the following command in your project's root directory:

YAJL binding for D

yajl-d is a YAJL binding for D.

yajl-d is based on YAJL2 and tested with YAJL 2.0.5.

Install

Run make for generating libyajld.a

make

run example

Need to link yajl library

dmd -Isrc libyajl-d.a -L-L/path/to/libdir -L-lyajl -run example/encode_bench.d

Usage

Encode

  • yajl.encode(value) / yajl.encode(value, opt)

import yajl;

struct Hoge
{ 
    ulong id;
    string word;
    bool yes; 
}

// {"id":100,"word":"hey!","yes":true}
string json = encode(Hoge(100, "hey!", true));

Decode

  • yajl.decode(value) / yajl.decode(value, opt)

import yajl;

Hoge hoge = decode!Hoge(`{"id":100,"word":"hey!","yes":true}`);
  • yajl.decoder.Decoder

Use decode and decodedValue methods.

import yajl.decoder;

Decoder decoder;
if (decoder.decode(`{"id":100,"word":"hey!","yes":true}`) {
    Hoge hoge = decoder.decodedValue!Hoge;
    // ...
}

Decoder#decode is a straming decoder, so you can pass the insufficient json to this method. If Decoder#decode can't parse completely, Decoder#decode returns false.

Encoder.Option and Decoder.Option

encode and decode can take each Option argument. If you want to know more details, see unittest of yajl.encoder / yajl.decoder.

Using a D keyword in JSON field names

Since a field name cannot be a D keyword, for example body or out, the variable and JSON field must have separate names. For this, use the @JSONName("name") attribute:

import yajl;

struct Hoge
{ 
    ulong id;
    @JSONName("body") string _body;
    bool yes; 
}

// {"id":100,"body":"hey!","yes":true}
string json = encode(Hoge(100, "hey!", true));

Perfomance comparison

D: dmd 2.065.0 OS: Mac OS X ver 10.9<br /> CPU: 2.6 GHz Intel Core i7<br />

<table> <tr>

<th></th><th>encode(QPS)</th><th>decode(QPS)</th><th>streaming decode(QPS)</th>

</tr> <tr>

<td>std.json</td><td>221455</td><td>197332</td><td>Not supported</td>

</tr> <tr>

<td>yajl-d</td><td>706175</td><td>530527</td><td>810994</td>

</tr> </table>

Benchmark code can be found in the example directory.

TODO

  • Limited direct conversion decoding
  • Test on Windows

YAJL official site

Github repository

<table> <tr>

<td>Author</td><td>Masahiro Nakagawa <repeatedly@gmail.com></td>

</tr> <tr>

<td>Copyright</td><td>Copyright (c) 2013- Masahiro Nakagawa</td>

</tr> <tr>

<td>License</td><td>Boost Software License, Version 1.0</td>

</tr> </table>

Authors:
  • Masahiro Nakagawa
Dependencies:
none
Versions:
0.2.0 2014-Oct-04
0.1.2 2014-Oct-02
0.1.1 2014-Sep-28
0.1.0 2014-Sep-22
~master 2014-Oct-04
Show all 5 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 3 downloads this month

  • 331 downloads total

Score:
1.1
Short URL:
yajl.dub.pm