Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby json parser that pretty much fails to be over-engineered
branch: master

Merge pull request #22 from vszakats/patch-1

updated broken URLs in comment
latest commit 07d1ac0c50
Erik Michaels-Ober sferik authored
Failed to load latest commit information.
t Fix exponents with leading zeros
.gitignore generate multi-byte UTF-8; closes #4
Readme fix encoding in ruby >= 1.9
okjson.rb properly allow ok commits in pre-commit
rubies fix example test command from the readme
test say what went wrong
tested-on correctly encode control chars; fixes #16


This is a json parser, written in ruby.
It has no dependencies other than ruby.
See the file tested-on for a complete list
of ruby interpreters used for testing.

To Use:

  OkJson.encode({"abc" => [123, -456.789]})
  => "{\"abc\":[123,-456.789]}"

  => {"abc"=>[123, -456.789]}

That's it.

This library is intended to be "vendored".
It is not a gem; instead, copy okjson.rb
into your project and "require" it directly.
This method helps you avoid an external
dependency. It's only about 575 lines of
source; about half of that is UTF-8 coding.
If you bundle okjson with your library,
please change the module's name to something
like MyLib::OkJson, to avoid conflicts with
other libraries.

OkJson is not particularly fast or flexible,
but it is designed to be simple and portable.
It should suffice for most needs.

It provides two guarantees:
 1. okjson will never generate invalid json
 2. OkJson.decode(OkJson.encode(x)) == x

Note for people who've used other ruby json
libraries: json does not represent symbols,
so okjson does not encode them. It won't
convert them to strings; that would silently
corrupt your data. The same holds for all of
ruby's other data types that don't exist in
json, including Range, Regexp, Proc, Time,
and user-defined classes.

Patches to increase the correctness,
readability, or portability of the
source code will be gratefully accepted.
Other patches (for example, extra features
or optional behavior) likely won't.

To Test:

  $ ./rubies ruby rbx /opt/ruby192/bin/ruby

(Note: these tests originated at
but have been changed to follow
RFC 4627 and revised substantially.)
Something went wrong with that request. Please try again.