[ViewVC] Diff of: cvs/JSON-XS/README

Comparing JSON-XS/README (file contents):
Revision 1.29 by root, Thu Feb 19 01:13:46 2009 UTC vs.
Revision 1.34 by root, Thu Mar 11 17:36:09 2010 UTC

      $perl_scalar = $coder->decode ($unicode_json_text);
      # Note that JSON version 2.0 and above will automatically use JSON::XS
      # if available, at virtually no speed overhead either, so you should
      # be able to just:
- use JSON;
+     use JSON;
      # and do the same things, except that you have a pure-perl fallback now.
 DESCRIPTION
     This module converts Perl data structures to JSON and vice versa. Its
         it is disabled, the same hash might be encoded differently even if
         contains the same data, as key-value pairs have no inherent ordering
         in Perl.
         This setting has no effect when decoding JSON texts.
+        This setting has currently no effect on tied hashes.
     $json = $json->allow_nonref ([$enable])
     $enabled = $json->get_allow_nonref
         If $enable is true (or missing), then the "encode" method can
         convert a non-reference into its corresponding string, number or
        my $yaml = $to_yaml->encode ($ref) . "\n";
     This will *usually* generate JSON texts that also parse as valid YAML.
     Please note that YAML has hardcoded limits on (simple) object key
     lengths that JSON doesn't have and also has different and incompatible
-    unicode handling, so you should make sure that your hash keys are
+    unicode character escape syntax, so you should make sure that your hash
-    noticeably shorter than the 1024 "stream characters" YAML allows and
+    keys are noticeably shorter than the 1024 "stream characters" YAML
-    that you do not have characters with codepoint values outside the
+    allows and that you do not have characters with codepoint values outside
-    Unicode BMP (basic multilingual page). YAML also does not allow "\/"
+    the Unicode BMP (basic multilingual page). YAML also does not allow "\/"
     sequences in strings (which JSON::XS does not *currently* generate, but
     other JSON generators might).
     There might be other incompatibilities that I am not aware of (or the
     YAML specification has been changed yet again - it does so quite often).
         (which is not that difficult or long) and finally make YAML
         compatible to it, and educating users about the changes, instead of
         spreading lies about the real compatibility for many *years* and
         trying to silence people who point out that it isn't true.
+        Addendum/2009: the YAML 1.2 spec is still incomaptible with JSON,
+        even though the incompatibilities have been documented (and are
+        known to Brian) for many years and the spec makes explicit claims
+        that YAML is a superset of JSON. It would be so easy to fix, but
+        apparently, bullying and corrupting userdata is so much easier.
   SPEED
     It seems that JSON::XS is surprisingly fast, as shown in the following
     tables. They have been generated with the help of the "eg/bench" program
     in the JSON::XS distribution, to make it easy to compare on your own
     system.
     single-line JSON string (also available at
     <http://dist.schmorp.de/misc/json/short.json>).
        {"method": "handleMessage", "params": ["user1",
        "we were just talking"], "id": null, "array":[1,11,234,-5,1e5,1e7,
-       true,  false]}
+       1,  0]}
     It shows the number of encodes/decodes per second (JSON::XS uses the
     functional interface, while JSON::XS/2 uses the OO interface with
-    pretty-printing and hashkey sorting enabled, JSON::XS/3 enables shrink).
+    pretty-printing and hashkey sorting enabled, JSON::XS/3 enables shrink.
-    Higher is better:
+    JSON::DWIW/DS uses the deserialise function, while JSON::DWIW::FJ uses
+    the from_json method). Higher is better:
-       module     |     encode |     decode |
+       module        |     encode |     decode |
-       -----------|------------|------------|
+       --------------|------------|------------|
-       JSON 1.x   |   4990.842 |   4088.813 |
+       JSON::DWIW/DS |  86302.551 | 102300.098 |
-       JSON::DWIW |  51653.990 |  71575.154 |
+       JSON::DWIW/FJ |  86302.551 |  75983.768 |
-       JSON::PC   |  65948.176 |  74631.744 |
+       JSON::PP      |  15827.562 |   6638.658 |
-       JSON::PP   |   8931.652 |   3817.168 |
+       JSON::Syck    |  63358.066 |  47662.545 |
-       JSON::Syck |  24877.248 |  27776.848 |
+       JSON::XS      | 511500.488 | 511500.488 |
-       JSON::XS   | 388361.481 | 227951.304 |
+       JSON::XS/2    | 291271.111 | 388361.481 |
-       JSON::XS/2 | 227951.304 | 218453.333 |
+       JSON::XS/3    | 361577.931 | 361577.931 |
-       JSON::XS/3 | 338250.323 | 218453.333 |
+       Storable      |  66788.280 | 265462.278 |
-       Storable   |  16500.016 | 135300.129 |
-       -----------+------------+------------+
+       --------------+------------+------------+
-    That is, JSON::XS is about five times faster than JSON::DWIW on
+    That is, JSON::XS is almost six times faster than JSON::DWIW on
-    encoding, about three times faster on decoding, and over forty times
+    encoding, about five times faster on decoding, and over thirty to
-    faster than JSON, even with pretty-printing and key sorting. It also
+    seventy times faster than JSON's pure perl implementation. It also
     compares favourably to Storable for small amounts of data.
     Using a longer test string (roughly 18KB, generated from Yahoo! Locals
     search API (<http://dist.schmorp.de/misc/json/long.json>).
-       module     |     encode |     decode |
+       module        |     encode |     decode |
-       -----------|------------|------------|
+       --------------|------------|------------|
-       JSON 1.x   |     55.260 |     34.971 |
+       JSON::DWIW/DS |   1647.927 |   2673.916 |
-       JSON::DWIW |    825.228 |   1082.513 |
+       JSON::DWIW/FJ |   1630.249 |   2596.128 |
-       JSON::PC   |   3571.444 |   2394.829 |
-       JSON::PP   |    210.987 |     32.574 |
+       JSON::PP      |    400.640 |     62.311 |
-       JSON::Syck |    552.551 |    787.544 |
+       JSON::Syck    |   1481.040 |   1524.869 |
-       JSON::XS   |   5780.463 |   4854.519 |
+       JSON::XS      |  20661.596 |   9541.183 |
-       JSON::XS/2 |   3869.998 |   4798.975 |
+       JSON::XS/2    |  10683.403 |   9416.938 |
-       JSON::XS/3 |   5862.880 |   4798.975 |
+       JSON::XS/3    |  20661.596 |   9400.054 |
-       Storable   |   4445.002 |   5235.027 |
+       Storable      |  19765.806 |  10000.725 |
-       -----------+------------+------------+
+       --------------+------------+------------+
     Again, JSON::XS leads by far (except for Storable which non-surprisingly
-    decodes faster).
+    decodes a bit faster).
     On large strings containing lots of high Unicode characters, some
     modules (such as JSON::PC) seem to decode faster than JSON::XS, but the
     result will be broken due to missing (or wrong) Unicode handling. Others
     refuse to decode or encode properly, so it was impossible to prepare a
     information you might want to make sure that exceptions thrown by
     JSON::XS will not end up in front of untrusted eyes.
     If you are using JSON::XS to return packets to consumption by JavaScript
     scripts in a browser you should have a look at
-    <http://jpsykes.com/47/practical-csrf-and-json-security> to see whether
+    <http://blog.archive.jpsykes.com/47/practical-csrf-and-json-security/>
-    you are vulnerable to some common attack vectors (which really are
+    to see whether you are vulnerable to some common attack vectors (which
-    browser design bugs, but it is still you who will have to deal with it,
+    really are browser design bugs, but it is still you who will have to
-    as major browser developers care only for features, not about getting
+    deal with it, as major browser developers care only for features, not
-    security right).
+    about getting security right).
 THREADS
     This module is *not* guaranteed to be thread safe and there are no plans
     to change this until Perl gets thread support (as opposed to the
     horribly slow so-called "threads" which are simply slow and bloated

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing JSON-XS/README (file contents): Revision 1.29 by root, Thu Feb 19 01:13:46 2009 UTC vs. Revision 1.34 by root, Thu Mar 11 17:36:09 2010 UTC

Diff Legend

Comparing JSON-XS/README (file contents):
Revision 1.29 by root, Thu Feb 19 01:13:46 2009 UTC vs.
Revision 1.34 by root, Thu Mar 11 17:36:09 2010 UTC